Cambia de canal en OpenClaw: Stable, Beta o Dev

¿Alguna vez has actualizado una herramienta de trabajo y te has arrepentido al instante porque algo dejó de funcionar en tu entorno? Mantener el equilibrio entre probar las últimas funciones y tener un sistema estable es un reto constante para cualquier desarrollador.

OpenClaw te facilita esta tarea ofreciendo tres canales de actualización distintos para que elijas el que mejor se adapte a tus necesidades:

• stable: npm dist-tag latest. Es la opción recomendada para la mayoría de los usuarios.
• beta: npm dist-tag beta (versiones en fase de prueba).
• dev: la punta de la rama main (git). npm dist-tag: dev (cuando se publica). La rama main es para experimentación y desarrollo activo. Puede contener funciones incompletas o cambios que rompan la compatibilidad. No la uses para Gateways en producción.

Enviamos las versiones a beta, las probamos y luego promovemos una versión verificada a latest sin cambiar el número de versión; los dist-tags son la fuente de verdad para las instalaciones de npm.

Cambiar de canal

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

El flag --channel guarda tu elección en la configuración (update.channel) y ajusta el método de instalación:

• stable/beta (instalaciones de paquetes): se actualiza mediante el dist-tag de npm correspondiente.
• stable/beta (instalaciones de git): descarga el último tag de git que coincida.
• dev: asegura un checkout de git (por defecto en ~/openclaw, puedes cambiarlo con OPENCLAW_GIT_DIR), cambia a la rama main, hace un rebase sobre el upstream, compila e instala el CLI global desde ese checkout.

Un consejo: si quieres tener la versión stable y la dev en paralelo, mantén dos clones y apunta tu Gateway a la versión stable.

Apuntar a una versión o etiqueta específica

Usa --tag para dirigirte a un dist-tag, versión o especificación de paquete concreta en una sola actualización sin cambiar tu canal configurado:

# 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

# Install from GitHub main branch (npm tarball)
openclaw update --tag main

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

Notas a tener en cuenta:

• --tag se aplica solo a instalaciones de paquetes (npm). Las instalaciones de git lo ignoran.
• La etiqueta no se guarda. Tu próxima ejecución de openclaw update usará el canal que tengas configurado normalmente.
• Protección de versión anterior: si la versión de destino es más antigua que tu versión actual, OpenClaw te pedirá confirmación (puedes saltarte esto con --yes).

Ejecución de prueba (Dry run)

Puedes previsualizar lo que haría openclaw update sin realizar ningún cambio real:

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

El dry run muestra el canal efectivo, la versión de destino, las acciones planeadas y si se requeriría una confirmación para volver a una versión anterior.

Plugins y canales

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

• dev prefiere los plugins incluidos en el checkout de git.
• stable y beta restauran los paquetes de plugins instalados mediante npm.
• Los plugins instalados por npm se actualizan después de que termine la actualización del núcleo.

Comprobar el estado actual

openclaw update status

Este comando muestra el canal activo, el tipo de instalación (git o paquete), la versión actual y la fuente (configuración, tag de git, rama de git o valor por defecto).

Mejores prácticas para el etiquetado

• Etiqueta los lanzamientos en los que quieras que aterricen los checkouts de git (vYYYY.M.D para stable, vYYYY.M.D-beta.N para beta).
• También se reconoce vYYYY.M.D.beta.N por compatibilidad, pero es preferible usar -beta.N.
• Los tags antiguos tipo vYYYY.M.D-<patch> se siguen reconociendo como estables (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 las instalaciones de npm:
  • latest -> stable
  • beta -> versión candidata
  • dev -> snapshot de main (opcional)

Disponibilidad de la aplicación para macOS

Es posible que las versiones beta y dev no incluyan un lanzamiento de la aplicación para macOS. Esto es normal:

• El tag de git y el dist-tag de npm se pueden publicar igualmente.
• Se indicará “no macOS build for this beta” en las notas de lanzamiento o en el changelog.

AI Setup Assistant

Pasos siguientes

• Consulta la guía de instalación avanzada para configurar tu entorno.
• Aprende más sobre la configuración del Gateway para optimizar tu flujo de trabajo.