Pular para o conteúdo principal
OpenClaw distribui três canais de atualização:
  • stable: dist-tag npm latest. Recomendado para a maioria dos usuários.
  • beta: dist-tag npm beta quando está atual; se o beta estiver ausente ou for mais antigo que a versão estável mais recente, o fluxo de atualização recorre a latest.
  • dev: ponta móvel de main (git). dist-tag npm: dev (quando publicado). A branch main é para experimentação e desenvolvimento ativo. Ela pode conter recursos incompletos ou alterações incompatíveis. Não a use para gateways de produção.
Normalmente publicamos builds estáveis primeiro em beta, testamos lá e então executamos uma etapa explícita de promoção que move o build validado para latest sem alterar o número da versão. Os mantenedores também podem publicar uma versão estável diretamente em latest quando necessário. Dist-tags são a fonte da verdade para instalações npm.

​
Alternando canais

openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev
--channel persiste sua escolha na configuração (update.channel) e alinha o método de instalação:
  • stable (instalações por pacote): atualiza via dist-tag npm latest.
  • beta (instalações por pacote): prefere a dist-tag npm beta, mas recorre a latest quando beta está ausente ou é mais antigo que a tag estável atual.
  • stable (instalações git): faz checkout da tag git estável mais recente, excluindo tags de pré-lançamento semver como -alpha.N, -beta.N, -rc.N, -dev.N, -next.N, -preview.N, -canary.N, -nightly.N e outros sufixos de pré-lançamento.
  • beta (instalações git): prefere a tag git beta mais recente, mas recorre à tag git estável mais recente quando o beta está ausente ou é mais antigo.
  • dev: garante um checkout git (padrão ~/openclaw, ou $OPENCLAW_HOME/openclaw quando OPENCLAW_HOME está definido; substitua com OPENCLAW_GIT_DIR), alterna para main, faz rebase no upstream, compila e instala a CLI global a partir desse checkout.
Se quiser stable e dev em paralelo, mantenha dois clones e aponte seu gateway para o estável.

​
Direcionamento avulso de versão ou tag

Use --tag para direcionar uma dist-tag, versão ou especificação de pacote específica para uma única atualização sem alterar seu canal persistido: 
# Install a specific version
openclaw update --tag 2026.4.1-beta.1

# Install from the beta dist-tag (one-off, does not persist)
openclaw update --tag beta

# Switch to the moving GitHub main checkout
openclaw update --channel dev

# Install a specific npm package spec
openclaw update --tag openclaw@2026.4.1-beta.1

# Install from GitHub main once without persisting the channel
openclaw update --tag main
Observações:
  • --tag se aplica somente a instalações por pacote (npm). Instalações git o ignoram.
  • A tag não é persistida. Seu próximo openclaw update usa seu canal configurado como de costume.
  • Para instalações por pacote, o OpenClaw pré-empacota especificações de origem GitHub/git em um tarball temporário antes da instalação npm em staging. Use --channel dev ou --install-method git --version main quando quiser o checkout móvel de main como sua instalação persistente.
  • Proteção contra downgrade: se a versão de destino for mais antiga que sua versão atual, o OpenClaw solicita confirmação (ignore com --yes).
  • --channel beta é diferente de --tag beta: o fluxo do canal pode recorrer a stable/latest quando o beta está ausente ou é mais antigo, enquanto --tag beta direciona a dist-tag bruta beta para aquela execução.

​
Simulação

Pré-visualize o que openclaw update faria sem aplicar alterações: 
openclaw update --dry-run
openclaw update --channel beta --dry-run
openclaw update --tag 2026.4.1-beta.1 --dry-run
openclaw update --dry-run --json
A simulação mostra o canal efetivo, a versão de destino, as ações planejadas e se uma confirmação de downgrade seria necessária.

​
Plugins e canais

Quando você alterna canais com openclaw update, o OpenClaw também sincroniza fontes de plugins:
  • dev prefere plugins incluídos do checkout git.
  • stable e beta restauram pacotes de plugins instalados via npm.
  • Plugins instalados via npm são atualizados depois que a atualização do core é concluída.

​
Verificando o status atual

openclaw update status
Mostra o canal ativo, o tipo de instalação (git ou pacote), a versão atual e a fonte (configuração, tag git, branch git ou padrão).

​
Boas práticas de tags

  • Marque releases nos quais você quer que checkouts git parem (vYYYY.M.PATCH para stable, vYYYY.M.PATCH-beta.N para beta; sufixos nomeados de pré-lançamento semver como -alpha.N, -rc.N e -next.N não são alvos estáveis).
  • Tags estáveis numéricas legadas como vYYYY.M.PATCH-1 e v1.0.1-1 ainda são reconhecidas como tags git estáveis para compatibilidade.
  • vYYYY.M.PATCH.beta.N também é reconhecida por compatibilidade, mas prefira -beta.N.
  • Mantenha tags imutáveis: nunca mova nem reutilize uma tag.
  • Dist-tags npm continuam sendo a fonte da verdade para instalações npm:
    • latest -> stable
    • beta -> build candidato ou build estável beta-first
    • dev -> snapshot de main (opcional)

​
Disponibilidade do app para macOS

Builds beta e dev podem não incluir uma versão do app para macOS. Isso não é problema:
  • A tag git e a dist-tag npm ainda podem ser publicadas.
  • Informe “sem build para macOS neste beta” nas notas de release ou no changelog.

​
Relacionados