RPC and API

RPC 配接器

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

模式 A:HTTP 常駐程式(signal-cli)

  • signal-cli 以常駐程式形式執行,透過 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 連接埠,也不需要常駐程式。

使用的核心方法:

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

請參閱 iMessage 了解舊版設定與定址(建議使用 chat_id)。

轉接器指南

  • Gateway 負責行程(啟動/停止與提供者生命週期綁定)。
  • 讓 RPC 用戶端保持韌性:逾時、退出時重新啟動。
  • 優先使用穩定 ID(例如 chat_id),而不是顯示字串。

相關