RPC and API

Адаптеры 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), а не отображаемым строкам.

Связанные материалы

Was this useful?
On this page

On this page