Raft

Raft 支持通过本地 Raft CLI 将 OpenClaw 智能体连接到 Raft 外部智能体。Raft 会向 Gateway 网关发送经过身份验证的唤醒提示。然后，智能体使用 Raft CLI 检查并发送消息。

安装

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

openclaw plugins install @openclaw/raftopenclaw gateway restart

详情：插件

前提条件

• 一个带有外部智能体的 Raft 工作区。
• Raft CLI 已安装在与 OpenClaw Gateway 网关相同的主机上。
• 一个已登录并关联到该外部智能体的 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 setup raft

工作原理

Gateway 网关启动时，插件会：

1. 在临时端口上打开一个仅限 loopback 的 HTTP 唤醒端点。
2. 使用该端点和每进程令牌启动 raft --profile <profile> agent bridge。
3. 只接受来自本地桥接器、经过身份验证、不含内容且带有重放标识的唤醒提示。
4. 要求包含 eventId、attemptId、messageId、delivery_id、wake_id 或 id 之一。
5. 按桥接器事件 ID 对近期重试的唤醒投递进行去重，包括跨 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 集成