Canais de desenvolvimento

Ultima atualizacao: 2026-01-21

O OpenClaw oferece tres canais de atualizacao:

  • stable: dist-tag npm latest.
  • beta: dist-tag npm beta (builds em teste).
  • dev: head movel de main (git). Dist-tag npm: dev (quando publicado).

Enviamos builds para beta, testamos e depois promovemos um build validado para latest sem alterar o numero de versao — os dist-tags sao a referencia para instalacoes npm.

Trocando de canal

Checkout git:

openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev
  • stable/beta fazem checkout da tag mais recente correspondente (frequentemente a mesma tag).
  • dev muda para main e faz rebase no upstream.

Instalacao global npm/pnpm:

openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev

Isso atualiza via o dist-tag npm correspondente (latest, beta, dev).

Quando voce troca explicitamente de canal com --channel, o OpenClaw tambem alinha o metodo de instalacao:

  • dev garante um checkout git (padrao ~/openclaw, configuravel via OPENCLAW_GIT_DIR), atualiza-o e instala o CLI global a partir desse checkout.
  • stable/beta instala a partir do npm usando o dist-tag correspondente.

Dica: se voce quer stable + dev em paralelo, mantenha dois clones e aponte seu gateway para o stable.

Plugins e canais

Quando voce troca de canal com openclaw update, o OpenClaw tambem sincroniza as fontes dos plugins:

  • dev prefere plugins empacotados do checkout git.
  • stable e beta restauram os pacotes de plugins instalados via npm.

Boas praticas de tagging

  • Crie tags para releases nas quais voce quer que checkouts git aterrissem (vYYYY.M.D para stable, vYYYY.M.D-beta.N para beta).
  • vYYYY.M.D.beta.N tambem e reconhecido para compatibilidade, mas prefira -beta.N.
  • Tags legacy vYYYY.M.D-<patch> ainda sao reconhecidas como stable (nao-beta).
  • Mantenha tags imutaveis: nunca mova ou reutilize uma tag.
  • Os dist-tags npm continuam sendo a referencia para instalacoes npm:
    • latest → stable
    • beta → build candidato
    • dev → snapshot de main (opcional)

Disponibilidade do app macOS

Builds beta e dev podem nao incluir um release do app macOS. Sem problemas:

  • A tag git e o dist-tag npm ainda podem ser publicados.
  • Mencione “sem build macOS para este beta” nas notas de release ou changelog.
arrow_back
Anterior
Northflank
Próximo
Channels
arrow_forward