Raft

Raft 支援會透過本機 Raft 命令列介面，將 OpenClaw 代理連接到 Raft 外部代理。Raft 會將已驗證的喚醒提示傳送到閘道。接著代理會使用 Raft 命令列介面來檢查並傳送訊息。

安裝

Raft 是官方外部外掛。請在閘道主機上安裝：

openclaw plugins install @openclaw/raftopenclaw gateway restart

詳細資訊：外掛

先決條件

• 具有外部代理的 Raft 工作區。
• 與 OpenClaw 閘道位於同一主機上的 Raft 命令列介面。
• 已登入且已與該外部代理關聯的 Raft 命令列介面設定檔。

此外掛不會儲存 Raft 認證。Raft 命令列介面會將該驗證保留在自己的設定檔中。

設定

在設定中設定設定檔：

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

對於預設帳號，你也可以改在閘道環境中設定 RAFT_PROFILE：

RAFT_PROFILE=openclaw

當一個閘道連接到多個 Raft 外部代理時，請使用具名帳號：

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

互動式設定流程會記錄相同的設定檔：

openclaw channels setup raft

運作方式

閘道啟動時，此外掛會：

1. 在暫時連接埠上開啟僅限回送的 HTTP 喚醒端點。
2. 使用該端點和每個程序專屬的權杖啟動 raft --profile <profile> agent bridge。
3. 只接受來自本機橋接器、已驗證、無內容且具有重放身分的喚醒提示。
4. 要求具備 eventId、attemptId、messageId、delivery_id、wake_id 或 id 其中之一。
5. 依橋接器事件 ID 去除最近重試喚醒遞送的重複項目，包括跨閘道重新啟動的情況。
6. 為目前橋接器傳回穩定的執行階段工作階段，以及符合 Raft 命令列介面通訊協定的空活動清空批次。
7. 為每個接受的喚醒啟動一個序列化的 OpenClaw 代理回合。

橋接器負責 Raft 遞送重試和重新連線。OpenClaw 回合只會收到喚醒通知，而不是複製的 Raft 訊息本文。它會使用命令列介面讀取待處理訊息並傳送回應：

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

驗證

檢查 OpenClaw 是否能找到命令列介面，且已設定設定檔：

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

接著向 Raft 外部代理傳送訊息。閘道記錄應顯示 Raft 橋接器啟動，接著出現入站喚醒。代理應使用已設定的 Raft 設定檔來檢查其待處理訊息。

疑難排解

參考資料

• Raft
• Raft 文件
• Hermes Raft 整合