RPC and API
Adaptadores RPC
OpenClaw integra CLIs externos via JSON-RPC. Dois padrões são usados atualmente.
Padrão A: daemon HTTP (signal-cli)
signal-clié executado como um daemon com JSON-RPC sobre HTTP.- O fluxo de eventos é SSE (
/api/v1/events). - Sonda de integridade:
/api/v1/check. - OpenClaw gerencia o ciclo de vida quando
channels.signal.autoStart=true.
Consulte Signal para configuração e endpoints.
Padrão B: processo filho stdio (legado: imsg)
Observação: Para novas configurações do iMessage, use BlueBubbles.
- OpenClaw inicia
imsg rpccomo um processo filho (integração legada do iMessage). - JSON-RPC é delimitado por linha sobre stdin/stdout (um objeto JSON por linha).
- Nenhuma porta TCP, nenhum daemon necessário.
Métodos principais usados:
watch.subscribe→ notificações (method: "message")watch.unsubscribesendchats.list(sonda/diagnósticos)
Consulte iMessage para configuração legada e endereçamento (chat_id preferencial).
Diretrizes para adaptadores
- Gateway gerencia o processo (início/parada vinculados ao ciclo de vida do provedor).
- Mantenha os clientes RPC resilientes: timeouts, reinício ao sair.
- Prefira IDs estáveis (por exemplo,
chat_id) em vez de strings de exibição.