Canales de desarrollo

Última actualización: 2026-01-21

OpenClaw ofrece tres canales de actualización:

• stable: dist-tag de npm latest.
• beta: dist-tag de npm beta (builds en prueba).
• dev: HEAD actual de main (git). dist-tag de npm: dev (cuando se publica).

Enviamos builds a beta, los probamos y luego promovemos un build verificado a latest sin cambiar el número de versión — los dist-tags son la fuente de verdad para las instalaciones vía npm.

Cambiar de canal

Checkout de Git:

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

• stable/beta hacen checkout del último tag coincidente (a menudo el mismo tag).
• dev cambia a main y hace rebase contra el upstream.

Instalación global npm/pnpm:

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

Esto actualiza mediante el dist-tag de npm correspondiente (latest, beta, dev).

Cuando cambias de canal explícitamente con --channel, OpenClaw también alinea el método de instalación:

• dev asegura un checkout de git (por defecto ~/openclaw, personalizable con OPENCLAW_GIT_DIR), lo actualiza e instala el CLI global desde ese checkout.
• stable/beta instala desde npm usando el dist-tag correspondiente.

Consejo: si quieres stable + dev en paralelo, mantén dos clones y apunta tu gateway al de stable.

Plugins y canales

Cuando cambias de canal con openclaw update, OpenClaw también sincroniza las fuentes de plugins:

• dev prefiere plugins empaquetados del checkout de git.
• stable y beta restauran los paquetes de plugins instalados vía npm.

Mejores prácticas de etiquetado

• Etiqueta los releases en los que quieres que los checkouts de git aterricen (vYYYY.M.D para stable, vYYYY.M.D-beta.N para beta).
• vYYYY.M.D.beta.N también se reconoce por compatibilidad, pero se prefiere -beta.N.
• Los tags legacy vYYYY.M.D-<patch> siguen reconociéndose como stable (no-beta).
• Mantén los tags inmutables: nunca muevas ni reutilices un tag.
• Los dist-tags de npm siguen siendo la fuente de verdad para instalaciones npm:
  • latest → stable
  • beta → build candidato
  • dev → snapshot de main (opcional)

Disponibilidad de la app macOS

Los builds beta y dev pueden no incluir un release de la app macOS. No pasa nada:

• El tag de git y el dist-tag de npm se pueden publicar igualmente.
• Menciona “sin build macOS para esta beta” en las notas de release o el changelog.