Configuration

Risoluzione dei problemi dei canali

Usa questa pagina quando un canale si connette ma il comportamento è errato.

Sequenza di comandi

Esegui prima questi comandi in ordine:

bash

openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctoropenclaw channels status --probe

Baseline sana:

Runtime: running
Connectivity probe: ok
Capability: read-only, write-capable o admin-capable
Il probe del canale mostra il trasporto connesso e, dove supportato, works o audit ok

Sintomo	Controllo più rapido	Correzione
Connesso ma nessuna risposta ai DM	`openclaw pairing list whatsapp`	Approva il mittente o cambia la policy/l'allowlist dei DM.
Messaggi di gruppo ignorati	Controlla `requireMention` + i pattern di menzione nella config	Menziona il bot o allenta la policy di menzione per quel gruppo.
Il login QR scade con 408	Controlla le variabili env `HTTPS_PROXY` / `HTTP_PROXY` del Gateway	Imposta un proxy raggiungibile; usa `NO_PROXY` solo per i bypass.
Disconnessioni/nuovi login casuali in loop	`openclaw channels status --probe` + log	Le riconnessioni recenti vengono segnalate anche quando il canale è attualmente connesso; osserva i log, riavvia il Gateway, poi ricollega se l'instabilità continua.
Le risposte arrivano con secondi/minuti di ritardo	`openclaw doctor --fix`	Doctor arresta i client TUI locali obsoleti verificati quando degradano l'event loop del Gateway.

Sintomo	Controllo più rapido	Correzione
`/start` ma nessun flusso di risposta utilizzabile	`openclaw pairing list telegram`	Approva il pairing o cambia la policy dei DM.
Bot online ma il gruppo resta silenzioso	Verifica il requisito di menzione e la modalità privacy del bot	Disattiva la modalità privacy per la visibilità del gruppo o menziona il bot.
Invii non riusciti con errori di rete	Ispeziona i log per errori nelle chiamate API di Telegram	Correggi il routing DNS/IPv6/proxy verso `api.telegram.org`.
L'avvio segnala `getMe returned 401`	Controlla la sorgente del token configurata	Copia di nuovo o rigenera il token BotFather e aggiorna `botToken`, `tokenFile` o `TELEGRAM_BOT_TOKEN` dell'account predefinito.
Il polling si blocca o si riconnette lentamente	`openclaw logs --follow` per la diagnostica del polling	Aggiorna; se i riavvii sono falsi positivi, regola `pollingStallThresholdMs`. I blocchi persistenti indicano comunque proxy/DNS/IPv6.
`setMyCommands` rifiutato all'avvio	Ispeziona i log per `BOT_COMMANDS_TOO_MUCH`	Riduci i comandi Telegram di plugin/Skill/personalizzati o disattiva i menu nativi.
Dopo l'upgrade l'allowlist ti blocca	`openclaw security audit` e allowlist di config	Esegui `openclaw doctor --fix` o sostituisci `@username` con ID mittente numerici.

Sintomo	Controllo più rapido	Correzione
Bot online ma nessuna risposta nella guild	`openclaw channels status --probe`	Consenti guild/canale e verifica l'intent per il contenuto dei messaggi.
Messaggi di gruppo ignorati	Controlla nei log gli scarti dovuti al gating delle menzioni	Menziona il bot o imposta `requireMention: false` per guild/canale.
Uso di digitazione/token ma nessun messaggio Discord	Il log della sessione mostra testo dell'assistente con `didSendViaMessagingTool: false`	Il modello ha risposto privatamente invece di chiamare lo strumento di messaggistica. Usa un modello affidabile nelle chiamate strumento, oppure imposta `messages.groupChat.visibleReplies: "automatic"` per pubblicare automaticamente.
Risposte DM mancanti	`openclaw pairing list discord`	Approva il pairing DM o modifica la policy DM.

Sintomo	Controllo più rapido	Correzione
Socket mode connessa ma nessuna risposta	`openclaw channels status --probe`	Verifica app token + bot token e gli scope richiesti; osserva `botTokenStatus` / `appTokenStatus = configured_unavailable` nelle configurazioni basate su SecretRef.
DM bloccati	`openclaw pairing list slack`	Approva il pairing o allenta la policy DM.
Messaggio di canale ignorato	Controlla `groupPolicy` e l'allowlist del canale	Consenti il canale o passa la policy a `open`.

Risoluzione completa dei problemi: Risoluzione dei problemi di Slack

Sintomo	Controllo più rapido	Correzione
`imsg` mancante o non funzionante su non-macOS	`openclaw channels status --probe --channel imessage`	Esegui OpenClaw sul Mac con Messaggi o usa un wrapper SSH per `cliPath`.
Può inviare ma non riceve su macOS	Controlla le autorizzazioni privacy di macOS per l'automazione di Messaggi	Concedi di nuovo le autorizzazioni TCC e riavvia il processo del canale.
Mittente DM bloccato	`openclaw pairing list imessage`	Approva il pairing o aggiorna l'allowlist.

Risoluzione completa dei problemi:

Sintomo	Controllo più rapido	Correzione
Daemon raggiungibile ma bot silenzioso	`openclaw channels status --probe`	Verifica URL/account del daemon `signal-cli` e modalità di ricezione.
DM bloccato	`openclaw pairing list signal`	Approva il mittente o modifica la policy DM.
Le risposte di gruppo non si attivano	Controlla l'allowlist del gruppo e i pattern di menzione	Aggiungi mittente/gruppo o allenta il gating.

Risoluzione completa dei problemi: Risoluzione dei problemi di Signal

Sintomo	Controllo più rapido	Correzione
Il bot risponde "andato su Marte"	Verifica `appId` e `clientSecret` nella config	Imposta le credenziali o riavvia il Gateway.
Nessun messaggio in ingresso	`openclaw channels status --probe`	Verifica le credenziali sulla QQ Open Platform.
Voce non trascritta	Controlla la config del provider STT	Configura `channels.qqbot.stt` o `tools.media.audio`.
Messaggi proattivi non arrivano	Controlla i requisiti di interazione della piattaforma QQ	QQ può bloccare i messaggi avviati dal bot senza interazione recente.

Risoluzione completa dei problemi: Risoluzione dei problemi di QQ Bot

Sintomo	Controllo più rapido	Correzione
Autenticato ma ignora i messaggi della stanza	`openclaw channels status --probe`	Controlla `groupPolicy`, allowlist della stanza e gating delle menzioni.
I DM non vengono elaborati	`openclaw pairing list matrix`	Approva il mittente o modifica la policy DM.
Le stanze cifrate falliscono	`openclaw matrix verify status`	Verifica di nuovo il dispositivo, poi controlla `openclaw matrix verify backup status`.
Ripristino del backup in sospeso/rotto	`openclaw matrix verify backup status`	Esegui `openclaw matrix verify backup restore` o riesegui con una chiave di recupero.
Cross-signing/bootstrap sembra errato	`openclaw matrix verify bootstrap`	Ripara archiviazione segreta, cross-signing e stato del backup in un unico passaggio.

Configurazione e setup completi: Matrix

Was this useful?