Adaptadores RPC

OpenClaw integra CLI externas mediante JSON-RPC. Actualmente se utilizan dos patrones.

Patrón A: demonio HTTP (signal-cli)

• signal-cli se ejecuta como demonio con JSON-RPC sobre HTTP.
• El flujo de eventos es SSE (/api/v1/events).
• Sondeo de estado: /api/v1/check.
• OpenClaw controla el ciclo de vida cuando channels.signal.transport.kind="managed-native" (valor predeterminado).

Consulte Signal para conocer la configuración y los endpoints.

Patrón B: proceso secundario mediante stdio (imsg)

• OpenClaw inicia imsg rpc como proceso secundario para iMessage.
• JSON-RPC se delimita por líneas mediante stdin/stdout (un objeto JSON por línea).
• No se requiere ningún puerto TCP ni demonio.

Métodos principales utilizados:

• watch.subscribe → notificaciones (method: "message")
• watch.unsubscribe
• send
• chats.list (sondeo/diagnóstico)

Consulte iMessage para conocer la configuración y el direccionamiento (se prefiere chat_id frente a las cadenas de visualización).

Directrices para adaptadores

• Gateway controla el proceso (el inicio y la detención están vinculados al ciclo de vida del proveedor).
• Mantenga la resiliencia de los clientes RPC: tiempos de espera y reinicio al finalizar.
• Prefiera identificadores estables (por ejemplo, chat_id) frente a las cadenas de visualización.

Contenido relacionado

• Protocolo de Gateway