Chat — Aggiornare OpenClaw / gateway che crasha

Data: 2026-07-14

MSG 1 — Utente

come aggiorno openclaw? dalla ui non riesce

RISPOSTA 1 — Claude

La card "update" della Control UI usa il flusso update.run del gateway: su install gestite come servizio (attività pianificata Windows "OpenClaw Gateway") deve fare un handoff (processo staccato → esce → si fa sostituire → riparte). Se non ci riesce in sicurezza, si ferma. Si aggiorna da terminale:

openclaw update --dry-run
openclaw update            # aggiorna + doctor + riavvio gateway
openclaw doctor
openclaw health
openclaw --version

Se si pianta a metà (dopo la fase npm), swap col gateway spento:

schtasks /end /tn "OpenClaw Gateway"
npm i -g openclaw@latest
openclaw doctor
openclaw gateway restart

Ultima spiaggia: iwr -useb https://openclaw.ai/install.ps1 | iex (aggiorna in place).

Fonti: docs.openclaw.ai/install/updating, docs.openclaw.ai/cli/update

MSG 2 — Utente

non lo so... facciamo una prova a startare il gateway

RISPOSTA 2 — Claude

Il mio terminale è una sandbox Linux separata dal PC, e nei terminali Windows non posso digitare → i comandi li lancia Ettore, io leggo l'output.
Comandi proposti: schtasks /query /tn "OpenClaw Gateway", openclaw gateway status, openclaw gateway (primo piano, per vedere gli errori). Mai due gateway insieme.

MSG 3 — Utente

[output di openclaw gateway start / schtasks query / gateway status / openclaw gateway]

RISPOSTA 3 — Claude

Gateway già in esecuzione e sano: pid 2424, versione 2026.7.1, probe ok, in ascolto su 127.0.0.1:18789, admin-capable.
I due errori erano normali: gateway start aveva già riavviato l'attività pianificata, quindi il successivo openclaw gateway (primo piano) trovava la porta occupata da sé stesso.
Passo successivo proposto: openclaw update status per vedere se c'è davvero una versione più recente.

MSG 4 — Utente

[screenshot] "Control UI did not start — the app bundle did not register the openclaw-app web component. A browser extension or early content script may be blocking module execution." — dalla ui

RISPOSTA 4 — Claude

Non è un crash del gateway: la pagina è stata servita, è il browser che non esegue il bundle JS. Sospetti: Brave Shields / estensioni.
Prove: (1) finestra privata su http://127.0.0.1:18789; (2) scudo Brave → Shields DOWN su 127.0.0.1 → ricarica; (3) prova con Edge.
Chiesto chiarimento: crasha la pagina UI o il gateway? Se il gateway, servono i log:
Get-Content "$env:TEMP\openclaw\openclaw-2026-07-14.log" -Tail 60

MSG 5 — Utente

ogni tanto mi crasha, non capisco cosa stia succedendo
[poi] ora puoi guardare

RISPOSTA 5 — Claude — DIAGNOSI (letta da ~/.openclaw/logs/)

1. L'update era già stato fatto. Oggi alle 16:57 update --json --yes (lanciato dalla card della UI) è riuscito: da 2026.6.11 → 2026.7.1. La UI l'update l'aveva fatto davvero.

2. Cosa "crasha". Alle 17:01 è scattato il crash-loop breaker:

3 unclean boot(s) within 300000ms; suppressing channel/provider account auto-start.

Il gateway è ripartito male 3 volte in 5 minuti → si è messo in sicurezza e ha sospeso l'auto-start dei canali (Telegram, Discord). Il processo è vivo (probe ok) ma i canali no → per questo gateway status chiude con Troubles: run openclaw status.

3. IL PATTERN (già successo, sempre uguale). Storico in ~/.openclaw/logs/stability/:

• 28/06 → channels.discord: must not have additional properties: "botToken"
• 12/07 → channels.discord...channels.*: must not have additional properties: "allow"
• 14/07 → crash-loop breaker dopo l'update

→ Ogni aggiornamento cambia lo schema del config; `openclaw.json` resta con chiavi non più valide e il gateway rifiuta di partire. Non è la VPN, non è un bug misterioso: è il config che invecchia sotto gli update.

FIX standard (funziona):

openclaw status          # elenca i "troubles"
openclaw doctor --lint   # elenca le chiavi di config non valide
openclaw doctor --fix    # migra/ripara
openclaw gateway restart # boot pulito → resetta il breaker, i canali ripartono
openclaw health

Nota: l'update ha disattivato alcune voci in config (tra cui un plugin whisper) → da ricontrollare.

MSG 6 — Utente

dopo i primi comandi funziona, grazie

RISPOSTA 6 — Claude

Risolto. Regola da ricordare: dopo ogni `openclaw update`, lanciare sempre `openclaw doctor --fix` + `openclaw gateway restart` — è quello che evita il crash-loop.
Log di riferimento per la prossima volta: ~/.openclaw/logs/stability/*.json (dice esattamente perché non è partito).
Da ricontrollare: il plugin whisper disattivato dall'update.