Adattatori RPC

OpenClaw integra CLI esterne tramite JSON-RPC. Oggi vengono usati due modelli.

# Modello A: daemon HTTP (signal-cli)

• signal-cli viene eseguito come daemon con JSON-RPC su HTTP.
• Il flusso eventi è SSE (/api/v1/events).
• Controllo di integrità: /api/v1/check.
• OpenClaw gestisce il ciclo di vita quando channels.signal.autoStart=true.

Vedi Signal per la configurazione e gli endpoint.

# Modello B: processo figlio stdio (storico: imsg)

Nota: Per le nuove configurazioni di iMessage, usa invece BlueBubbles.

• OpenClaw avvia imsg rpc come processo figlio (integrazione storica di iMessage).
• JSON-RPC è delimitato da righe su stdin/stdout (un oggetto JSON per riga).
• Nessuna porta TCP, nessun daemon richiesto.

Metodi principali usati:

• watch.subscribe → notifiche (method: "message")
• watch.unsubscribe
• send
• chats.list (sonda/diagnostica)

Vedi iMessage per la configurazione storica e l'indirizzamento (chat_id preferito).

# Linee guida per gli adapter

• Gateway gestisce il processo (avvio/arresto legati al ciclo di vita del provider).
• Mantieni i client RPC resilienti: timeout, riavvio all'uscita.
• Preferisci ID stabili (ad es., chat_id) rispetto alle stringhe visualizzate.

# Correlati

• Protocollo Gateway