Saltar para o conteúdo principal

​
Atualização

O OpenClaw está evoluindo rapidamente (pré “1.0”). Trate atualizações como infraestrutura de produção: atualizar → executar verificações → reiniciar (ou usar openclaw update, que reinicia) → verificar.

​
Recomendado: executar novamente o instalador do site (atualização no local)

O caminho preferido de atualização é executar novamente o instalador a partir do site. Ele detecta instalações existentes, atualiza no local e executa openclaw doctor quando necessário. 
curl -fsSL https://openclaw.ai/install.sh | bash
Notas:
  • Adicione --no-onboard se você não quiser que o assistente de integração inicial seja executado novamente.
  • Para instalações a partir do código-fonte, use: 
    curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --no-onboard
    O instalador fará git pull --rebase apenas se o repositório estiver limpo.
  • Para instalações globais, o script usa npm install -g openclaw@latest internamente.
  • Nota legada: clawdbot permanece disponível como um shim de compatibilidade.

​
Antes de atualizar

  • Saiba como você instalou: global (npm/pnpm) vs a partir do código-fonte (git clone).
  • Saiba como seu Gateway está rodando: terminal em primeiro plano vs serviço supervisionado (launchd/systemd).
  • Faça um snapshot do seu ajuste:
    • Configuração: ~/.openclaw/openclaw.json
    • Credenciais: ~/.openclaw/credentials/
    • Espaço de trabalho: ~/.openclaw/workspace

​
Atualizar (instalação global)

Instalação global (escolha uma): 
npm i -g openclaw@latest

pnpm add -g openclaw@latest
Não recomendamos Bun para o runtime do Gateway (bugs no WhatsApp/Telegram). Para trocar canais de atualização (instalações via git + npm): 
openclaw update --channel beta
openclaw update --channel dev
openclaw update --channel stable
Use --tag <dist-tag|version> para uma instalação pontual por tag/versão. Veja Canais de desenvolvimento para a semântica dos canais e notas de versão. Nota: em instalações via npm, o gateway registra uma dica de atualização na inicialização (verifica a tag do canal atual). Desative via update.checkOnStart: false. Depois: 
openclaw doctor
openclaw gateway restart
openclaw health
Notas:
  • Se o seu Gateway roda como serviço, openclaw gateway restart é preferível a matar PIDs.
  • Se você está fixado em uma versão específica, veja “Rollback / fixação” abaixo.

​
Atualizar (openclaw update)

Para instalações a partir do código-fonte (git checkout), prefira: 
openclaw update
Ele executa um fluxo de atualização relativamente seguro:
  • Requer uma árvore de trabalho limpa.
  • Alterna para o canal selecionado (tag ou branch).
  • Faz fetch + rebase contra o upstream configurado (canal dev).
  • Instala dependências, compila, compila a Control UI e executa openclaw doctor.
  • Reinicia o gateway por padrão (use --no-restart para pular).
Se você instalou via npm/pnpm (sem metadados git), openclaw update tentará atualizar via seu gerenciador de pacotes. Se não conseguir detectar a instalação, use “Atualizar (instalação global)” em vez disso.

​
Atualizar (Control UI / RPC)

A Control UI tem Update & Restart (RPC: update.run). Ela:
  1. Executa o mesmo fluxo de atualização a partir do código-fonte que openclaw update (apenas git checkout).
  2. Grava um sentinel de reinício com um relatório estruturado (stdout/stderr tail).
  3. Reinicia o gateway e envia um ping para a última sessão ativa com o relatório.
Se o rebase falhar, o gateway aborta e reinicia sem aplicar a atualização.

​
Atualizar (a partir do código-fonte)

A partir do checkout do repositório: Preferido: 
openclaw update
Manual (equivalente-ish): 
git pull
pnpm install
pnpm build
pnpm ui:build # auto-installs UI deps on first run
openclaw doctor
openclaw health
Notas:
  • pnpm build importa quando você executa o binário empacotado openclaw (openclaw.mjs) ou usa Node para executar dist/.
  • Se você roda a partir de um checkout do repositório sem uma instalação global, use pnpm openclaw ... para comandos da CLI.
  • Se você roda diretamente a partir de TypeScript (pnpm openclaw ...), geralmente uma recompilação é desnecessária, mas migrações de configuração ainda se aplicam → execute o doctor.
  • Alternar entre instalações globais e via git é fácil: instale o outro formato e, em seguida, execute openclaw doctor para que o entrypoint do serviço do gateway seja reescrito para a instalação atual.

​
Sempre execute: openclaw doctor

Doctor é o comando de “atualização segura”. Ele é intencionalmente simples: reparar + migrar + avisar. Nota: se você estiver em uma instalação a partir do código-fonte (git checkout), openclaw doctor oferecerá executar openclaw update primeiro. Coisas típicas que ele faz:
  • Migra chaves de configuração obsoletas / locais legados de arquivos de configuração.
  • Audita políticas de DM e avisa sobre configurações “abertas” arriscadas.
  • Verifica a saúde do Gateway e pode oferecer reiniciar.
  • Detecta e migra serviços de gateway antigos (launchd/systemd; schtasks legados) para os serviços atuais do OpenClaw.
  • No Linux, garante o lingering do usuário no systemd (para que o Gateway sobreviva ao logout).
Detalhes: Doctor

​
Iniciar / parar / reiniciar o Gateway

CLI (funciona independentemente do SO): 
openclaw gateway status
openclaw gateway stop
openclaw gateway restart
openclaw gateway --port 18789
openclaw logs --follow
Se você usa supervisão:
  • macOS launchd (LaunchAgent empacotado no app): launchctl kickstart -k gui/$UID/bot.molt.gateway (use bot.molt.<profile>; o legado com.openclaw.* ainda funciona)
  • Serviço de usuário do Linux systemd: systemctl --user restart openclaw-gateway[-<profile>].service
  • Windows (WSL2): systemctl --user restart openclaw-gateway[-<profile>].service
    • launchctl/systemctl só funcionam se o serviço estiver instalado; caso contrário, execute openclaw gateway install.
Runbook + rótulos exatos de serviços: Gateway runbook

​
Rollback / fixação (quando algo quebra)

​
Fixar (instalação global)

Instale uma versão conhecida e estável (substitua <version> pela última que funcionou): 
npm i -g openclaw@<version>

pnpm add -g openclaw@<version>
Dica: para ver a versão publicada atual, execute npm view openclaw version. Depois reinicie + execute o doctor novamente: 
openclaw doctor
openclaw gateway restart

​
Fixar (código-fonte) por data

Escolha um commit por data (exemplo: “estado da main em 2026-01-01”): 
git fetch origin
git checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"
Depois reinstale dependências + reinicie: 
pnpm install
pnpm build
openclaw gateway restart
Se quiser voltar para o mais recente depois: 
git checkout main
git pull

​
Se você estiver travado