ClawCN - OpenClaw 中文版

主题

网关拥有的配对(选项 B) ​

在网关拥有的配对中,网关是允许哪些节点加入的权威来源。UI(macOS 应用、未来的客户端)只是批准或拒绝待处理请求的前端。

重要提示: WS 节点在 connect 期间使用设备配对(角色 node)。 node.pair.* 是一个单独的配对存储,不会阻止 WS 握手。 只有显式调用 node.pair.* 的客户端才使用此流程。

概念 ​

  • 待处理请求:节点请求加入;需要批准。
  • 已配对节点:已批准的节点,带有已颁发的认证令牌。
  • 传输:网关 WS 端点转发请求,但不决定成员资格。(旧版 TCP 桥接支持已弃用/删除。)

配对工作原理 ​

  1. 节点连接到网关 WS 并请求配对。
  2. 网关存储一个待处理请求并发出 node.pair.requested。
  3. 您批准或拒绝请求(CLI 或 UI)。
  4. 批准后,网关颁发一个新令牌(令牌在重新配对时会轮换)。
  5. 节点使用令牌重新连接,现在已"配对"。

待处理请求在 5 分钟后自动过期。

CLI 工作流程(支持无界面) ​

bash
openclaw nodes pending
openclaw nodes approve <requestId>
openclaw nodes reject <requestId>
openclaw nodes status
openclaw nodes rename --node <id|name|ip> --name "Living Room iPad"

nodes status 显示已配对/已连接的节点及其功能。

API 接口(网关协议) ​

事件:

  • node.pair.requested — 创建新的待处理请求时发出。
  • node.pair.resolved — 请求被批准/拒绝/过期时发出。

方法:

  • node.pair.request — 创建或重用待处理请求。
  • node.pair.list — 列出待处理 + 已配对的节点。
  • node.pair.approve — 批准待处理请求(颁发令牌)。
  • node.pair.reject — 拒绝待处理请求。
  • node.pair.verify — 验证 { nodeId, token }。

注意:

  • node.pair.request 对每个节点是幂等的:重复调用返回相同的待处理请求。
  • 批准始终生成新令牌;node.pair.request 永远不会返回任何令牌。
  • 请求可能包含 silent: true 作为自动批准流程的提示。

自动批准(macOS 应用) ​

macOS 应用可以在以下情况下选择性地尝试静默批准:

  • 请求被标记为 silent,并且
  • 应用可以使用相同用户验证到网关主机的 SSH 连接。

如果静默批准失败,它会回退到正常的"批准/拒绝"提示。

存储(本地、私有) ​

配对状态存储在网关状态目录下(默认 ~/.openclaw):

  • ~/.openclaw/nodes/paired.json
  • ~/.openclaw/nodes/pending.json

如果您覆盖 OPENCLAW_STATE_DIR,nodes/ 文件夹会随之移动。

安全注意事项:

  • 令牌是秘密;将 paired.json 视为敏感信息。
  • 轮换令牌需要重新批准(或删除节点条目)。

传输行为 ​

  • 传输是无状态的;它不存储成员资格。
  • 如果网关离线或配对被禁用,节点无法配对。
  • 如果网关处于远程模式,配对仍然针对远程网关的存储进行。