本页内容

本页内容

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.unsubscribe
  • send
  • chats.list (check/diagnostics)

请参见 iMessage 了解设置和寻址方式(优先使用 chat_id,而不是显示字符串)。

适配器指南

  • Gateway 拥有该流程(start/stop 与提供程序生命周期相关)。
  • 让 RPC 客户端具备弹性:超时、退出后重启。
  • 优先选择稳定的 ID(e.g.、chat_id)而不是显示字符串。

相关内容

本页有帮助吗?