OpenClaw 2.0: dá para configurar o agente só conversando com ele?

Configurar um agente inteiro sem abrir arquivo de configuração na mão: é essa a promessa que o OpenClaw 2.0 coloca na mesa

O OpenClaw 2.0 é o nome da versão v2026.8.1, apresentada pelo próprio projeto como a maior atualização da história dele, e o setup conversacional está bem no centro dessa conversa

A ideia é fácil de resumir: você roda um comando, responde umas perguntas no chat e o agente vai escrevendo a configuração conforme você confirma cada coisa

Só que "a conversa resolve tudo" e "a conversa resolve o caminho comum" são coisas bem diferentes, e é exatamente isso que a gente vai separar aqui…

O que mudou no OpenClaw 2.0 e por que o setup encolheu

Primeiro o tamanho da coisa: a versão foi construída por 933 contribuidores, sendo 569 de primeira viagem, somando mais de 16.000 pull requests

Se quiser ver o anúncio na fonte, ele está nas notas da release v2026.8.1

O ponto de partida declarado do 2.0 era bem mais modesto: simplificar a instalação e reconstruir o app de navegador

Aí a limpeza acabou se espalhando pelo resto do produto, e o que era faxina virou reescrita ampla

O que o onboarding passou a fazer sozinho:

O onboarding do 2.0 detecta acessos que já existem na sua máquina: login existente do Claude Code ou do Codex CLI, chaves de API e modelos locais

Com isso ele encurta a configuração inicial, porque metade das perguntas some quando o acesso já está ali

O fluxo guiado é conduzido pelo Custodian, com option cards estruturados e controles nativos de setup, então não é aquele chat solto onde você tem que adivinhar o que digitar

E o 2.0 não parou no setup: entraram sessões compartilhadas na nuvem, onde outras pessoas entram numa sessão em andamento e seguem o trabalho de onde parou, e o modelo de segurança foi ampliado com sandbox mais forte, permissões por papel, controles de aprovação, tratamento de segredos e auditoria

Pra quem monta o agente pela primeira vez, essa parte de aprovação e auditoria é o que faz o "configurar conversando" não virar terra sem lei 🙂

O que você precisa ter antes de abrir o chat de setup

Antes de sair digitando comando, três coisas precisam estar de pé

• A CLI do OpenClaw instalada na máquina
• Algum acesso a modelo: login do Claude Code, login do Codex CLI, chave de API ou um modelo local
• O Gateway rodando, se você quiser usar o dashboard

Com o Gateway na mesma máquina, o dashboard abre em http://127.0.0.1:18789/ (ou http://localhost:18789/)

Se você for de chave de API, vale entender antes onde o plano gratuito trava, porque descobrir isso no meio do setup é chato demais

Onde a configuração vive:

A configuração fica em ~/.openclaw/openclaw.json

O Gateway observa esse arquivo e aplica as mudanças automaticamente na maioria dos ajustes, sem restart manual

Já o workspace padrão do agente é ~/.openclaw/workspace, criado junto com os arquivos iniciais no onboarding ou na primeira execução do agente

É de lá que o OpenClaw lê instruções de operação e memória, então guarda esse caminho

Tome cuidado! O Control UI é uma superfície administrativa (chat, config, aprovações de execução), e a documentação orienta não expor isso publicamente

Como configurar o OpenClaw 2.0 conversando, passo a passo

Bora ver na prática?

A sequência abaixo é o caminho comum de quem está montando o agente pela primeira vez, com o erro clássico de cada etapa

1. Abra o setup conversacional

openclaw setup

Esse comando roda o setup conversacional: um chat com o agente de sistema, sem inferência, com fallback para o onboarding

Ele serve tanto pra configurar do zero quanto pra reparar depois

O erro comum deste passo: achar que openclaw setup é só pra primeira instalação e ficar procurando outro comando quando algo quebra

2. Aceite o risco e dê nome ao primeiro agente

O onboarding interativo pergunta como você quer chamar o primeiro agente e sugere main

Na primeira execução ele pede confirmação de que você entendeu que agentes são poderosos e que acesso total ao sistema é arriscado

O erro comum deste passo: passar batido pelo aceite no automático, no melhor estilo next, next e finish, sem parar pra pensar no nível de acesso que você está entregando

3. Escolha o modelo e deixe validar

