Adaptadores RPC

O OpenClaw integra CLIs externas via JSON-RPC. Atualmente, são usados dois padrões.

Padrão A: daemon HTTP (signal-cli)

• O signal-cli é executado como um daemon com JSON-RPC via HTTP.
• O fluxo de eventos usa SSE (/api/v1/events).
• Sonda de integridade: /api/v1/check.
• O OpenClaw gerencia o ciclo de vida quando channels.signal.autoStart=true.

Consulte Signal para ver a configuração e os endpoints.

Padrão B: processo filho via stdio (imsg)

• O OpenClaw inicia imsg rpc como um processo filho para o iMessage.
• O JSON-RPC é delimitado por linhas em stdin/stdout (um objeto JSON por linha).
• Nenhuma porta TCP e nenhum daemon são necessários.

Principais métodos usados:

• watch.subscribe → notificações (method: "message")
• watch.unsubscribe
• send
• chats.list (sondagem/diagnóstico)

Consulte iMessage para ver a configuração e o endereçamento (prefira chat_id a strings de exibição).

Diretrizes para adaptadores

• O Gateway gerencia o processo (início/parada vinculados ao ciclo de vida do provedor).
• Mantenha os clientes RPC resilientes: use tempos limite e reinicie após o encerramento.
• Prefira IDs estáveis (por exemplo, chat_id) a strings de exibição.

Relacionado

• Protocolo do Gateway