本文へスキップ

RPCと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)​

注: 新しいiMessageセットアップでは、代わりにBlueBubblesを使用してください。

  • OpenClawは子プロセスとしてimsg rpcを生成します（レガシーiMessage統合）。
  • JSON-RPCはstdin/stdoutを介した行区切り形式です（1行に1つのJSONオブジェクト）。
  • TCPポートやデーモンは不要です。

使用されるコアメソッド:

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

レガシーセットアップとアドレッシング（chat_idが推奨）については、iMessageを参照してください。

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

  • ゲートウェイがプロセスを所有します（起動/停止はプロバイダーのライフサイクルに紐づけられます）。
  • RPCクライアントは耐障害性を持たせます：タイムアウト、終了時の再起動。
  • 表示文字列よりも安定したID（例: chat_id）を優先します。

webhooksデバイスモデルデータベース