Aqui entra a detecção que citei lá em cima: se já existe login do Claude Code, do Codex CLI, chave de API ou modelo local, o fluxo aproveita isso

O erro comum deste passo: assumir que ele adivinha certo quando não encontra credencial nenhuma

Confira qual modelo ficou escolhido antes de seguir

4. Deixe o handoff acontecer

Depois que o modelo escolhido passa na validação, o app abre o onboarding guiado no dashboard pra parte opcional (import de memória e canais) antes de te entregar ao chat normal do agente

O erro comum deste passo: tratar import de memória e canal como obrigatório

É a parte opcional, dá pra pular e voltar depois

5. Use as frases que disparam os fluxos hospedados

Dentro do setup conversacional, algumas frases abrem fluxos de configuração prontos:

• connect telegram para canal
• configure skills para skills do workspace
• configure web search para provedor de busca
• configure gateway para o Gateway local

O erro comum deste passo: confundir configure gateway (Gateway local) com Gateway remoto

O remoto aparece na lista do wizard clássico, e é lá que ele está documentado

6. Configure a busca web sem vazar chave no chat

A busca web também pode ser configurada conversando pelo Control UI, em Settings > Ask OpenClaw, onde as chaves de API aparecem mascaradas no navegador

No terminal, a entrada de credenciais é passada pro wizard mascarado com o comando conversacional:

open search wizard

O erro comum deste passo: colar a chave direto na conversa em vez de usar a entrada mascarada

7. Se já existe config, escolha com calma

Se ~/.openclaw/openclaw.json já existir, o onboarding oferece Keep, Modify ou Reset

E tem um detalhe que salva a pele: reexecutar o onboarding sem a flag --reset mantém o config existente e reaproveita os valores como padrão

O erro comum deste passo: sair digitando --reset só pra "começar limpo" e jogar fora ajuste que já estava certo

8. Conheça as duas flags que mudam o jogo

openclaw setup --skip-ui
openclaw setup --baseline

No 2026.8.1, openclaw onboard --skip-ui e openclaw setup --skip-ui passaram a permanecer no onboarding guiado, pulando os handoffs de navegador e de terminal, em vez de cair silenciosamente no wizard clássico

Já openclaw setup --baseline preserva o comportamento antigo: cria config, workspace e diretórios de sessão e encerra sem rodar o onboarding

O erro comum deste passo: rodar --baseline esperando ver o chat de setup aparecer

Ele cria a estrutura e sai, e só

O que faz sentido resolver por conversa (e o que é melhor no wizard)

A conversa vai bem quando existe um wizard hospedado por trás dela

E o motivo é bem concreto: cada wizard hospedado coleta respostas explícitas, é dono da escrita no config e, ao concluir, grava entradas de auditoria e revalida a configuração

Não é o modelo "achando" o que escrever no seu JSON, é um fluxo com dono

Situação	Caminho documentado
Primeiro modelo e validação	setup conversacional
Busca web (provedor e chave)	conversa, com entrada mascarada
Telegram como canal	connect telegram no setup
Skills do workspace	configure skills no setup
Gateway local	configure gateway no setup
Gateway remoto	wizard clássico
Pareamento de canais e daemon	wizard clássico
Imports	wizard clássico

O wizard clássico continua existindo e é aberto explicitamente com este comando:

openclaw onboard --classic

Detalhe importante: o seletor guiado de inferência não delega para ele

QuickStart ou Advanced?

O wizard clássico pergunta entre QuickStart e Advanced

O QuickStart usa o nome de agente padrão main e acesso total, deixa o consentimento de telemetria sem definir e pula confirmação de rota, import de memória e recomendações de app

O Advanced abre o fluxo manual, com você respondendo cada coisa

Se é a primeira vez e você quer entender o que está sendo criado, o Advanced ensina mais

O limite de segurança da conversa:

A conversa livre do setup roda no mesmo loop de agente, mas limitada a uma única ferramenta de autoridade chamada openclaw

Leituras rodam livremente, e mutações exigem aprovação conversacional para aquela operação exata

Ou seja: ele te mostra o que vai mudar e espera você dizer sim, uma operação por vez

É a mesma lógica de quando você decide delegar commits pro Claude Code: funciona bem enquanto você lê o que está aprovando 😀

Quando a conversa não resolve: erros comuns no setup do OpenClaw

