Canales de lanzamiento

OpenClaw distribuye tres canales de actualización:

• stable: etiqueta de distribución de npm latest. Recomendado para la mayoría de los usuarios.
• beta: etiqueta de distribución de npm beta cuando está actualizada; si beta falta o es más antigua que la última versión estable, el flujo de actualización recurre a latest.
• dev: punta móvil de main (git). Etiqueta de distribución de npm: dev (cuando se publica). La rama main es para experimentación y desarrollo activo. Puede contener funciones incompletas o cambios incompatibles. No la uses para gateways de producción.

Normalmente publicamos primero las compilaciones estables en beta, las probamos allí y luego ejecutamos un paso explícito de promoción que mueve la compilación validada a latest sin cambiar el número de versión. Los mantenedores también pueden publicar una versión estable directamente en latest cuando sea necesario. Las etiquetas de distribución 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

--channel conserva tu elección en la configuración (update.channel) y alinea el método de instalación:

• stable (instalaciones de paquete): actualiza mediante la etiqueta de distribución de npm latest.
• beta (instalaciones de paquete): prefiere la etiqueta de distribución de npm beta, pero recurre a latest cuando beta falta o es más antigua que la etiqueta estable actual.
• stable (instalaciones de git): cambia a la última etiqueta estable de git.
• beta (instalaciones de git): prefiere la última etiqueta beta de git, pero recurre a la última etiqueta estable de git cuando beta falta o es más antigua.
• dev: garantiza un checkout de git (predeterminado ~/openclaw, se puede anular con OPENCLAW_GIT_DIR), cambia a main, hace rebase sobre upstream, compila e instala la CLI global desde ese checkout.

# Apuntar a una versión o etiqueta puntual

Usa --tag para apuntar a una etiqueta de distribución, versión o especificación de paquete específica para una sola actualización sin cambiar tu canal conservado:

# 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 [email protected]

Notas:

• --tag se aplica solo a instalaciones de paquete (npm). Las instalaciones de git lo ignoran.
• La etiqueta no se conserva. Tu siguiente openclaw update usa tu canal configurado como de costumbre.
• Protección contra degradación: si la versión de destino es más antigua que tu versión actual, OpenClaw pide confirmación (omítela con --yes).
• --channel beta es diferente de --tag beta: el flujo de canal puede recurrir a stable/latest cuando beta falta o es más antigua, mientras que --tag beta apunta a la etiqueta de distribución beta sin procesar para esa ejecución única.

# Simulación

Previsualiza lo que haría openclaw update sin realizar cambios:

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

La simulación muestra el canal efectivo, la versión de destino, las acciones planificadas y si se requeriría una confirmación de degradación.

# Plugins y canales

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

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

# Comprobar el estado actual

openclaw update status

Muestra el canal activo, el tipo de instalación (git o paquete), la versión actual y la fuente (configuración, etiqueta de git, rama de git o valor predeterminado).

# Buenas prácticas de etiquetado

• Etiqueta las versiones en las que quieres que caigan los checkouts de git (vYYYY.M.D para stable, vYYYY.M.D-beta.N para beta).
• vYYYY.M.D.beta.N también se reconoce por compatibilidad, pero prefiere -beta.N.
• Las etiquetas heredadas vYYYY.M.D-<patch> todavía se reconocen como estables (no beta).
• Mantén las etiquetas inmutables: nunca muevas ni reutilices una etiqueta.
• Las etiquetas de distribución de npm siguen siendo la fuente de verdad para las instalaciones de npm:
  • latest -> stable
  • beta -> compilación candidata o compilación estable probada primero en beta
  • dev -> instantánea de main (opcional)

# Disponibilidad de la app de macOS

Las compilaciones beta y dev pueden no incluir una versión de la app de macOS. Eso está bien:

• La etiqueta de git y la etiqueta de distribución de npm todavía pueden publicarse.
• Indica "sin compilación de macOS para esta beta" en las notas de la versión o en el changelog.

# Relacionado

• Actualizar
• Internos del instalador