RPC and API

RPC-Adapter

OpenClaw integriert externe CLIs über JSON-RPC. Derzeit werden zwei Muster verwendet.

Muster A: HTTP-Daemon (signal-cli)

  • signal-cli läuft als Daemon mit JSON-RPC über HTTP.
  • Der Ereignisstream ist SSE (/api/v1/events).
  • Health-Probe: /api/v1/check.
  • OpenClaw besitzt den Lebenszyklus, wenn channels.signal.autoStart=true.

Siehe Signal für Einrichtung und Endpunkte.

Muster B: stdio-Kindprozess (Legacy: imsg)

Hinweis: Für neue iMessage-Einrichtungen verwenden Sie stattdessen BlueBubbles.

  • OpenClaw startet imsg rpc als Kindprozess (Legacy-iMessage-Integration).
  • JSON-RPC ist zeilengetrennt über stdin/stdout (ein JSON-Objekt pro Zeile).
  • Kein TCP-Port, kein Daemon erforderlich.

Verwendete Kernmethoden:

  • watch.subscribe → Benachrichtigungen (method: "message")
  • watch.unsubscribe
  • send
  • chats.list (Probe/Diagnose)

Siehe iMessage für Legacy-Einrichtung und Adressierung (chat_id bevorzugt).

Adapter-Richtlinien

  • Gateway besitzt den Prozess (Start/Stopp ist an den Provider-Lebenszyklus gebunden).
  • Halten Sie RPC-Clients robust: Timeouts, Neustart beim Beenden.
  • Bevorzugen Sie stabile IDs (z. B. chat_id) gegenüber Anzeigezeichenfolgen.

Verwandt