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).
• Zustandsprüfung: /api/v1/check.
• OpenClaw verwaltet den Lebenszyklus, wenn channels.signal.autoStart=true festgelegt ist.

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).
• Es ist weder ein TCP-Port noch ein 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 Anzeigenamen bevorzugt).

Richtlinien für Adapter

• Der Gateway verwaltet den Prozess (Start/Stopp sind an den Lebenszyklus des Providers gekoppelt).
• RPC-Clients müssen robust sein: Zeitüberschreitungen und Neustart bei Prozessbeendigung.
• Bevorzugen Sie stabile IDs (z. B. chat_id) gegenüber Anzeigenamen.

Verwandte Themen

• Gateway-Protokoll