RPC and API

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 daemon met JSON-RPC via HTTP.
  • De gebeurtenisstroom is SSE (/api/v1/events).
  • Statuscontrole: /api/v1/check.
  • OpenClaw beheert de levenscyclus wanneer channels.signal.autoStart=true.

Zie Signal voor configuratie en eindpunten.

Patroon B: stdio-childproces (verouderd: imsg)

Opmerking: Gebruik voor nieuwe iMessage-configuraties in plaats daarvan BlueBubbles.

  • OpenClaw start imsg rpc als childproces (verouderde iMessage-integratie).
  • JSON-RPC is regelgescheiden via stdin/stdout (één JSON-object per regel).
  • Geen TCP-poort, geen daemon vereist.

Gebruikte kernmethoden:

  • watch.subscribe → meldingen (method: "message")
  • watch.unsubscribe
  • send
  • chats.list (probe/diagnostiek)

Zie iMessage voor verouderde configuratie en adressering (chat_id aanbevolen).

Adapterrichtlijnen

  • Gateway beheert het proces (start/stop gekoppeld aan de providerlevenscyclus).
  • Houd RPC-clients veerkrachtig: time-outs, herstarten bij afsluiten.
  • Geef de voorkeur aan stabiele ID's (bijv. chat_id) boven weergavestrings.

Gerelateerd