Pular para o conteúdo principal

​
Atualização

Mantenha o OpenClaw atualizado.

​
Recomendado: openclaw update

A forma mais rápida de atualizar. Ele detecta seu tipo de instalação (npm ou git), busca a versão mais recente, executa openclaw doctor e reinicia o gateway. 
openclaw update
Para trocar de canal ou direcionar para uma versão específica: 
openclaw update --channel beta
openclaw update --tag main
openclaw update --dry-run   # prévia sem aplicar
--channel beta dá preferência ao beta, mas o runtime usa fallback para stable/latest quando a tag beta está ausente ou é mais antiga que a versão estável mais recente. Use --tag beta se você quiser a raw npm beta dist-tag para uma atualização pontual do pacote. Consulte Canais de desenvolvimento para a semântica dos canais.

​
Alternativa: executar o instalador novamente

curl -fsSL https://openclaw.ai/install.sh | bash
Adicione --no-onboard para pular o onboarding. Para instalações a partir do código-fonte, passe --install-method git --no-onboard.

​
Alternativa: npm, pnpm ou bun manual

npm i -g openclaw@latest

pnpm add -g openclaw@latest

bun add -g openclaw@latest

​
Atualizador automático

O atualizador automático vem desativado por padrão. Habilite-o em ~/.openclaw/openclaw.json: 
{
  update: {
    channel: "stable",
    auto: {
      enabled: true,
      stableDelayHours: 6,
      stableJitterHours: 12,
      betaCheckIntervalHours: 1,
    },
  },
}
CanalComportamento
stableAguarda stableDelayHours, depois aplica com jitter determinístico ao longo de stableJitterHours (rollout distribuído).
betaVerifica a cada betaCheckIntervalHours (padrão: a cada hora) e aplica imediatamente.
devSem aplicação automática. Use openclaw update manualmente.
O gateway também registra uma dica de atualização na inicialização (desative com update.checkOnStart: false).

​
Após atualizar

1
Executar o doctor
2
openclaw doctor
3
Migra a configuração, audita políticas de DM e verifica a integridade do gateway. Detalhes: Doctor
4
Reiniciar o gateway
5
openclaw gateway restart
6
Verificar
7
openclaw health

​
Rollback

​
Fixar uma versão (npm)

npm i -g openclaw@<version>
openclaw doctor
openclaw gateway restart
Dica: npm view openclaw version mostra a versão publicada atual.

​
Fixar um commit (código-fonte)

git fetch origin
git checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"
pnpm install && pnpm build
openclaw gateway restart
Para voltar ao mais recente: git checkout main && git pull.

​
Se você estiver travado

  • Execute openclaw doctor novamente e leia a saída com atenção.
  • Para openclaw update --channel dev em checkouts do código-fonte, o atualizador inicializa automaticamente o pnpm quando necessário. Se você vir um erro de bootstrap do pnpm/corepack, instale o pnpm manualmente (ou reative o corepack) e execute a atualização novamente.
  • Verifique: Solução de problemas
  • Peça ajuda no Discord: https://discord.gg/clawd

​
Relacionado