OpenClaw 2.0 — O Que Mudou Realmente na Maior Actualização do Agente Open-Source
A versão 2026.8.1, promovida como OpenClaw 2.0, representa a maior actualização desde o lançamento do projecto. Com 933 contribuidores (569 pela primeira vez), mais de 16 000 pull requests acumulados e mudanças estruturais profundas — da migração do armazenamento para SQLite às novas protecções de segredos — esta release redefine a forma como o agente é instalado, operado e escalado. Neste artigo, detalhamos o que mudou, por que razão importa, e o que deves saber antes de fazer o upgrade.
stable. Para actualizar: openclaw update --channel stable. Recomendamos ler a secção de riscos de upgrade antes de actualizar instalações existentes.
Porquê Chamar-lhe OpenClaw 2.0?
O número de versão semântico é 2026.8.1, mas a equipa decidiu adoptar a designação OpenClaw 2.0 para reflectir a escala da mudança. Não se trata de uma actualização incremental: a arquitectura interna do armazenamento foi reestruturada, a experiência de instalação foi reescrita de raiz, a interface de browser foi completamente reconstruída, e os mecanismos de segurança de segredos receberam um modelo novo. Os 933 contribuidores e 16 000+ pull requests traduzem meses de trabalho paralelo que convergiu nesta release — uma dimensão invulgar para qualquer projecto open-source, e sem precedentes no ecossistema OpenClaw.
| Área | Mudança Principal | Impacto |
|---|---|---|
| Armazenamento | Sessões e transcrições migram de ficheiros para SQLite | Muito Alto |
| Instalação | Experiência inicial simplificada e guiada | Alto |
| Interface Browser | Aplicação web completamente reconstruída | Alto |
| Segredos | Associação a hosts HTTPS + bloqueio de texto simples | Muito Alto |
| Modelos | Suporte GPT-5.6 + troca de runtime OpenClaw/Codex | Alto |
| Sessões | Sessões partilhadas entre utilizadores | Médio |
Migração para SQLite: O Coração da Mudança
A alteração mais profunda do OpenClaw 2.0 é a migração do armazenamento de sessões e transcrições de ficheiros individuais para uma base de dados SQLite. Nas versões anteriores, cada sessão de conversa era guardada como um ficheiro JSON separado no disco — um modelo simples que funcionou bem nas primeiras fases do projecto, mas que se tornava cada vez mais problemático à medida que as instâncias acumulavam centenas ou milhares de sessões.
O Que Muda na Prática
.db substitui centenas ou milhares de ficheiros JSON. Backups tornam-se mais previsíveis e transportáveis.
Impacto em Backups e Portabilidade
O modelo anterior permitia copiar ficheiros individuais entre instâncias com um simples cp. Com SQLite, a migração de dados entre máquinas continua possível — o ficheiro .db é portável — mas scripts que dependiam da estrutura de directórios anterior precisam de ser adaptados. A equipa disponibiliza um utilitário de exportação para JSON legacy:
openclaw sessions export --format json --output ./backup/# Importar sessões de uma instalação anterior:
openclaw sessions import --from ./old-sessions/
Para backups automatizados, a recomendação oficial é usar a ferramenta .backup do SQLite ou um snapshot do ficheiro openclaw.db com o agente parado (ou em modo read-only), garantindo consistência total.
Nova Experiência de Instalação
A configuração inicial do OpenClaw era historicamente um dos maiores pontos de fricção para novos utilizadores. O 2.0 substitui o anterior processo manual — editar ficheiros YAML, configurar providers à mão, resolver dependências — por uma experiência guiada e interactiva que conduz o utilizador desde a primeira execução até um agente funcional.
O comando openclaw init abre agora um assistente que pergunta: que modelo queres usar? Tens API key? Queres ligar a WhatsApp, Telegram ou Discord? O resultado é um ficheiro de configuração completo sem tocar num editor de texto.
O instalador detecta o sistema operativo, verifica versões de Node.js e Docker, e sugere a configuração mais adequada. Se estiveres em macOS com Apple Silicon, optimiza automaticamente para ARM; se estiveres numa VPS Linux, configura o modo headless.
Após a configuração, o setup testa a conectividade com o provider de modelo escolhido e confirma que o agente está operacional — tudo antes de sair do assistente.
O objectivo é claro: reduzir o tempo entre quero experimentar e está a funcionar de dezenas de minutos para menos de cinco. Para quem já opera instâncias existentes, o assistente não interfere — a configuração manual via YAML continua disponível.
Interface de Browser Reconstruída
A aplicação web do OpenClaw foi reescrita de raiz. A versão anterior, funcional mas espartana, dá lugar a uma interface moderna com as seguintes melhorias:
A reconstrução da interface não é apenas cosmética. O backend da aplicação web utiliza agora as queries SQLite directamente, o que elimina a latência de leitura de ficheiros e permite funcionalidades como pesquisa full-text e ordenação por múltiplos critérios que antes seriam impraticáveis.
Protecções de Segredos: Host-Binding e Bloqueio de Texto Simples
Uma das adições de segurança mais relevantes do OpenClaw 2.0 é o novo modelo de protecção de segredos partilhados. O problema que resolve é real: em versões anteriores, uma API key configurada no agente podia ser inadvertidamente exposta em logs, transcrições ou respostas — uma preocupação crescente à medida que agentes autónomos operam com menos supervisão humana.
Como Funciona
api.anthropic.com. O agente só envia o segredo para esse host; qualquer tentativa de o utilizar noutro destino é bloqueada.
openclaw secrets set ANTHROPIC_KEY --bind-host api.anthropic.com# Verificar segredos e respectivos bindings:
openclaw secrets list --show-bindings
Esta funcionalidade é particularmente relevante para quem opera agentes com múltiplas API keys de serviços diferentes, ou para equipas que partilham instâncias — limita o risco de exfiltração acidental ou deliberada de credenciais.
Suporte GPT-5.6 e Troca de Runtime OpenClaw/Codex
O OpenClaw 2.0 alarga o suporte para o modelo GPT-5.6 da OpenAI e introduz uma selecção de runtime mais consistente entre OpenClaw e Codex. Na prática, isto traduz-se em duas melhorias concretas:
O GPT-5.6 está disponível como opção directa no selector de modelos, com suporte completo para tool-use, streaming e context windows estendidas. A integração aproveita as capacidades de raciocínio mais longas do 5.6 para tarefas complexas de análise e geração de código.
Para utilizadores que operam tanto com OpenClaw como com Codex (o agente da OpenAI), a v2026.8.1 padroniza a interface de configuração. Perfis de modelo, API keys e preferências de runtime podem ser alternados sem reconfiguração manual — basta seleccionar o runtime desejado por sessão ou por tarefa.
A troca de runtime é particularmente útil para equipas que avaliam diferentes agentes em paralelo, ou para quem usa Codex para tarefas específicas de código e OpenClaw para automação generalista. A configuração unificada reduz a fricção de operar ambos os sistemas.
Workflows Melhorados e Sessões Partilhadas
Além das mudanças estruturais, o OpenClaw 2.0 traz melhorias nos fluxos de trabalho e a introdução de sessões partilhadas:
Riscos de Upgrade: O Que Deves Saber Antes de Actualizar
Uma actualização desta envergadura traz riscos inevitáveis, e a comunidade tem discutido activamente as dificuldades encontradas nas versões beta recentes. Os pontos de atenção mais relevantes:
Migração de dados não é automática para todos os casos
A migração de ficheiros JSON para SQLite é executada automaticamente no primeiro arranque após o upgrade. Contudo, instalações com plugins que lêem directamente da estrutura de ficheiros precisam de ser actualizadas para usar a nova API de sessões. Plugins desactualizados podem não encontrar os dados esperados.
Automações dependentes do modelo de ficheiros
Scripts de backup, ferramentas de análise ou integrações CI/CD que dependiam da estrutura de directórios ~/.openclaw/sessions/*.json vão falhar silenciosamente. Revê todas as automações antes do upgrade.
Configurações herdadas podem gerar avisos
Opções de configuração descontinuadas geram warnings no arranque mas não bloqueiam a execução. A equipa recomenda correr openclaw config validate após o upgrade para identificar e limpar entradas obsoletas.
Recomendações para Um Upgrade Seguro
cp -r ~/.openclaw ~/.openclaw-backup-pre-2.0
openclaw plugins check-compat --target 2.0
openclaw update --channel stable
openclaw config validate && openclaw sessions verify
Para instalações críticas ou de produção, a abordagem mais prudente é testar o upgrade num ambiente de staging antes de aplicar na instância principal. A equipa mantém a versão anterior disponível para rollback durante pelo menos 90 dias.
Conclusão: Uma Base Sólida, Com Cautela
O OpenClaw 2.0 é, sem reservas, a actualização mais ambiciosa do projecto. A migração para SQLite, as protecções de segredos, a nova interface e o suporte alargado de modelos posicionam o agente para cenários de utilização mais exigentes — equipas maiores, instâncias de longa duração, workloads multi-modelo.
Ao mesmo tempo, a escala das mudanças exige cautela. Quem opera instalações com plugins personalizados, automações dependentes do modelo de ficheiros anterior, ou configurações herdadas de versões antigas, deve planear o upgrade com cuidado. O backup prévio e o teste em staging não são opcionais — são a diferença entre uma migração tranquila e uma manhã de debugging.
Para novos utilizadores, o veredito é simples: nunca foi tão fácil começar. Para veteranos, o 2.0 é um investimento que vale a pena — mas que merece ser feito com método.