メインコンテンツへスキップ
Raft サポートは、OpenClaw エージェントをローカルの Raft CLI 経由で Raft 外部エージェントに接続します。Raft は認証済みのウェイクヒントを Gateway に送信します。その後、エージェントは Raft CLI を使ってメッセージを確認し、送信します。

​
インストール

Raft は公式の外部Pluginです。Gateway ホストにインストールします。 
openclaw plugins install @openclaw/raft
openclaw gateway restart
詳細: Plugin

​
前提条件

  • 外部エージェントを持つ Raft ワークスペース。
  • OpenClaw Gateway と同じホストにインストールされた Raft CLI。
  • すでにサインイン済みで、その外部エージェントに関連付けられている Raft CLI プロファイル。
このPluginは Raft 認証情報を保存しません。Raft CLI はその認証を 自身のプロファイル内に保持します。

​
設定

設定でプロファイルを指定します。 
{
  channels: {
    raft: {
      enabled: true,
      profile: "openclaw",
    },
  },
}
デフォルトアカウントの場合は、代わりに Gateway 環境で RAFT_PROFILE を設定できます。 
RAFT_PROFILE=openclaw
1つの Gateway が複数の Raft 外部エージェントに接続する場合は、名前付きアカウントを使用します。 
{
  channels: {
    raft: {
      accounts: {
        support: {
          profile: "support-agent",
        },
        engineering: {
          profile: "engineering-agent",
        },
      },
    },
  },
}
対話型セットアップフローも同じプロファイルを記録します。 
openclaw channels setup raft

​
動作の仕組み

Gateway が起動すると、Plugin は次を実行します。
  1. エフェメラルポートでループバック専用の HTTP ウェイクエンドポイントを開きます。
  2. そのエンドポイントとプロセスごとのトークンを指定して、raft --profile <profile> agent bridge を起動します。
  3. ローカルブリッジからの、リプレイ識別子を持つ認証済みかつコンテンツを含まないウェイクヒントのみを受け入れます。
  4. eventId、attemptId、messageId、delivery_id、wake_id、または id のいずれかを必須にします。
  5. Gateway の再起動をまたいで、ブリッジイベント ID により最近再試行されたウェイク配信を重複排除します。
  6. 現在のブリッジに対して安定したランタイムセッションと、Raft CLI プロトコル用の空のアクティビティドレインバッチを返します。
  7. 受け入れた各ウェイクに対して、直列化された OpenClaw エージェントターンを1つ開始します。
ブリッジは Raft 配信の再試行と再接続を所有します。OpenClaw ターンが受け取るのは ウェイク通知だけであり、コピーされた Raft メッセージ本文ではありません。保留中のメッセージを読むため、また応答を送信するために CLI を使用します。 
raft --profile openclaw message check
raft --profile openclaw message send
Raft は通常のプッシュメッセージトランスポートではありません。OpenClaw はモデルの最終テキストをブリッジ経由で自動的に送り返さないため、エージェントはウェイク処理後に Raft CLI を使用する必要があります。

​
検証

OpenClaw が CLI を見つけられ、設定済みプロファイルを持っていることを確認します。 
openclaw channels status --probe
openclaw plugins inspect raft --runtime --json
次に、Raft 外部エージェントにメッセージを送信します。Gateway ログには Raft ブリッジの起動に続いて、受信ウェイクが表示されるはずです。エージェントは設定済みの Raft プロファイルを使って保留中のメッセージを確認する必要があります。

​
トラブルシューティング

Gateway ホストに Raft CLI をインストールし、サービスの PATH で raft を利用できるようにします。raft --help で確認してから、Gateway を再起動します。
設定済みプロファイルがサインイン済みで、意図した Raft 外部エージェントに属していることを確認します。CLI の診断を確認するには、raft --profile <profile> agent bridge を直接実行します。
エージェントが Raft CLI を呼び出していない場合、これは想定どおりです。ウェイクブリッジはメッセージ本文や自動の最終返信を運びません。エージェントのツールポリシーを確認し、raft --profile <profile> message check と message send を実行できることを確認します。

​
参考資料