OpenClaw non risponde

Un agente OpenClaw che resta lì fermo è la lamentela più comune dopo i costi, e la diagnosi è quasi sempre una di otto cose. Il progetto upstream ora include un flusso di triage che ti porta a una diagnosi in circa due minuti. Eccolo in parole semplici, seguito dalle cause che riempiono i forum e da cosa cambia quando è qualcun altro a gestire il Gateway per te.

I primi sessanta secondi

Percorri la scala in ordine: triage, status, gateway probe, gateway status, doctor, channels probe, poi segui i log. Un sistema in salute si presenta così: raggiungibile, runtime in esecuzione, sonda di connettività ok, nessun errore bloccante di doctor e ogni canale che segnala un trasporto attivo. Il comando triage scrive una diagnosi ripulita dai dati sensibili che puoi passare a un agente, a un forum o al supporto.

I soliti sospetti

• Abbinamento in sospeso: un mittente sconosciuto gli ha scritto e nessuno ha approvato la richiesta, quindi lo ignora per scelta progettuale. La versione in produzione è un Gateway bloccato in un loop di riconnessione che richiede l’abbinamento.
• Filtro per menzione in un gruppo: scarta i messaggi del gruppo finché non viene menzionato, e lo dice nei log.
• Un elenco degli autorizzati che non corrisponde: il mittente, il canale o il modello è filtrato dalla policy. Un modello che non è nell’elenco degli autorizzati fa fallire in silenzio i job cron e i sub-agent.
• Il profilo degli strumenti: un profilo minimal non consente quasi nulla, quindi risponde ma non può agire.
• Il provider: un rate limit, una credenziale scaduta come un token di test di Google OAuth, o un rifiuto, visibili nei log come un 429 o un 403.
• Un errore di consegna che sembra un errore del job: un job cron segnato come fallito con un 401 lato Telegram o lato gateway, mentre il lavoro in sé è andato a buon fine.
• Un plugin o un canale disattivato dopo un aggiornamento: l’assistente è in esecuzione, ma la porta da cui rispondeva è chiusa.
• Il Gateway stesso: fermo, in riavvio o terminato per mancanza di memoria su un host piccolo.

Se n’è stato lì per 2 ore senza fare niente.

Lento non vuol dire bloccato

Una risposta che arriva con minuti di ritardo di solito è un modello sovraccarico, un contesto lungo che viene riletto o un turno di heartbeat che occupa la sessione. La guida all’heartbeat di OpenClaw spiega quest’ultimo caso, e perché è anche il motivo per cui un agente inattivo non è mai del tutto inattivo.

Cosa cambia su un host gestito

La scala qui sopra presuppone una shell sulla macchina. Su Diali non c’è nessuna macchina: il feed delle attività mostra provisioning, aggiornamenti ed eventi dei canali, la dashboard offre pausa, riavvio e reinstallazione, e il Gateway viene monitorato per te. Abbinamento, elenchi degli autorizzati e profilo degli strumenti restano da impostare a te, perché sono policy, non tubature. La pagina sull’hosting OpenClaw di Diali descrive il resto.

Prima di scrivere su un forum

• Esegui triage e allega il suo output: è la prima cosa che ti chiederà chiunque voglia aiutarti.
• Controlla l’abbinamento e il filtro per menzione prima di ricollegare qualsiasi cosa.
• Cerca nei log le tre firme: mention required, pairing request, blocked.
• Se è lento anziché muto, guarda prima il provider e l’heartbeat.

E se in tutto questo la parola Gateway è la parte che non hai mai capito, trovi la spiegazione nella guida al Gateway di OpenClaw.