RPC 适配器
OpenClaw 通过 JSON-RPC 集成外部 CLI。目前使用两种模式。
模式 A:HTTP 守护进程 (signal-cli)
Section titled “模式 A:HTTP 守护进程 (signal-cli)”signal-cli作为通过 HTTP 使用 JSON-RPC 的守护进程运行。- 事件流是 SSE (
/api/v1/events)。 - 健康探测:
/api/v1/check。 - 当
channels.signal.autoStart=true时,OpenClaw 拥有生命周期。
有关设置和端点,请参阅 Signal。
模式 B:stdio 子进程
Section titled “模式 B:stdio 子进程”- OpenClaw 将 OpenClaw
imsg rpciMessage 作为子进程生成,用于 iMessage。 - JSON-RPC 通过 stdin/stdout 进行行分隔(每行一个 JSON 对象)。
- 不需要 TCP 端口,不需要守护进程。
使用的核心方法:
watch.subscribe→ 通知 (method: "message")watch.unsubscribesendchats.list(探针/诊断)
有关旧版设置和寻址,请参阅 iMessage(首选 chat_id)。
- Gateway(网关) 拥有该进程(启动/停止与提供商生命周期绑定)。
- 保持 RPC 客户端弹性:设置超时,退出时重启。
- 优先使用稳定的 ID(例如
chat_id),而不是显示字符串。