Uma hora o chat não vai dar conta, e aí é hora de olhar a configuração de perto

O dashboard não carrega:

Causa provável: o Gateway não está rodando

Solução:

openclaw gateway

E se você só quer o primeiro chat sem configurar canal nenhum, a opção mais rápida é abrir o Control UI:

openclaw dashboard

JSON malformado ou chave inválida:

Causa: erro de configuração no arquivo

Solução:

openclaw doctor --fix

Ele repara automaticamente problemas comuns, como chaves inválidas e JSON malformado

Provedor ou autenticação enroscados:

Causa: acesso de provedor mal configurado

A orientação nesse caso é sair do OpenClaw e rodar:

openclaw onboard

O provedor de busca exige plugin e a instalação falha:

Essa parte é bem feita, olha só: quando o provedor de busca exige instalar um plugin, o config só é escrito depois que a instalação dá certo

Se a instalação falha ou estoura o tempo, o setup interrompe e reporta o erro, em vez de afirmar que o provedor foi configurado

Ou seja, você não fica com config mentindo que está tudo certo

Perdeu o token do gateway:

O onboarding gera um token de gateway por padrão, e dá pra recuperar ele no host:

openclaw config get gateway.auth.token

Como prevenir a maior parte disso:

Mexa pelo caminho que o produto conhece, porque o Gateway observa ~/.openclaw/openclaw.json e aplica as mudanças automaticamente na maioria dos ajustes

E leia a aprovação antes de confirmar mutação, já que ela vale pra aquela operação exata

Conclusão

Dá pra configurar o OpenClaw 2.0 conversando? O caminho comum, sim: primeiro modelo, busca web, Telegram, skills e Gateway local passam por fluxos hospedados que escrevem no config, geram auditoria e revalidam

O que não dá é fingir que o arquivo sumiu

Saber que a configuração vive em ~/.openclaw/openclaw.json e que o workspace fica em ~/.openclaw/workspace continua valendo o seu tempo, principalmente no dia em que algo quebra

Próximo passo sugerido: roda openclaw setup, faz o primeiro chat pelo openclaw dashboard e só abre openclaw onboard --classic quando precisar de Gateway remoto ou pareamento de canais

Começa pequeno, confirma cada aprovação e vai crescendo o setup conforme a necessidade aparece

até o próximo post! 🙂

Perguntas frequentes

openclaw setup e openclaw onboard –classic fazem a mesma coisa?

Não. O openclaw setup roda o setup conversacional, um chat com o agente de sistema, sem inferência, com fallback pro onboarding. Já o openclaw onboard –classic abre o wizard clássico, usado pra Gateway remoto, pareamento de canais, controles de daemon e imports, e o seletor guiado de inferência não delega pra ele.

Dá pra reparar uma configuração quebrada do OpenClaw 2.0 só conversando?

Dá sim: o mesmo openclaw setup usado pra configurar do zero também serve pra reparar depois. Se o problema for algo mais técnico, como chave inválida ou JSON malformado, o comando openclaw doctor –fix repara automaticamente esses casos comuns.

O que acontece se eu já tiver um ~/.openclaw/openclaw.json quando rodar o onboarding de novo?

Se o arquivo já existir, o onboarding oferece três opções: Keep, Modify ou Reset. Sem passar a flag –reset, ele mantém o config existente e reaproveita os valores atuais como padrão, então rodar de novo não te joga pra uma configuração vazia.

Como recuperar o token do gateway depois que o onboarding gera ele automaticamente?

O onboarding gera um token de gateway por padrão, e ele fica salvo na configuração local. Pra recuperar esse token no host, o comando é openclaw config get gateway.auth.token.

openclaw setup –skip-ui e openclaw onboard –skip-ui caem direto no wizard clássico?

Não no OpenClaw 2.0. No 2026.8.1, as duas flags passaram a permanecer no onboarding guiado, pulando apenas os handoffs de navegador e de terminal, em vez de cair silenciosamente no wizard clássico como antes.

Configurar a busca web pelo Control UI expõe minha chave de API na tela?

Não. A busca web pode ser configurada conversando pelo Control UI, em Settings > Ask OpenClaw, e as chaves de API aparecem mascaradas no navegador. No terminal, o mesmo cuidado existe: a entrada de credenciais é passada pro wizard mascarado com o comando open search wizard.