Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
Usa questa pagina quando un canale si connette ma il comportamento è errato.
Sequenza di comandi
Esegui prima questi comandi in ordine:
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
Runtime: runningConnectivity probe: okCapability: read-only, write-capable o admin-capable- Il probe del canale mostra il trasporto connesso e, dove supportato,
works o audit ok
WhatsApp
Segnali di errore di WhatsApp
| 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. |
Telegram
Segnali di errore di Telegram
| 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. |
Discord
Segnali di errore di Discord
| 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. |
Slack
Segnali di errore di Slack
| 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. |
iMessage
Segnali di errore di iMessage
| 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. |
Signal
Segnali di errore di Signal
| 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. |
QQ Bot
Segnali di errore di QQ Bot
| 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. |
Matrix
Segnali di errore di Matrix
| 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. |
Correlati
