Risoluzione problemi canali

Usa questa pagina quando un canale si connette ma il comportamento e anomalo.

Scaletta dei comandi

Esegui questi nell’ordine:

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

Baseline di buon funzionamento:

Sintomo	Verifica piu rapida	Soluzione
Connesso ma nessuna risposta ai DM	`openclaw pairing list whatsapp`	Approva il mittente o cambia policy DM/allowlist.
Messaggi di gruppo ignorati	Controlla `requireMention` + pattern di menzione nel config	Menziona il bot o rilassa la policy di menzione per quel gruppo.
Disconnessioni casuali/loop di relogin	`openclaw channels status --probe` + log	Rifai il login e verifica che la directory credenziali sia sana.

Sintomo	Verifica piu rapida	Soluzione
`/start` ma nessun flusso di risposta utile	`openclaw pairing list telegram`	Approva il pairing o cambia la policy DM.
Bot online ma il gruppo resta silenzioso	Verifica requisito menzione e privacy mode del bot	Disabilita il privacy mode per la visibilita nei gruppi o menziona il bot.
Errori di invio con errori di rete	Ispeziona i log per fallimenti delle chiamate API Telegram	Correggi il routing DNS/IPv6/proxy verso `api.telegram.org`.
`setMyCommands` rifiutato all’avvio	Ispeziona i log per `BOT_COMMANDS_TOO_MUCH`	Riduci i comandi Telegram di plugin/skill/personalizzati o disabilita i menu nativi.
Aggiornato e l’allowlist ti blocca	`openclaw security audit` e allowlist del config	Esegui `openclaw doctor --fix` o sostituisci `@username` con ID numerici del mittente.

Sintomo	Verifica piu rapida	Soluzione
Bot online ma nessuna risposta nel guild	`openclaw channels status --probe`	Consenti guild/canale e verifica il message content intent.
Messaggi di gruppo ignorati	Controlla nei log i drop del mention gating	Menziona il bot o imposta `requireMention: false` per guild/canale.
Risposte DM mancanti	`openclaw pairing list discord`	Approva il pairing DM o modifica la policy DM.

Sintomo	Verifica piu rapida	Soluzione
Socket mode connesso ma nessuna risposta	`openclaw channels status --probe`	Verifica app token + bot token e gli scope richiesti.
DM bloccati	`openclaw pairing list slack`	Approva il pairing o rilassa la policy DM.
Messaggi nel canale ignorati	Controlla `groupPolicy` e allowlist del canale	Consenti il canale o imposta la policy su `open`.

Sintomo	Verifica piu rapida	Soluzione
Nessun evento in ingresso	Verifica raggiungibilita webhook/server e permessi dell’app	Correggi l’URL del webhook o lo stato del server BlueBubbles.
Invio funziona ma non ricezione su macOS	Controlla permessi privacy macOS per l’automazione di Messaggi	Rinnova i permessi TCC e riavvia il processo del canale.
Mittente DM bloccato	`openclaw pairing list imessage` o `openclaw pairing list bluebubbles`	Approva il pairing o aggiorna l’allowlist.

Risoluzione completa:

Sintomo	Verifica piu rapida	Soluzione
Daemon raggiungibile ma bot silenzioso	`openclaw channels status --probe`	Verifica URL/account del daemon `signal-cli` e modalita ricezione.
DM bloccato	`openclaw pairing list signal`	Approva il mittente o modifica la policy DM.
Risposte nei gruppi non si attivano	Controlla allowlist gruppi e pattern di menzione	Aggiungi mittente/gruppo o allenta il gating.

Sintomo	Verifica piu rapida	Soluzione
Loggato ma ignora i messaggi nelle stanze	`openclaw channels status --probe`	Controlla `groupPolicy` e allowlist delle stanze.
I DM non vengono elaborati	`openclaw pairing list matrix`	Approva il mittente o modifica la policy DM.
Le stanze crittografate non funzionano	Verifica modulo crypto e impostazioni di crittografia	Abilita il supporto alla crittografia e rientra/sincronizza la stanza.