RPC and API
Adaptery RPC
OpenClaw integruje zewnętrzne narzędzia CLI przez JSON-RPC. Obecnie używane są dwa wzorce.
Wzorzec A: demon HTTP (signal-cli)
signal-clidziała jako demon z JSON-RPC przez HTTP.- Strumień zdarzeń to SSE (
/api/v1/events). - Sonda kondycji:
/api/v1/check. - OpenClaw zarządza cyklem życia, gdy
channels.signal.autoStart=true.
Zobacz Signal, aby poznać konfigurację i punkty końcowe.
Wzorzec B: proces potomny stdio (starsze: imsg)
Uwaga: W nowych konfiguracjach iMessage używaj zamiast tego BlueBubbles.
- OpenClaw uruchamia
imsg rpcjako proces potomny (starsza integracja iMessage). - JSON-RPC jest rozdzielany wierszami przez stdin/stdout (jeden obiekt JSON na wiersz).
- Brak portu TCP, demon nie jest wymagany.
Używane metody rdzenia:
watch.subscribe→ powiadomienia (method: "message")watch.unsubscribesendchats.list(sonda/diagnostyka)
Zobacz iMessage, aby poznać starszą konfigurację i adresowanie (preferowane chat_id).
Wytyczne dotyczące adapterów
- Gateway zarządza procesem (start/stop powiązane z cyklem życia dostawcy).
- Klienty RPC powinny być odporne: limity czasu, ponowne uruchamianie po zakończeniu.
- Preferuj stabilne identyfikatory (np.
chat_id) zamiast wyświetlanych ciągów znaków.