OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Developer and self-hosted

Raft

Raft は、ローカルの Raft CLI を介して OpenClaw エージェントを Raft External Agent に接続します。Raft は認証済みのウェイク通知を Gateway に送信します。その後、エージェントは Raft CLI を使用してメッセージを確認し、送信します。ダイレクトチャットのみに対応します（グループには対応しません）。

インストール

Raft は公式の外部 Plugin です。Gateway ホストにインストールします。

bash
openclaw plugins install @openclaw/raftopenclaw gateway restart

詳細：Plugin

前提条件

  • External Agent を含む Raft ワークスペース。
  • OpenClaw Gateway と同じホストに Raft CLI がインストールされ、サービスの PATH に含まれていること。
  • すでにサインイン済みで、その External Agent に関連付けられている Raft CLI プロファイル。

Plugin は Raft の認証情報を保存しません。Raft CLI がその認証情報を自身のプロファイルに保持します。

設定

設定でプロファイルを指定します。

json5
{  channels: {    raft: {      enabled: true,      profile: "openclaw",    },  },}

デフォルトアカウントでは、代わりに Gateway 環境で RAFT_PROFILE を設定できます。

bash
RAFT_PROFILE=openclaw

1 つの Gateway を複数の Raft External Agent に接続する場合は、名前付きアカウントを使用します。

json5
{  channels: {    raft: {      accounts: {        support: {          profile: "support-agent",        },        engineering: {          profile: "engineering-agent",        },      },    },  },}

対話型セットアップでも同じプロファイルが記録されます。

bash
openclaw channels add --channel raft

動作の仕組み

Gateway が起動すると、Plugin は次の処理を行います。

  1. 一時ポート上にループバック専用の HTTP ウェイクエンドポイントを開きます。
  2. そのエンドポイントとプロセスごとのトークンを指定して、raft --profile <profile> agent bridge を起動します。
  3. ローカルブリッジから送信された、リプレイ識別子を持つ認証済みかつコンテンツを含まないウェイク通知のみを受け入れます。
  4. すべてのウェイクペイロードに eventId、attemptId、messageId、delivery_id、wake_id、または id のいずれかが含まれていることを必須とします。
  5. 再試行されたウェイク配信をブリッジイベント ID に基づいて 24 時間重複排除します。この状態は Gateway の再起動後も維持されます。
  6. 現在のブリッジに対して安定したランタイムセッションを返し、Raft CLI プロトコルに対して空のアクティビティドレインバッチを返します。
  7. 受け入れたウェイクごとに、直列化された OpenClaw エージェントターンを 1 回開始します。

ブリッジが Raft の配信再試行と再接続を管理します。OpenClaw のターンが受け取るのはウェイク通知のみであり、コピーされた Raft メッセージ本文ではありません。保留中のメッセージの読み取りと応答の送信には CLI を使用します。

bash
raft --profile openclaw message checkraft --profile openclaw message send

確認

OpenClaw が CLI を検出でき、プロファイルが設定されていることを確認します。

bash
openclaw channels status --probeopenclaw plugins inspect raft --runtime --json

次に、Raft External Agent にメッセージを送信します。Gateway ログには Raft ブリッジの起動が表示され、その後に受信ウェイクが表示されます。エージェントは設定された Raft プロファイルを使用して、保留中のメッセージを確認します。

トラブルシューティング

Raft CLI が見つからない

Gateway ホストに Raft CLI をインストールし、サービスの PATH から raft を利用できるようにします。raft --help で確認してから、Gateway を再起動します。

ブリッジがすぐに終了する

設定されたプロファイルがサインイン済みであり、対象の Raft External Agent に属していることを確認します。CLI の診断情報を確認するには、raft --profile <profile> agent bridge を直接実行します。

ウェイクを受信しても Raft の応答が送信されない

エージェントが Raft CLI を呼び出さない場合、これは想定された動作です。ウェイクブリッジはメッセージ本文や自動的な最終応答を伝送しません。エージェントのツールポリシーを確認し、raft --profile <profile> message check と message send を実行できるようにしてください。

参考資料

Was this useful?
On this page

On this page