Adaptadores RPC

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

# Patrón A: daemon HTTP (signal-cli)

• signal-cli se ejecuta como daemon con JSON-RPC sobre HTTP.
• El flujo de eventos es SSE (/api/v1/events).
• Sondeo de salud: /api/v1/check.
• OpenClaw controla el ciclo de vida cuando channels.signal.autoStart=true.

Consulta Signal para la configuración y los endpoints.

# Patrón B: proceso hijo stdio (heredado: imsg)

Nota: Para nuevas configuraciones de iMessage, usa BlueBubbles en su lugar.

• OpenClaw inicia imsg rpc como proceso hijo (integración heredada de iMessage).
• JSON-RPC se delimita por líneas sobre stdin/stdout (un objeto JSON por línea).
• No se requiere puerto TCP ni daemon.

Métodos principales usados:

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

Consulta iMessage para la configuración heredada y el direccionamiento (chat_id preferido).

# Pautas para adaptadores

• Gateway controla el proceso (inicio/detención vinculados al ciclo de vida del proveedor).
• Mantén los clientes RPC resilientes: tiempos de espera, reinicio al salir.
• Prefiere identificadores estables (por ejemplo, chat_id) en lugar de cadenas de visualización.

# Relacionado

• Protocolo de Gateway