RPC-адаптери

OpenClaw інтегрує зовнішні CLI через JSON-RPC. Наразі використовуються дві схеми.

Схема A: HTTP-демон (signal-cli)

• signal-cli працює як демон із JSON-RPC через HTTP.
• Потік подій використовує SSE (/api/v1/events).
• Перевірка працездатності: /api/v1/check.
• OpenClaw керує життєвим циклом, коли channels.signal.autoStart=true.

Налаштування та кінцеві точки описано в розділі Signal.

Схема B: дочірній процес stdio (imsg)

• OpenClaw запускає imsg rpc як дочірній процес для iMessage.
• JSON-RPC передається рядками через stdin/stdout (один об’єкт JSON у кожному рядку).
• TCP-порт і демон не потрібні.

Основні використовувані методи:

• watch.subscribe → сповіщення (method: "message")
• watch.unsubscribe
• send
• chats.list (перевірка/діагностика)

Налаштування й адресацію описано в розділі iMessage (chat_id має перевагу над відображуваними рядками).

Рекомендації щодо адаптерів

• Gateway керує процесом (запуск і зупинка прив’язані до життєвого циклу провайдера).
• Забезпечуйте стійкість клієнтів RPC: використовуйте тайм-аути та перезапуск після завершення процесу.
• Надавайте перевагу стабільним ідентифікаторам (наприклад, chat_id) над відображуваними рядками.

Пов’язані матеріали

• Протокол Gateway