跳轉到主要內容
Raft 透過本機 Raft 命令列介面，將 OpenClaw 代理連接到 Raft External Agent。Raft 會將已驗證的喚醒提示傳送到閘道；代理接著使用 Raft 命令列介面檢查並傳送訊息。僅支援直接聊天（不支援群組）。

​
安裝

Raft 是官方外部外掛。請在閘道主機上安裝： 
openclaw plugins install @openclaw/raft
openclaw gateway restart
詳細資訊：外掛

​
先決條件

  • 具有 External Agent 的 Raft 工作區。
  • Raft 命令列介面已安裝在與 OpenClaw 閘道相同的主機上，且位於服務的 PATH。
  • 已登入且已與該 External Agent 關聯的 Raft 命令列介面設定檔。
此外掛不會儲存 Raft 憑證；Raft 命令列介面會將該驗證保留在自己的設定檔中。

​
設定

在設定中設定設定檔： 
{
  channels: {
    raft: {
      enabled: true,
      profile: "openclaw",
    },
  },
}
若為預設帳戶，你也可以改在閘道環境中設定 RAFT_PROFILE： 
RAFT_PROFILE=openclaw
當一個閘道連接到多個 Raft External Agent 時，請使用具名帳戶： 
{
  channels: {
    raft: {
      accounts: {
        support: {
          profile: "support-agent",
        },
        engineering: {
          profile: "engineering-agent",
        },
      },
    },
  },
}
互動式設定會記錄相同的設定檔： 
openclaw channels add --channel raft

​
運作方式

閘道啟動時，外掛會：
  1. 在臨時連接埠上開啟僅限 loopback 的 HTTP 喚醒端點。
  2. 使用該端點與每個程序專用的權杖啟動 raft --profile <profile> agent bridge。
  3. 只接受來自本機橋接器、已驗證且不含內容，並帶有重播身分的喚醒提示。
  4. 要求每個喚醒承載都必須包含 eventId、attemptId、messageId、delivery_id、wake_id 或 id 其中之一。
  5. 依橋接器事件 id 對重試的喚醒遞送進行 24 小時去重，包括跨閘道重新啟動。
  6. 為目前橋接器傳回穩定的執行階段工作階段，以及供 Raft 命令列介面協定使用的空活動清空批次。
  7. 為每個已接受的喚醒啟動一個序列化的 OpenClaw 代理回合。
橋接器負責 Raft 遞送重試與重新連線。OpenClaw 回合只會收到喚醒通知，而不是複製的 Raft 訊息本文。它會使用命令列介面讀取待處理訊息並傳送回應： 
raft --profile openclaw message check
raft --profile openclaw message send
Raft 不是推送訊息傳輸。OpenClaw 不會透過橋接器自動送回模型的最終文字，因此代理在處理喚醒後必須使用 Raft 命令列介面。

​
驗證

檢查 OpenClaw 是否能找到命令列介面並已設定設定檔： 
openclaw channels status --probe
openclaw plugins inspect raft --runtime --json
接著傳送訊息給 Raft External Agent。閘道記錄應顯示 Raft 橋接器啟動，隨後出現傳入喚醒。代理應使用已設定的 Raft 設定檔檢查其待處理訊息。

​
疑難排解

請在閘道主機上安裝 Raft 命令列介面，並讓服務的 PATH 可使用 raft。使用 raft --help 驗證，然後重新啟動閘道。
驗證已設定的設定檔已登入，且屬於預期的 Raft External Agent。直接執行 raft --profile <profile> agent bridge 以查看命令列介面診斷資訊。
當代理未叫用 Raft 命令列介面時，這是預期行為。喚醒橋接器不承載訊息本文或自動最終回覆。請檢查代理的工具政策，並確保它能執行 raft --profile <profile> message check 和 message send。

​
參考資料