Saltar para o conteúdo principal

​
Canais de desenvolvimento

Última atualização: 2026-01-21 O OpenClaw oferece três canais de atualização:
  • estável: dist-tag do npm latest.
  • beta: npm dist-tag beta (builds em teste).
  • dev: head móvel de main (git). npm dist-tag: dev (quando publicado).
Publicamos builds no beta, testamos e então promovemos um build validado para latest sem alterar o número de versão — os dist-tags são a fonte da verdade para instalações via npm.

​
Alternando canais

Checkout do git: 
openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev
  • stable/beta fazem checkout da tag correspondente mais recente (geralmente a mesma tag).
  • dev muda para main e faz rebase no upstream.
Instalação global via npm/pnpm: 
openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev
Isso atualiza por meio do dist-tag npm correspondente (latest, beta, dev). Quando você explicitamente troca de canal com --channel, o OpenClaw também alinha o método de instalação:
  • dev garante um checkout git (padrão ~/openclaw, sobrescreva com OPENCLAW_GIT_DIR), atualiza-o e instala a CLI global a partir desse checkout.
  • stable/beta instalam a partir do npm usando o dist-tag correspondente.
Dica: se você quiser estável + dev em paralelo, mantenha dois clones e aponte seu gateway para o estável.

​
Plugins e canais

Ao trocar de canal com openclaw update, o OpenClaw também sincroniza as fontes dos plugins:
  • dev prefere plugins empacotados a partir do checkout git.
  • stable e beta restauram pacotes de plugins instalados via npm.

​
Boas práticas de marcação

  • Marque releases nos quais você quer que checkouts git parem (vYYYY.M.D ou vYYYY.M.D-<patch>).
  • Mantenha as tags imutáveis: nunca mova ou reutilize uma tag.
  • Os dist-tags do npm continuam sendo a fonte da verdade para instalações via npm:
    • latest → estável
    • beta → build candidato
    • dev → snapshot do main (opcional)

​
Disponibilidade do app para macOS

Builds beta e dev podem não incluir um app para macOS. Tudo bem:
  • A tag do git e o dist-tag do npm ainda podem ser publicados.
  • Destaque “sem build para macOS neste beta” nas notas de release ou no changelog.