Raft

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

インストール

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

openclaw plugins install @openclaw/raftopenclaw 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 checkraft --profile openclaw message send

検証

OpenClaw が CLI を見つけられ、設定済みプロファイルを持っていることを確認します。

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

次に、Raft 外部エージェントにメッセージを送信します。Gateway ログには Raft ブリッジの起動に続いて、受信ウェイクが表示されるはずです。エージェントは設定済みの Raft プロファイルを使って保留中のメッセージを確認する必要があります。

トラブルシューティング

参考資料

• Raft
• Raft ドキュメント
• Hermes Raft 統合