15.4 RPC适配器

参考与模板参考与模板

RPC 适配器

OpenClaw 通过 JSON-RPC 集成外部 CLI 工具。目前使用两种模式。

模式 A：HTTP 守护进程（signal-cli）

signal-cli 作为守护进程运行，通过 HTTP 提供 JSON-RPC 服务。

特点

  • JSON-RPC over HTTP
  • 事件流使用 SSE（/api/v1/events）
  • 健康探针：/api/v1/check
  • 当 channels.signal.autoStart=true 时，OpenClaw 管理生命周期

详细设置和端点信息请参阅 Signal 频道。

模式 B：stdio 子进程（imsg）

OpenClaw 将 imsg rpc 作为子进程启动。

特点

  • JSON-RPC 通过 stdin/stdout 的行分隔格式（每行一个 JSON 对象）
  • 无需 TCP 端口，无需守护进程

核心方法

  • watch.subscribe → 通知（方法："message"）
  • watch.unsubscribe
  • send
  • chats.list（探针/诊断）

详细设置和寻址信息（推荐使用 chat_id）请参阅 iMessage 频道。

适配器指南

在实现或使用 RPC 适配器时，请遵循以下原则：

生命周期管理

  • 网关拥有进程（启动/停止与提供商生命周期绑定）
  • 保持 RPC 客户端具有弹性：设置超时，在退出时重启

标识符使用

  • 优先使用稳定的 ID（例如 chat_id）而不是显示字符串
  • 确保标识符在重启后保持一致

文档索引

获取完整的文档索引，请访问：https://docs.openclaw.ai/llms.txt

使用此文件在进一步探索之前发现所有可用页面。