RPC and API

RPC アダプター

OpenClaw は JSON-RPC を介して外部 CLI と統合します。現在、2 つのパターンが使用されています。

パターン 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)

  • OpenClaw は、iMessage用の子プロセスとして imsg rpc を起動します。
  • JSON-RPC は stdin/stdout 経由で行区切り形式(1 行につき 1 つの JSON オブジェクト)で送受信されます。
  • TCP ポートもデーモンも不要です。

使用される主要なメソッド:

  • watch.subscribe → 通知(method: "message"
  • watch.unsubscribe
  • send
  • chats.list(プローブ/診断)

セットアップとアドレス指定(表示文字列より chat_id を推奨)については、iMessageを参照してください。

アダプターのガイドライン

  • Gateway がプロセスを管理します(開始/停止はプロバイダーのライフサイクルに連動します)。
  • RPC クライアントの耐障害性を維持します。タイムアウトを設定し、終了時に再起動してください。
  • 表示文字列より安定した ID(例: chat_id)を優先してください。

関連項目

Was this useful?
On this page

On this page