Saltar para o conteúdo principal

​
openclaw update

Atualize o OpenClaw com segurança e alterne entre os canais stable/beta/dev. Se voce instalou via npm/pnpm (instalação global, sem metadados git), as atualizações acontecem pelo fluxo do gerenciador de pacotes em Updating.

​
Uso

openclaw update
openclaw update status
openclaw update wizard
openclaw update --channel beta
openclaw update --channel dev
openclaw update --tag beta
openclaw update --no-restart
openclaw update --json
openclaw --update

​
Opções

  • --no-restart: pula o reinício do serviço do Gateway após uma atualização bem-sucedida.
  • --channel <stable|beta|dev>: define o canal de atualização (git + npm; persistido na configuração).
  • --tag <dist-tag|version>: substitui o dist-tag do npm ou a versão apenas para esta atualização.
  • --json: imprime JSON UpdateRunResult legível por máquina.
  • --timeout <seconds>: tempo limite por etapa (o padrão é 1200s).
Nota: downgrades exigem confirmação porque versões mais antigas podem quebrar a configuração.

​
update status

Mostra o canal de atualização ativo + tag/branch/SHA do git (para checkouts de origem), além da disponibilidade de atualização. 
openclaw update status
openclaw update status --json
openclaw update status --timeout 10
Opções:
  • --json: imprime JSON de status legível por máquina.
  • --timeout <seconds>: tempo limite para verificações (o padrão é 3s).

​
update wizard

Fluxo interativo para escolher um canal de atualização e confirmar se deve reiniciar o Gateway após a atualização (o padrão é reiniciar). Se voce selecionar dev sem um checkout git, ele oferece criar um.

​
O que faz

Quando voce troca de canal explicitamente (--channel ...), o OpenClaw também mantém o método de instalação alinhado:
  • dev → garante um checkout git (padrão: ~/openclaw, substitua com OPENCLAW_GIT_DIR), atualiza-o e instala a CLI global a partir desse checkout.
  • stable/beta → instala a partir do npm usando o dist-tag correspondente.

​
Fluxo de checkout do Git

Channels:
  • stable: faz checkout da tag não-beta mais recente e então build + doctor.
  • beta: faz checkout da tag -beta mais recente e então build + doctor.
  • dev: faz checkout de main e então fetch + rebase.
High-level:
  1. Requer uma worktree limpa (sem alterações não commitadas).
  2. Alterna para o canal selecionado (tag ou branch).
  3. Faz fetch do upstream (apenas dev).
  4. Apenas dev: lint de pré-checagem + build TypeScript em uma worktree temporária; se a ponta falhar, volta até 10 commits para encontrar o build limpo mais recente.
  5. Faz rebase sobre o commit selecionado (apenas dev).
  6. Instala dependências (pnpm preferido; fallback para npm).
  7. Build + build da Control UI.
  8. Executa openclaw doctor como a verificação final de “atualização segura”.
  9. Sincroniza plugins com o canal ativo (dev usa extensões empacotadas; stable/beta usa npm) e atualiza plugins instalados via npm.

​
--update abreviação

openclaw --update é reescrito para openclaw update (útil para shells e scripts de inicialização).

​
Veja também