本页内容
本页内容
RPC 和 API
RPC 适配器
OpenClaw 通过 JSON-RPC 集成外部 CLI。今天使用两种模式。
模式 A:HTTP 守护进程(signal-cli)
signal-cli作为守护进程与 JSON-RPC 一起在 HTTP 上运行。- 事件流使用 SSE(
/api/v1/events)。 - 健康检查:
/api/v1/check。 - 当
channels.signal.transport.kind="managed-native"(默认值)时,OpenClaw 负责生命周期管理。
有关设置和端点,请参见 Signal。
模式 B:stdio 子进程(imsg)
- OpenClaw 为 iMessage 启动
imsg rpc作为子进程。 - JSON-RPC 通过 stdin/stdout 以按行分隔的方式传输(每行一个 JSON 对象)。
- 不需要 TCP 端口,也不需要守护进程。
使用的核心方法:
watch.subscribe→ 通知(method: "message")watch.unsubscribesendchats.list(check/diagnostics)
请参见 iMessage 了解设置和寻址方式(优先使用 chat_id,而不是显示字符串)。
适配器指南
- Gateway 拥有该流程(start/stop 与提供程序生命周期相关)。
- 让 RPC 客户端具备弹性:超时、退出后重启。
- 优先选择稳定的 ID(e.g.、
chat_id)而不是显示字符串。
相关内容
本页有帮助吗?