RPC and API

Adaptateurs RPC

OpenClaw intègre des CLI externes via JSON-RPC. Deux modèles sont utilisés aujourd’hui.

Modèle A : démon HTTP (signal-cli)

  • signal-cli s’exécute comme un démon avec JSON-RPC sur HTTP.
  • Le flux d’événements est SSE (/api/v1/events).
  • Sonde d’intégrité : /api/v1/check.
  • OpenClaw possède le cycle de vie lorsque channels.signal.autoStart=true.

Consultez Signal pour la configuration et les points de terminaison.

Modèle B : processus enfant stdio (hérité : imsg)

Remarque : Pour les nouvelles configurations iMessage, utilisez plutôt BlueBubbles.

  • OpenClaw lance imsg rpc comme processus enfant (intégration iMessage héritée).
  • JSON-RPC est délimité par lignes sur stdin/stdout (un objet JSON par ligne).
  • Aucun port TCP, aucun démon requis.

Méthodes principales utilisées :

  • watch.subscribe → notifications (method: "message")
  • watch.unsubscribe
  • send
  • chats.list (sonde/diagnostics)

Consultez iMessage pour la configuration héritée et l’adressage (chat_id préféré).

Consignes pour les adaptateurs

  • Gateway possède le processus (démarrage/arrêt liés au cycle de vie du fournisseur).
  • Gardez les clients RPC résilients : délais d’expiration, redémarrage à la sortie.
  • Préférez les identifiants stables (par ex., chat_id) aux chaînes d’affichage.

Associé