Vai al contenuto principale

​
Risoluzione dei problemi dei canali

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

​
Sequenza di comandi

Esegui prima questi, in questo ordine: 
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
Baseline sana:
  • Runtime: running
  • RPC probe: ok
  • La probe del canale mostra il trasporto connesso e, dove supportato, works o audit ok

​
WhatsApp

​
Firme di errore di WhatsApp

SintomoControllo più rapidoCorrezione
Connesso ma nessuna risposta DMopenclaw pairing list whatsappApprova il mittente o cambia la policy/allowlist dei DM.
Messaggi di gruppo ignoratiControlla requireMention + i pattern di menzione nella configMenziona il bot o allenta la policy di menzione per quel gruppo.
Disconnessioni casuali/cicli di nuovo loginopenclaw channels status --probe + logEffettua di nuovo il login e verifica che la directory delle credenziali sia integra.
Risoluzione completa dei problemi: /channels/whatsapp#troubleshooting

​
Telegram

​
Firme di errore di Telegram

SintomoControllo più rapidoCorrezione
/start ma nessun flusso di risposta utilizzabileopenclaw pairing list telegramApprova l’associazione o modifica la policy dei DM.
Bot online ma il gruppo resta silenziosoVerifica il requisito di menzione e la modalità privacy del botDisabilita la modalità privacy per la visibilità nel gruppo oppure menziona il bot.
Errori di invio con errori di reteIspeziona i log per i fallimenti delle chiamate API di TelegramCorreggi il routing DNS/IPv6/proxy verso api.telegram.org.
setMyCommands rifiutato all’avvioIspeziona i log per BOT_COMMANDS_TOO_MUCHRiduci i comandi Telegram di plugin/Skills/personalizzati oppure disabilita i menu nativi.
Hai effettuato un upgrade e l’allowlist ti bloccaopenclaw security audit e le allowlist della configEsegui openclaw doctor --fix oppure sostituisci @username con ID numerici del mittente.
Risoluzione completa dei problemi: /channels/telegram#troubleshooting

​
Discord

​
Firme di errore di Discord

SintomoControllo più rapidoCorrezione
Bot online ma nessuna risposta nel serveropenclaw channels status --probeConsenti server/canale e verifica l’intento del contenuto dei messaggi.
Messaggi di gruppo ignoratiControlla nei log i blocchi dovuti alla regola di menzioneMenziona il bot o imposta requireMention: false per server/canale.
Risposte DM mancantiopenclaw pairing list discordApprova l’associazione DM o regola la policy dei DM.
Risoluzione completa dei problemi: /channels/discord#troubleshooting

​
Slack

​
Firme di errore di Slack

SintomoControllo più rapidoCorrezione
Socket mode connessa ma nessuna rispostaopenclaw channels status --probeVerifica app token + bot token e gli scope richiesti; controlla botTokenStatus / appTokenStatus = configured_unavailable nelle configurazioni basate su SecretRef.
DM bloccatiopenclaw pairing list slackApprova l’associazione o allenta la policy dei DM.
Messaggio del canale ignoratoControlla groupPolicy e l’allowlist del canaleConsenti il canale o cambia la policy in open.
Risoluzione completa dei problemi: /channels/slack#troubleshooting

​
iMessage e BlueBubbles

​
Firme di errore di iMessage e BlueBubbles

SintomoControllo più rapidoCorrezione
Nessun evento in ingressoVerifica la raggiungibilità del webhook/server e i permessi dell’appCorreggi l’URL del webhook o lo stato del server BlueBubbles.
Può inviare ma non ricevere su macOSControlla i permessi privacy di macOS per l’automazione di MessagesConcedi di nuovo i permessi TCC e riavvia il processo del canale.
Mittente DM bloccatoopenclaw pairing list imessage o openclaw pairing list bluebubblesApprova l’associazione o aggiorna l’allowlist.
Risoluzione completa dei problemi:

​
Signal

​
Firme di errore di Signal

SintomoControllo più rapidoCorrezione
Demone raggiungibile ma bot silenziosoopenclaw channels status --probeVerifica URL/account del demone signal-cli e la modalità di ricezione.
DM bloccatoopenclaw pairing list signalApprova il mittente o regola la policy dei DM.
Le risposte nei gruppi non si attivanoControlla l’allowlist del gruppo e i pattern di menzioneAggiungi mittente/gruppo o allenta il gating.
Risoluzione completa dei problemi: /channels/signal#troubleshooting

​
QQ Bot

​
Firme di errore di QQ Bot

SintomoControllo più rapidoCorrezione
Il bot risponde “gone to Mars”Verifica appId e clientSecret nella configImposta le credenziali o riavvia il gateway.
Nessun messaggio in ingressoopenclaw channels status --probeVerifica le credenziali sulla QQ Open Platform.
Voce non trascrittaControlla la config del provider STTConfigura channels.qqbot.stt o tools.media.audio.
I messaggi proattivi non arrivanoControlla i requisiti di interazione della piattaforma QQQQ può bloccare i messaggi avviati dal bot senza un’interazione recente.
Risoluzione completa dei problemi: /channels/qqbot#troubleshooting

​
Matrix

​
Firme di errore di Matrix

SintomoControllo più rapidoCorrezione
Accesso eseguito ma i messaggi della stanza vengono ignoratiopenclaw channels status --probeControlla groupPolicy, l’allowlist delle stanze e il gating delle menzioni.
I DM non vengono elaboratiopenclaw pairing list matrixApprova il mittente o regola la policy dei DM.
Le stanze crittografate non funzionanoopenclaw matrix verify statusVerifica di nuovo il dispositivo, poi controlla openclaw matrix verify backup status.
Il ripristino del backup è in sospeso/non funzionaopenclaw matrix verify backup statusEsegui openclaw matrix verify backup restore o ripeti l’operazione con una chiave di recupero.
Cross-signing/bootstrap sembra erratoopenclaw matrix verify bootstrapRipara secret storage, cross-signing e stato del backup in un solo passaggio.
Configurazione e setup completi: Matrix