OpenClaw su iMessage

OpenClaw parla iMessage tramite imsg, un bridge a riga di comando che il Gateway avvia e con cui comunica in JSON-RPC su standard input e standard output: nessun daemon, nessuna porta. Deve girare su un Mac con accesso effettuato a Messaggi e, se il Gateway sta altrove, raggiunge quel Mac tramite un wrapper SSH. Il supporto a BlueBubbles è stato rimosso: ora imsg è l’unica strada. Ecco la configurazione, i permessi, le due modalità e gli schemi di deployment consigliati dalla documentazione.

Configurazione sul Mac

• Installa il plugin ufficiale iMessage sull’host del Gateway, poi imsg tramite Homebrew dal suo tap; la procedura guidata di configurazione può proporre quell’installazione, o un aggiornamento, quando trova un imsg mancante o gestito da Homebrew.
• Punta il canale al binario imsg e al database di Messaggi nella cartella Libreria dell’utente, avvia il Gateway e approva il primo abbinamento via messaggio diretto: le richieste scadono dopo un’ora.
• Concedi Accesso completo al disco e Automazione al contesto che esegue imsg; le richieste di autorizzazione perse sono una delle voci elencate nella risoluzione dei problemi, così come i messaggi che partono mentre non arriva nulla.

Modalità base e modalità API privata

La modalità base è quella che ottieni con una nuova installazione: testo e media in uscita, monitoraggio e cronologia in entrata, l’elenco delle chat e nessuna modifica al sistema. La modalità API privata inietta un helper in Messaggi per raggiungerne le funzioni interne, il che sblocca reazioni, modifiche, annullamento dell’invio, risposte in thread, effetti, sondaggi nativi, gestione dei gruppi, indicatori di digitazione e conferme di lettura. Richiede la Protezione dell’integrità del sistema disattivata e la convalida delle librerie allentata, e l’iniezione si rifiuta di funzionare finché SIP è attivo.

Disattivare SIP è un vero compromesso di sicurezza.

La documentazione è diretta su questo compromesso: SIP è una delle protezioni fondamentali di macOS, disattivarlo su Apple Silicon toglie anche la possibilità di eseguire app iOS sul Mac, e la raccomandazione è un Mac dedicato o un utente dedicato al bot per il bridge. Se il tuo modello di minaccia non può tollerare SIP disattivato da nessuna parte, il canale resta in sola modalità base. Per la checklist più ampia, consulta le buone pratiche di sicurezza per OpenClaw.

Dove sta il Gateway

• Stesso Mac: il deployment abituale, Gateway e imsg insieme sull’host con accesso effettuato a Messaggi.
• Mac remoto via SSH o Tailscale: il Gateway su Linux o su una VM, imsg su un Mac nella tailnet, un wrapper SSH trasparente come percorso della CLI e un’impostazione dell’host remoto per gli allegati. Il wrapper deve inoltrare i byte man mano che arrivano; uno che li bufferizza sembra in tutto e per tutto un’interruzione di iMessage.
• Utente macOS dedicato al bot: un Apple ID e un utente separati, così il traffico del bot non tocca mai il tuo profilo personale di Messaggi; la prima esecuzione richiede le approvazioni di Automazione e Accesso completo al disco nella sessione di quell’utente.

Il recupero in entrata è automatico: dopo un riavvio del bridge o del Gateway, il canale riproduce ciò che si è perso e scarta l’arretrato che Apple può riversare dopo un recupero push, senza smistare nulla due volte. L’articolo su OpenClaw che non risponde copre la scala generale per un canale silenzioso.

Cosa significa in pratica

iMessage è l’unico canale che non può essere spostato fuori dall’hardware Apple. Un Gateway ovunque può servirlo, ma solo con un Mac dalla tua parte che esegue imsg, con l’accesso effettuato, sveglio e raggiungibile, e quel Mac diventa parte del lavoro operativo: i suoi aggiornamenti, i suoi permessi, la sua decisione su SIP.

Su Diali

Su Diali, iMessage è nella roadmap anziché nell’elenco dei canali collegabili, perché il Mac con Messaggi deve essere tuo e l’abbinamento tra quel Mac e un Gateway ospitato merita una pagina a parte. Fino ad allora OpenClaw su Telegram è il canale con cui inizia la maggior parte delle persone; OpenClaw ospitato su Diali è l’assistente.

• imsg su un Mac con accesso effettuato, Accesso completo al disco e Automazione, abbinamento per i messaggi diretti.
• La modalità base mantiene SIP attivo; l’API privata richiede di disattivarlo, idealmente su un Mac o un utente dedicato.
• Il Gateway può stare ovunque; il Mac no.