Raft

Raft 通过本地 Raft CLI 将 OpenClaw 智能体连接到 Raft 外部智能体。Raft 向 Gateway 网关发送经过身份验证的唤醒提示；随后，智能体使用 Raft CLI 检查和发送消息。仅支持直接聊天（不支持群组）。

安装

Raft 是官方外部插件。请在 Gateway 网关主机上安装：

openclaw plugins install @openclaw/raftopenclaw gateway restart

详情：插件

前置条件

• 拥有包含外部智能体的 Raft 工作区。
• Raft CLI 已安装在 OpenClaw Gateway 网关所在的同一主机上，并且位于服务的 PATH 中。
• 已登录且已与该外部智能体关联的 Raft CLI 配置文件。

该插件不会存储 Raft 凭据；Raft CLI 会在自己的配置文件中保存身份验证信息。

配置

在配置中设置配置文件：

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

对于默认账户，你也可以在 Gateway 网关环境中设置 RAFT_PROFILE：

RAFT_PROFILE=openclaw

当一个 Gateway 网关连接到多个 Raft 外部智能体时，请使用命名账户：

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

交互式设置会记录相同的配置文件：

openclaw channels add --channel raft

工作原理

Gateway 网关启动时，该插件会：

1. 在临时端口上打开一个仅限 local loopback 的 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 智能体轮次。

桥接器负责 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 集成