Przejdź do głównej treści

Adaptery RPC

OpenClaw integruje zewnętrzne CLI przez JSON-RPC. Obecnie używane są dwa wzorce.

Wzorzec A: demon HTTP (signal-cli)

  • signal-cli działa jako demon z JSON-RPC przez HTTP.
  • Strumień zdarzeń to SSE (/api/v1/events).
  • Sonda health: /api/v1/check.
  • OpenClaw zarządza cyklem życia, gdy channels.signal.autoStart=true.
Konfigurację i endpointy znajdziesz w Signal.

Wzorzec B: proces potomny stdio (starszy: imsg)

Uwaga: dla nowych konfiguracji iMessage użyj zamiast tego BlueBubbles.
  • OpenClaw uruchamia imsg rpc jako proces potomny (starsza integracja iMessage).
  • JSON-RPC jest rozdzielany liniami przez stdin/stdout (jeden obiekt JSON na linię).
  • Brak portu TCP, demon nie jest wymagany.
Używane główne metody:
  • watch.subscribe → powiadomienia (method: "message")
  • watch.unsubscribe
  • send
  • chats.list (sonda / diagnostyka)
Szczegóły starszej konfiguracji i adresowania (chat_id preferowane) znajdziesz w iMessage.

Wytyczne dla adapterów

  • Gateway zarządza procesem (uruchamianie/zatrzymywanie powiązane z cyklem życia dostawcy).
  • Utrzymuj klientów RPC odpornych na problemy: timeouty, restart po wyjściu.
  • Preferuj stabilne identyfikatory (np. chat_id) zamiast ciągów wyświetlanych.