RPC 轉接器

OpenClaw 透過 JSON-RPC 整合外部 CLI。目前使用兩種模式。

模式 A:HTTP daemon(signal-cli)

  • signal-cli 以 daemon 方式運行,透過 HTTP 提供 JSON-RPC。
  • 事件串流為 SSE(/api/v1/events)。
  • 健康探測:/api/v1/check
  • channels.signal.autoStart=true 時 OpenClaw 管理其生命週期。

設定與端點參見 Signal

模式 B:stdio 子行程(舊版:imsg)

注意: 新的 iMessage 設定請改用 BlueBubbles

  • OpenClaw 將 imsg rpc 作為子行程啟動(舊版 iMessage 整合)。
  • JSON-RPC 以行分隔方式透過 stdin/stdout 傳輸(每行一個 JSON 物件)。
  • 無 TCP 埠,無需 daemon。

使用的核心方法:

  • watch.subscribe -> 通知(method: "message"
  • watch.unsubscribe
  • send
  • chats.list(探測/診斷)

舊版設定與定址參見 iMessage(偏好使用 chat_id)。

轉接器指引

  • Gateway 擁有行程(啟動/停止綁定至供應商生命週期)。
  • 保持 RPC 用戶端的韌性:逾時、退出時重啟。
  • 偏好穩定 ID(如 chat_id)而非顯示字串。