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 mudar de canal ou direcionar para uma versão específica: 
openclaw update --channel beta
openclaw update --tag main
openclaw update --dry-run   # preview without applying
--channel beta prefere beta, mas o runtime faz 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 dist-tag beta bruta do npm para uma atualização pontual do pacote. Consulte Canais de desenvolvimento para a semântica dos canais.

​
Alternativa: execute novamente o instalador

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

​
Alternativa: npm, pnpm ou bun manualmente

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. Ative-o em ~/.openclaw/openclaw.json: 
{
  update: {
    channel: "stable",
    auto: {
      enabled: true,
      stableDelayHours: 6,
      stableJitterHours: 12,
      betaCheckIntervalHours: 1,
    },
  },
}
ChannelBehavior
stableAguarda stableDelayHours e depois aplica com jitter determinístico ao longo de stableJitterHours (rollout distribuído).
betaVerifica a cada betaCheckIntervalHours (padrão: de hora em 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
Execute o doctor
2
openclaw doctor
3
Migra a configuração, audita políticas de DM e verifica a integridade do gateway. Detalhes: Doctor
4
Reinicie o gateway
5
openclaw gateway restart
6
Verifique
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

​
Relacionado