OpenClaw 2.0 spiegato: funzionalità, guida all'installazione & rischi dell'aggiornamento

TLDR: OpenClaw 2.0 (tag di versione v2026.8.1, rilasciata a fine 30 agosto / inizio 31 agosto 2026) è il più grande aggiornamento nella storia dell’agente open-source OpenClaw.

Realizzata da 933 contributor (569 alla prima partecipazione) con oltre 16.000 pull request—circa la metà di tutte le PR mai fuse nel progetto—semplifica l’onboarding, ricostruisce la Control UI del browser in un’esperienza chat-first, introduce sessioni cloud condivise “multiplayer”, consolida la memoria, migliora competenze e controlli di sicurezza e tocca quasi ogni sottosistema.

L’installazione è ora drasticamente più semplice grazie al rilevamento guidato di abbonamenti ChatGPT/Claude già esistenti, chiavi API e modelli locali. L’upgrade comporta rischi reali ma gestibili (migrazione delle sessioni SQLite, rimozione di plugin, rinomina delle route dei modelli). Per ambienti di produzione o flessibilità multi-modello, affiancare OpenClaw a un gateway unificato come CometAPI (una chiave per oltre 500 modelli a tariffe competitive) è una raccomandazione pratica.

Key Takeaways

OpenClaw 2.0 non è un salto tradizionale di semantic versioning, ma un’etichetta “2.0” basata sulla scala per il più grande rilascio consolidato dopo quasi sette settimane di lavoro mirato, in seguito a 106 release nei precedenti 230 giorni.
Progressi principali: configurazione quasi zero per la prima esecuzione, app browser ricostruita e chat-first con Session Rail e widget, sessioni cloud condivise (“multiplayer”), memoria integrata con consolidamento in background e autoapprendimento, Skill Workshop e modelli di permessi e credenziali più solidi (sebbene non induriti di default).
L’installazione è più semplice tramite gli script ufficiali (curl ... | bash o equivalente PowerShell); esistono app companion desktop per Windows e macOS.
L’upgrade richiede un backup verificato; tre principali migrazioni (sessioni SQLite, rimozione di OpenProse, codex/* → openai/*) sono gestite in gran parte da openclaw doctor --fix. I primi problemi post-release si sono concentrati su esecuzioni non interattive del doctor.
La sicurezza resta responsabilità dell’operatore: le sessioni condivise sono controlli di collaborazione (non isolamento tra tenant), la Secret Store non è cifrata a riposo di default e il sandbox è disattivato di default—i critici hanno evidenziato queste lacune.
Per flessibilità dei modelli, controllo dei costi e ridondanza, configurare OpenClaw con CometAPI come provider personalizzato (supporta formati OpenAI-compatible, Anthropic-messages e Google con un’unica chiave).

Che cos’è OpenClaw?

OpenClaw è un agente AI autonomo/assistente personale gratuito, open-source (Licenza MIT), self-hosted, che gira principalmente sull’hardware dell’utente (macOS, Linux, Windows, con WSL2 raccomandato su Windows). Diversamente da chatbot puri come ChatGPT che vivono in una scheda del browser e suggeriscono soltanto azioni, OpenClaw esegue compiti reali: gestisce file, controlla browser, invia messaggi su WhatsApp, Telegram, Slack, Discord, Signal, iMessage e altri canali, automatizza workflow e mantiene una memoria persistente.

È nato alla fine del 2025 (inizialmente come Warelay/progetti correlati) sotto Peter Steinberger e la community, è stato rebrandizzato e open-sourcizzato ed è ora gestito dalla OpenClaw Foundation. L’architettura ruota attorno a un Gateway locale (control plane per sessioni, strumenti, eventi e canali), una Control UI/CLI/TUI, plugin di canali di messaggistica e app companion opzionali. I modelli possono essere hosted (OpenAI, Anthropic, Google, ecc.), basati su abbonamento o completamente locali (Ollama, LM Studio, llama.cpp). Stato e credenziali restano sotto il controllo dell’utente.

A metà 2026 il progetto spediva a ritmo serrato—106 release in circa 230 giorni—prima di fermarsi quasi sette settimane per consolidare il lavoro fondativo. Da quella pausa è nato OpenClaw 2.0.

Vedi anche Top 6 OpenClaw Skills you can't afford to miss in 2026

Le principali novità di OpenClaw 2.0

Installazione e onboarding semplificati e guidati

Il setup per la prima volta ora rileva le risorse già presenti sulla macchina: login/abbonamenti esistenti a ChatGPT, Claude o Codex, chiavi API e modelli locali idonei (Ollama, LM Studio). L’installer verifica che il modello scelto possa effettivamente completare una richiesta prima di salvare le credenziali, quindi sposta la maggior parte della configurazione residua fuori dalla procedura iniziale. Gli utenti arrivano più rapidamente alla prima conversazione e completano la configurazione parlando direttamente con l’agente.

I setup orientati a OpenAI tendono verso modelli recenti (le coperture menzionano predefiniti GPT-5.6 in alcuni punti); i percorsi locali sono migliorati (ad es. llama-server hosted che sostituisce i vecchi percorsi node-llama-cpp, lunghezze di contesto predefinite più elevate).

Control UI nel browser ricostruita (esperienza chat-first)

L’app browser è stata ricostruita come superficie di prima classe. Si apre direttamente in una conversazione. La vecchia pagina Overview è stata rimossa; le sessioni vivono in una sidebar. File, approvazioni, terminali, diff git e un pannello del browser agganciabile affiancano la chat. Una “Session Rail” fornisce stato live compatto (progresso, valutazioni, passi del piano, pull request). Widget interattivi possono essere fissati alle dashboard di sessione, ricevere azioni in scope o origini di rete, ed essere esportati. Le prestazioni in ambienti simulati includono la riduzione delle richieste JavaScript (140 → 45) e avvii più rapidi (~1,6 s → ~575 ms).

Sessioni cloud condivise (“Multiplayer”)

La funzionalità di collaborazione di punta: più utenti possono unirsi alla stessa sessione di agente in corso con contesto completo, assegnare compiti, suggerire modifiche, lavorare in modalità bozza o partecipare a pieno. I livelli di accesso sono controllabili da proprietari/amministratori. Il team OpenClaw utilizza ora questa modalità per costruire OpenClaw. Le sessioni possono girare sul Gateway locale, su dispositivi accoppiati (openclaw connect) o su macchine cloud usa e getta tramite strumenti di provisioning (AWS, Hetzner, ecc.). Importante avvertenza del progetto: questi sono controlli di collaborazione, non confini di isolamento tra tenant ostili né confini di sicurezza a livello di rete/filesystem.

Consolidamento del sistema di memoria

La Memory integrata ora gestisce core search e recall (l’add-on QMD è ritirato tramite migrazione supportata). Il consolidamento in background (“grounded dreaming”) promuove materiale con provenienza qualificata in memoria a lungo termine (con un Dream Diary e un interruttore esplicito per disattivarlo). L’autoapprendimento può trasformare solide lezioni riutilizzabili in competenze proposte. È disponibile la ricerca full-text nelle conversazioni. Esistono controlli espliciti come openclaw memory forget. Le sessioni persistono più durevolmente su periodi di inattività e oltre i cambi di giornata di default.

Uno Skill Workshop fornisce un percorso guidato per creare, convalidare, installare, chiamare e revisionare skill, con cronologia applicata e segnalazione individuale delle skill non valide al posto di rotture del catalogo. Le automazioni possono restare collegate alla conversazione che le ha create; le azioni ricorrenti possono usare un’approvazione one-time. Plugin IMAP possono innescare lavoro dell’agente da email in arrivo. Widget interattivi e schede di progresso durevoli trasformano la UI in una vera superficie di controllo.

Miglioramenti al modello di sicurezza e permessi

Le approvazioni ora si legano più strettamente alla richiesta esatta, al comando, alla sessione e alla persona. I permessi riutilizzabili per i comandi possono legarsi ad argomenti esatti e directory di lavoro; i comandi basati su script ricontrollano i byte revisionati. Le sessioni supportano modalità esplicite: read-only, guarded, workspace o full access. Un archivio credenziali di team mantiene certi valori segreti scrivibili soltanto; gli agenti possono richiedere credenziali tramite prompt mascherati che non entrano mai nel testo visibile al modello. L’installazione di plugin da fonti eseguibili arbitrarie richiede un flag di forza esplicito. Questi sono passi significativi dopo precedenti advisory di sicurezza, ma i critici notano lacune residue (dettagliate nella sezione rischi).

Altri cambiamenti degni di nota

Espansioni dei modelli e dei provider e pulizie delle route
Aggiornamenti alle app native e ai companion
Modifiche al backend di storage che supportano il nuovo modello di sessione
Estese correzioni di bug e interventi di affidabilità su canali e strumenti

Come installare OpenClaw 2.0

Requisiti di sistema

Node.js 22.22.3+, 24.15+ o 25.9+ (Node 26 consigliato; gli installer spesso forniscono una versione adeguata)
macOS, Linux o Windows (WSL2 fortemente raccomandato per il Gateway su Windows)
Opzionale: pnpm se si compila da sorgente

Companion desktop:

Windows Hub (installer firmati per x64/arm64)
App per macOS nella barra dei menu (DMG/ZIP dalle release GitHub)

Consigliato: script di installazione ufficiale

macOS / Linux / WSL2:

curl -fsSL https://openclaw.ai/install.sh | bash

Windows (PowerShell):

iwr -useb https://openclaw.ai/install.ps1 | iex

Lo script rileva l’OS, installa Node se necessario, installa OpenClaw e avvia l’onboarding. Esistono flag per --no-onboard e altre opzioni di automazione.

Metodi alternativi

npm (Node già gestito):

  npm install -g openclaw@latest --allow-scripts=openclaw   # adjust for older npm
  openclaw onboard --install-daemon

Equivalenti pnpm o bun con i flag di trust/allow-build appropriati
Da sorgente (contributor):

  git clone https://github.com/openclaw/openclaw.git
  cd openclaw
  corepack enable
  pnpm install && pnpm build && pnpm ui:build
  pnpm add --global "openclaw@link:$PWD"
  openclaw onboard --install-daemon

Un installer con prefisso locale e opzioni container/VPS sono documentati per deploy avanzati.

Verifica post-installazione

openclaw --version
openclaw doctor
openclaw gateway status
openclaw dashboard   # or open http://127.0.0.1:18789/ on the gateway host

L’avvio gestito usa LaunchAgents (macOS), servizi utente systemd (Linux/WSL2) o Scheduled Tasks (Windows nativo). I dettagli completi si trovano nella documentazione ufficiale di installazione.

Percorso di upgrade e rischi

Checklist pre-upgrade

Crea un backup verificato della directory di stato di OpenClaw, configurazioni, sessioni e di eventuali plugin/skill personalizzati.
Rivedi le note di rilascio ufficiali (docs.openclaw.ai/releases/2026.8.1) e le guide di aggiornamento.
Preferisci un terminale interattivo (TTY) per i passaggi di upgrade e doctor—prime segnalazioni hanno mostrato che doctor --fix non interattivo poteva saltare silenziosamente le migrazioni 2.0.

Migrazioni note e breaking changes

Change	Impact & Action
Sessions & transcripts → SQLite	Le nuove sessioni dopo la migrazione non appariranno nelle release più vecchie in caso di downgrade. Esegui prima un backup.
Bundled OpenProse plugin & /prose command removed	Esegui openclaw doctor --fix; segui la migrazione allo Skill dell’upstream Agent. I file .prose esistenti sono conservati.
codex/* and openai-codex/* model refs → openai/*	openclaw doctor --fix migra route, configurazioni provider, sessioni archiviate e automazioni. I conflitti sono segnalati.
Plugin SDK subpath deprecations	Gate al 1° settembre 2026; aggiorna i plugin secondo la guida di migrazione dell’SDK.

La maggior parte della pulizia è gestita da openclaw doctor --fix (o --repair). Dopo l’upgrade, rivaluta le modalità di permesso per sessione (preferisci il minimo privilegio) e riapplica qualsiasi checklist di hardening da advisory precedenti.

Problemi post-release iniziali (alla fine del 31 agosto)

doctor --fix che saltava migrazioni senza TTY (P1, correzione segnalata rapidamente)
Problemi di sync della memoria con alcuni provider di embedding (ad es., limiti batch di Gemini)
Persistenza del consenso dei plugin su installazioni legacy
Falsi positivi di readiness della dashboard

Un rilascio di questa portata vede tipicamente patch successive; monitora il tracker ufficiale e le note di rilascio.

Rischi di sicurezza evidenziati dalla copertura

The Register e altri hanno notato che, sebbene l’usabilità sia migliorata drasticamente, “security by default” non l’ha accompagnata completamente:

I controlli sulle sessioni condivise non sono isolamento a livello di rete o filesystem / confini tra tenant.
I valori della Secret Store (password, chiavi API) non sono cifrati a riposo; si affidano ai permessi del filesystem della directory di stato.
Il sandbox per isolare codice non affidabile non è abilitato di default.

Analisi precedenti del 2026 (pre-2.0) avevano già documentato rischi legati a credenziali in chiaro, prompt injection che porta ad azioni distruttive, CVE di alta severità e problemi di supply-chain nel marketplace delle skill (ClawHub). La 2.0 rafforza il binding delle approvazioni e le modalità di permesso, ma gli operatori restano responsabili di configurazioni a minimo privilegio, isolamento di rete, gestione dei segreti e attivazione del sandbox. Concedere a un agente capace ampio accesso al sistema e alle credenziali non dovrebbe mai essere preso alla leggera.

Tabella di confronto: OpenClaw Pre-2.0 vs OpenClaw 2.0

Aspect	Pre-2.0 (typical 2026 mid-year)	OpenClaw 2.0 (v2026.8.1)
Installation	Prima esecuzione più configurabile	Rilevamento guidato di chiavi/abbonamenti/modelli locali; completamento guidato dalla chat
Browser / Control UI	Overview-centrica, meno integrata	Chat-first, Session Rail, widget, pannelli agganciabili
Collaboration	Principalmente singolo utente/local	Sessioni cloud condivise con partecipazione basata su ruoli
Memory	Divisa / QMD add-on comune	Integrata e consolidata + consolidamento in background + autoapprendimento
Skills	Più ad-hoc	Skill Workshop, validazione, cronologia
Session storage	Formato precedente	SQLite (migrazione richiesta)
Security model	In miglioramento ma policy-heavy	Binding delle approvazioni più stretto, modalità di sessione esplicite, segreti write-only (default dipendenti dall’operatore)
Scale of release	Piccole uscite frequenti	~50% di tutte le PR storiche in un unico drop consolidato

Come alimentare OpenClaw con CometAPI: integrazione raccomandata

OpenClaw è model-agnostic. Puoi puntarlo a chiavi provider ufficiali, modelli locali o a un gateway unificato. Per team e power user che desiderano una sola chiave API, accesso a 500+ modelli (famiglia GPT, famiglia Claude, Gemini e molti altri), prezzi competitivi (spesso 20%+ sotto listino), switching semplice e osservabilità centralizzata, CometAPI è una scelta naturale. CometAPI fornisce endpoint OpenAI-compatible, Anthropic-messages e Google-generative-ai sotto un’unica credenziale.

Tutorial di cinque minuti per configurare OpenClaw con CometAPI

Ottieni una chiave CometAPI da cometapi.com.
Conservala in modo sicuro (ad es., COMETAPI_KEY in ~/.openclaw/.env con permessi ristretti, o il tuo secret manager preferito).
Modifica ~/.openclaw/openclaw.json (o equivalente) per aggiungere provider, ad esempio:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "cometapi-claude/claude-sonnet-4-6"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "cometapi-openai": {
        "baseUrl": "https://api.cometapi.com/v1",
        "apiKey": "${COMETAPI_KEY}",
        "api": "openai-completions",
        "models": [{ "id": "gpt-5.4", "name": "GPT-5.4" }]
      },
      "cometapi-claude": {
        "baseUrl": "https://api.cometapi.com",
        "apiKey": "${COMETAPI_KEY}",
        "api": "anthropic-messages",
        "models": [{ "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }]
      },
      "cometapi-google": {
        "baseUrl": "https://api.cometapi.com/v1beta",
        "apiKey": "${COMETAPI_KEY}",
        "api": "google-generative-ai",
        "models": [{ "id": "gemini-3.1-pro-preview", "name": "Gemini 3.1 Pro" }]
      }
    }
  }
}

(Gli ID modello e i percorsi esatti vanno verificati con la documentazione corrente di CometAPI e OpenClaw, dato che i cataloghi evolvono.) Usa riferimenti completi provider/model nelle sessioni. Dopo le modifiche, riavvia il Gateway e verifica con una conversazione di test.

Questa configurazione ti consente di sperimentare diversi modelli di frontiera e a costo efficiente senza gestire più account vendor, mantenendo intatto il control plane self-hosted di OpenClaw. Guide dettagliate sono disponibili nelle pagine di integrazione CometAPI per OpenClaw.

Raccomandazioni pratiche e best practice

Inizia con lo script guidato e la nuova UI del browser per arrivare più rapidamente a un agente utile.
Considera le sessioni condivise come una funzionalità di collaborazione solo tra parti fidate; aggiungi ulteriore isolamento di rete e host se esistono preoccupazioni multi-tenant.
Abilita sempre la modalità di permesso più ristretta per sessione e abilita il sandbox per skill/codice non affidabili dove disponibile.
Esegui un backup prima di ogni major upgrade; esegui il doctor in modo interattivo dopo release della scala di 2.0.
Per workload multi-modello o sensibili al costo, instrada tramite un gateway come CometAPI invece di gestire molte chiavi individuali.
Monitora le note di rilascio ufficiali, il tracker GitHub e gli advisory di sicurezza—la velocità di OpenClaw significa che funzionalità e fix arrivano rapidamente.
Ricorda l’impostazione del progetto: OpenClaw è open source e “tuo” da plasmare e possedere. La release 2.0 abbassa la barriera alla prima workflow utile, ampliando al contempo il potenziale per team e uso continuo.

Domande frequenti (FAQ)

Qual è il numero di versione esatto di OpenClaw 2.0?

Il tag di rilascio è v2026.8.1 (fine 30 agosto / 31 agosto 2026). Il progetto e la community lo chiamano OpenClaw 2.0 per la sua scala senza precedenti.

OpenClaw 2.0 è un upgrade con breaking changes?

Per lo più additivo, ma tre migrazioni deliberate (sessioni SQLite, rimozione OpenProse, rinomina delle route dei modelli) richiedono attenzione. openclaw doctor --fix gestisce la maggior parte del lavoro se eseguito correttamente.

Quanto dura un’installazione tipica?

Con lo script ufficiale e accessi AI già presenti, molti utenti arrivano alla prima conversazione in pochi minuti. La configurazione completa può continuare in modo conversazionale.

Posso ancora usare modelli locali?

Sì. Ollama, LM Studio e percorsi migliorati per llama.cpp/llama-server sono supportati e rilevati durante il setup guidato.

OpenClaw è gratuito?

Il software è sotto licenza MIT ed è gratuito. I costi derivano dai fornitori LLM (o dal compute locale) scelti. Gateway come CometAPI possono ridurre i costi effettivi dei modelli.

Le aziende dovrebbero usare subito la funzionalità di sessioni condivise?

Solo tra partecipanti reciprocamente fidati e dopo aver rivisto le dichiarazioni esplicite di non-isolamento nella documentazione. Combina con controlli a livello di host e rete.

Dove trovo note di rilascio e documentazione ufficiali?

Fonti primarie: blog openclaw.ai, docs.openclaw.ai (inclusa la pagina della release 2026.8.1 e le guide di installazione/aggiornamento) e il repository GitHub github.com/openclaw/openclaw.

Come cambio modelli o provider dopo l’installazione?

Modifica la configurazione (o parla con l’agente per completare il setup), riavvia il Gateway e verifica. Provider personalizzati come CometAPI si integrano facilmente tramite la struttura models.providers.

OpenClaw 2.0 rappresenta un punto di maturazione per la categoria degli agenti self-hosted: attrito drasticamente ridotto per iniziare, funzionalità di continuità e collaborazione più ricche e primitive di sicurezza più chiare (sebbene ancora a carico dell’operatore). Che tu sia un individuo in cerca di un agente personale persistente o un piccolo team che esplora workflow di agenti multiplayer, la release 2.0 è il miglior punto di partenza offerto finora dal progetto. Abbinandola a un’attenta igiene dei permessi e, dove conta la flessibilità multi-modello, a un layer API unificato come CometAPI, ottieni una base potente e “di proprietà” per lavoro reale.

Verifica sempre la documentazione ufficiale più recente prima di una messa in produzione, poiché il progetto continua a evolvere rapidamente.