RPC-Adapteren

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

Muster A: HTTP-Daemon (signal-cli)

• signal-cli wird als Daemon mit JSON-RPC über HTTP ausgeführt.
• Der Ereignisstream verwendet SSE (/api/v1/events).
• Integritätsprüfung: /api/v1/check.
• OpenClaw verwaltet den Lebenszyklus, wenn channels.signal.transport.kind="managed-native" (Standard).

Einrichtung und Endpunkte finden Sie unter Signal.

Muster B: untergeordneter stdio-Prozess (imsg)

• OpenClaw startet imsg rpc als untergeordneten Prozess für iMessage.
• JSON-RPC wird zeilenweise über stdin/stdout übertragen (ein JSON-Objekt pro Zeile).
• Kein TCP-Port und kein Daemon erforderlich.

Verwendete Kernmethoden:

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

Einrichtung und Adressierung finden Sie unter iMessage (chat_id wird gegenüber Anzeigezeichenfolgen bevorzugt).

Adapter-Richtlinien

• Der Gateway verwaltet den Prozess (Start/Stopp sind an den Lebenszyklus des Providers gekoppelt).
• RPC-Clients müssen robust bleiben: Zeitüberschreitungen verwenden und nach dem Beenden neu starten.
• Stabile IDs (z. B. chat_id) sind Anzeigezeichenfolgen vorzuziehen.

Verwandte Themen

• Gateway-Protokoll