Naar hoofdinhoud gaan

​
RPC-adapters

OpenClaw integreert externe CLI’s via JSON-RPC. Tegenwoordig worden twee patronen gebruikt.

​
Patroon A: HTTP-daemon (signal-cli)

  • signal-cli draait als een daemon met JSON-RPC over HTTP.
  • Eventstream is SSE (/api/v1/events).
  • Gezondheidscontrole: /api/v1/check.
  • OpenClaw beheert de lifecycle wanneer channels.signal.autoStart=true.
Zie Signal voor installatie en endpoints.

​
Patroon B: stdio childproces (legacy: imsg)

Let op: Gebruik voor nieuwe iMessage-installaties in plaats daarvan BlueBubbles.
  • OpenClaw start imsg rpc als een childproces (legacy iMessage-integratie).
  • JSON-RPC is regelgescheiden over stdin/stdout (één JSON-object per regel).
  • Geen TCP-poort, geen daemon vereist.
Gebruikte kernmethoden:
  • watch.subscribe → notificaties (method: "message")
  • watch.unsubscribe
  • send
  • chats.list (probe/diagnostiek)
Zie iMessage voor legacy installatie en adressering (chat_id heeft de voorkeur).

​
Richtlijnen voor adapters

  • Gateway beheert het proces (start/stop gekoppeld aan de provider-lifecycle).
  • Houd RPC-clients robuust: time-outs, herstart bij beëindigen.
  • Geef de voorkeur aan stabiele ID’s (bijv. chat_id) boven weergavestrings.