OpenClaw non risponde: come scoprire il motivo

Invii un messaggio e non torna nulla. Un assistente self-hosted ha quattro punti in cui una risposta può andare persa, e dalla finestra della chat appaiono identici. Testarli in ordine richiede circa cinque minuti e trasforma un bot silenzioso in un guasto preciso e risolvibile.

I quattro livelli

Prima di cambiare qualsiasi cosa, sappi cosa stai testando. Un messaggio attraversa tutti e quattro questi livelli, e qualsiasi di essi può inghiottirlo senza che arrivi un errore fino a te:

1. L'istanza. OpenClaw è davvero in esecuzione sul tuo server?
2. Il fornitore del modello. Il modello linguistico accetta le tue richieste?
3. L'integrazione di chat. Il messaggio arriva davvero a OpenClaw?
4. Il percorso di rete. Tu e la piattaforma riuscite a raggiungere l'istanza?

C'è un test che divide subito il problema a metà: invia un messaggio nell'interfaccia web di OpenClaw. Se ottieni una risposta lì, i primi due livelli funzionano e il problema è l'integrazione. Se non la ottieni, smetti di guardare il bot del tutto.

Livello 1: l'istanza è in esecuzione?

Apri la tua dashboard Flux e verifica che l'istanza sia attiva invece di riavviarsi in continuazione. Un container che continua a morire e tornare è la versione meno ovvia di questo problema, perché il servizio sembra presente tra un riavvio e l'altro.

La causa abituale di un ciclo di riavvii è la memoria. Se hai puntato OpenClaw a un modello locale invece che a un'API ospitata, i pesi del modello devono entrare nella stessa RAM di tutto il resto. Un modello 7B quantizzato a 4 bit occupa da solo circa 4 GB di pesi, prima di qualsiasi contesto di conversazione e prima del processo dell'assistente. Sul piano da 4 GB non può funzionare, e il piano da 8 GB è il minimo realistico per l'inferenza locale. Oppure passa a un piano superiore o punta l'assistente a un modello ospitato, dove il lavoro pesante avviene sull'hardware del fornitore e la tua istanza deve solo contenere la conversazione.

Se non riesci affatto a raggiungere l'interfaccia web, annotalo e passa al livello quattro prima di dare per scontato che l'istanza sia rotta.

Livello 2: il fornitore del modello ti sta rifiutando?

OpenClaw è indipendente dal modello e porti la tua chiave, il che significa che il silenzio più comune non ha nulla a che fare con OpenClaw. Quattro guasti lato fornitore producono un assistente che smette di rispondere, e dalla finestra della chat sono indistinguibili:

• La chiave non è valida o è stata ruotata. Le chiavi vengono revocate, rigenerate e incollate con uno spazio finale. Incollala di nuovo invece di leggerla e decidere che sembra giusta.
• Il saldo crediti è vuoto. Gli account a consumo smettono di servire richieste nel momento in cui il saldo finisce, senza alcun avviso dentro il tuo assistente.
• Sei soggetto a un rate limit. I nuovi account di ogni grande fornitore stanno su livelli a basso numero di richieste al minuto. Una raffica di messaggi, o un ciclo di agente che chiama il modello ripetutamente, raggiungerà quel tetto e ogni richiesta respinta non restituisce nulla di utile alla chat.
• Il nome del modello non esiste più. I fornitori ritirano gli identificativi dei modelli, e una configurazione scritta mesi fa può puntare a qualcosa che nel frattempo è stato ritirato. La richiesta fallisce come modello non valido invece che come chiave non valida, il che è facile da leggere male.

Controlla la dashboard del fornitore: le pagine di utilizzo, fatturazione e rate limit ti dicono in pochi secondi quale dei quattro hai, e tutti e quattro si risolvono lì e non in OpenClaw.

Livello 3: l'integrazione di chat

Se l'interfaccia web risponde e il bot no, il messaggio non arriva mai. Ogni piattaforma ha una causa dominante, e vale la pena conoscerle per nome.

Telegram: Privacy Mode

I bot creati tramite BotFather hanno la Privacy Mode attiva per impostazione predefinita. In un gruppo, un bot in quello stato riceve solo i messaggi che iniziano con un comando slash, o che rispondono o menzionano direttamente il bot. Tutto il resto non viene mai consegnato al tuo server, quindi il tuo assistente non sta ignorando nessuno: semplicemente non l'ha mai sentito. Ecco perché lo stesso bot risponde perfettamente ai messaggi diretti e sembra morto in un gruppo.

