Canales de lanzamiento

OpenClaw publica tres canales de actualización:

• stable: dist-tag de npm latest. Recomendado para la mayoría de los usuarios.
• beta: dist-tag de npm beta cuando está vigente; si beta falta o es anterior a la última versión estable, el flujo de actualización vuelve a latest.
• dev: punta móvil de main (git). dist-tag de npm: dev (cuando se publica). La rama main es para experimentación y desarrollo activo. Puede contener funcionalidades 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. Los dist-tags son la fuente de verdad para las instalaciones de npm.

Cambiar de canal

openclaw update --channel stableopenclaw update --channel betaopenclaw 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 el dist-tag de npm latest.
• beta (instalaciones de paquete): prefiere el dist-tag de npm beta, pero vuelve a latest cuando beta falta o es anterior a la etiqueta estable actual.
• stable (instalaciones de git): extrae la última etiqueta estable de git, excluyendo etiquetas de prelanzamiento semver como -alpha.N, -beta.N, -rc.N, -dev.N, -next.N, -preview.N, -canary.N, -nightly.N y otros sufijos de prelanzamiento.
• beta (instalaciones de git): prefiere la última etiqueta beta de git, pero vuelve a la última etiqueta estable de git cuando beta falta o es anterior.
• dev: asegura un checkout de git (por defecto ~/openclaw, o $OPENCLAW_HOME/openclaw cuando OPENCLAW_HOME está definido; sobrescribe 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 un dist-tag, versión o especificación de paquete específicos para una sola actualización sin cambiar tu canal persistido:

# Instalar una versión específicaopenclaw update --tag 2026.4.1-beta.1 # Instalar desde el dist-tag beta (puntual, no se conserva)openclaw update --tag beta # Cambiar al checkout móvil de main en GitHubopenclaw update --channel dev # Instalar una especificación de paquete npm específicaopenclaw update --tag openclaw@2026.4.1-beta.1 # Instalar una vez desde main de GitHub sin conservar el canalopenclaw update --tag main

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.
• Para instalaciones de paquete, OpenClaw preempaqueta especificaciones de código fuente de GitHub/git en un tarball temporal antes de la instalación npm por etapas. Usa --channel dev o --install-method git --version main cuando quieras el checkout móvil de main como instalación persistente.
• Protección contra downgrade: si la versión objetivo es anterior a tu versión actual, OpenClaw pide confirmación (omítela con --yes).
• --channel beta es diferente de --tag beta: el flujo de canal puede volver a estable/latest cuando beta falta o es anterior, mientras que --tag beta apunta al dist-tag beta sin procesar para esa ejecución.

Simulación

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

openclaw update --dry-runopenclaw update --channel beta --dry-runopenclaw update --tag 2026.4.1-beta.1 --dry-runopenclaw update --dry-run --json

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

Plugins y canales

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

• dev prefiere los plugins incluidos desde el checkout de git.
• stable y beta restauran paquetes de Plugin instalados desde npm.
• Los plugins instalados desde npm se actualizan después de que finaliza 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 aterricen los checkouts de git (vYYYY.M.PATCH para stable, vYYYY.M.PATCH-beta.N para beta; los sufijos de prelanzamiento semver con nombre como -alpha.N, -rc.N y -next.N no son objetivos estables).
• Las etiquetas estables numéricas heredadas como vYYYY.M.PATCH-1 y v1.0.1-1 aún se reconocen como etiquetas estables de git por compatibilidad.
• vYYYY.M.PATCH.beta.N también se reconoce por compatibilidad, pero prefiere -beta.N.
• Mantén las etiquetas inmutables: nunca muevas ni reutilices una etiqueta.
• Los dist-tags de npm siguen siendo la fuente de verdad para las instalaciones de npm:
  • latest -> stable
  • beta -> compilación candidata o compilación estable publicada primero en beta
  • dev -> instantánea de main (opcional)

Disponibilidad de la app de macOS

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

• La etiqueta de git y el dist-tag de npm aún pueden publicarse.
• Menciona "sin compilación de macOS para esta beta" en las notas de la versión o en el changelog.

Relacionado

• Actualizar
• Detalles internos del instalador