Per risolvere, scrivi a BotFather, apri le Bot Settings del tuo bot e disattiva Group Privacy. Poi rimuovi il bot dal gruppo e aggiungilo di nuovo, perché l'impostazione viene applicata quando il bot entra.

Discord: il Message Content Intent

Dal 2022 Discord considera il testo dei messaggi un dato privilegiato. Un bot senza il Message Content Intent abilitato si connette comunque, risulta comunque online e riceve eventi di messaggio con il campo del contenuto vuoto. Il risultato è un bot chiaramente in esecuzione che non reagisce assolutamente a nulla.

Abilitalo nel Discord Developer Portal, sotto la tua applicazione, Bot, Privileged Gateway Intents, poi riavvia l'integrazione. Già che ci sei, verifica che il bot abbia il permesso di leggere e inviare messaggi nello specifico canale: le impostazioni a livello di canale battono silenziosamente i ruoli a livello di server, e un bot con permessi di server può comunque essere muto in una stanza.

WhatsApp: la sessione

Le connessioni WhatsApp sono legate a una sessione collegata e non a un token permanente, e le sessioni scadono, vengono disconnesse dal telefono o si interrompono quando il dispositivo resta offline per un lungo periodo. Un'integrazione WhatsApp silenziosa è molto spesso una sessione che va ricollegata. Riscansiona il codice e ritesta prima di cercare altrove.

Tutte le piattaforme: il token stesso

Qualunque sia la piattaforma, conferma che il token nella tua dashboard sia quello attuale. Rigenerare il token di un bot nella console della piattaforma invalida subito quello vecchio, ed è molto facile rigenerare un token mentre stai indagando su altro e dimenticare di incollare quello nuovo.

Livello 4: il percorso di rete

Se raggiungi OpenClaw tramite Tailscale, l'assistente può essere perfettamente in salute mentre tu semplicemente non riesci ad arrivarci. Le chiavi di autenticazione scadono, e anche le chiavi dei dispositivi scadono, quindi un'istanza rimasta in esecuzione indisturbata per mesi può sparire dalla tua tailnet senza che nulla sia fallito. Controlla la console di amministrazione di Tailscale e conferma che il dispositivo sia ancora elencato e autorizzato. Se non lo è, genera una nuova chiave di autenticazione e ridistribuisci o ricollega.

Questo livello spiega uno schema altrimenti confuso: il bot continua a rispondere in chat mentre tu non riesci a raggiungere l'interfaccia web. L'istanza è a posto e in esecuzione; è solo la tua strada verso di essa a essere sparita.

Risponde, ma male

Una risposta lenta o troncata è un problema diverso dal silenzio e di solito dipende da una di due cose. Le conversazioni lunghe finiscono per superare la finestra di contesto del modello, e a quel punto le richieste iniziano a fallire o l'assistente perde la parte iniziale del filo. Avviare una conversazione nuova è la soluzione immediata. Separatamente, un modello locale grande su hardware modesto è semplicemente lento, e una risposta che richiede un minuto può andare in timeout da qualche parte nella catena prima di essere consegnata. Se ti serve velocità su un'istanza piccola, un modello ospitato batterà uno locale ogni volta.

La checklist dei cinque minuti

1. Invia un messaggio nell'interfaccia web di OpenClaw. Una risposta lì significa che il problema è l'integrazione; nessuna risposta significa che è l'istanza, il fornitore o la tua strada verso di essa.
2. Controlla l'istanza nella tua dashboard Flux per un ciclo di riavvii, e controlla la RAM se usi un modello locale.
3. Controlla la dashboard del fornitore del modello per una chiave non valida, un saldo vuoto, un rate limit o un nome di modello ritirato.
4. Per Telegram, disattiva la Privacy Mode in BotFather e riaggiungi il bot al gruppo.
5. Per Discord, abilita il Message Content Intent e verifica i permessi a livello di canale.
6. Per WhatsApp, ricollega la sessione.
7. Se l'interfaccia web non è raggiungibile ma la chat funziona ancora, controlla in Tailscale se un dispositivo o una chiave di autenticazione è scaduta.

Quasi ogni caso si chiude al passo uno, tre o quattro. Lo schema da tenere a mente è che un assistente self-hosted ha più parti in movimento di uno SaaS proprio perché sono tue, e possederle significa che il guasto è sempre individuabile.

Letture correlate

Non hai ancora mai fatto girare uno di questi? Parti dalla guida al self-hosting di OpenClaw, oppure leggi come scegliere un modello AI se stai valutando un fornitore ospitato rispetto a uno locale. Per le integrazioni in sé, vedi Telegram, Discord e WhatsApp.