Canales de lanzamiento

OpenClaw ofrece tres canales de actualización:

estable: npm dist-tag latest. Recomendado para la mayoría de los usuarios.
beta: npm dist-tag beta cuando está actualizado; si beta falta o es anterior a la última versión estable, el flujo de actualización recurre a latest.
dev: cabecera móvil de 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 importantes. No la utilice para gateways de producción.

Generalmente enviamos compilaciones estables a beta primero, las probamos allí y luego ejecutamos un paso de promoción explícito que mueve la compilación verificada 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 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

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

stable (instalaciones de paquetes): actualizaciones a través de npm dist-tag latest.
beta (instalaciones de paquetes): prefiere npm dist-tag beta, pero recurre a latest cuando beta falta o es anterior a la etiqueta estable actual.
stable (instalaciones de git): verifica la última etiqueta git estable.
beta (instalaciones de git): prefiere la última etiqueta git beta, pero recurre a la última etiqueta git estable cuando beta falta o es anterior.
dev: asegura una copia de trabajo de git (por defecto ~/openclaw, anular con OPENCLAW_GIT_DIR), cambia a main, hace rebase en upstream, compila e instala la CLI global desde esa copia.

Targeting de versión o etiqueta única

Use --tag para apuntar a un dist-tag, versión o especificación de paquete específico para una única actualización sin cambiar su canal persistente:

# 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 paquetes (npm). Las instalaciones de Git lo ignoran.
La etiqueta no se mantiene. Su próximo openclaw update usará su canal configurado como de costumbre.
Protección de degradación: si la versión de destino es anterior a su versión actual, OpenClaw solicita confirmación (omítala con --yes).
--channel beta es diferente de --tag beta: el flujo del canal puede volver a estable/último cuando falta o es antigua la beta, mientras que --tag beta apunta al dist-tag beta sin procesar para esa única ejecución.

Ejecución en seco

Vista previa de 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 ejecución en seco muestra el canal efectivo, la versión de destino, las acciones planificadas y si se requeriría una confirmación de degradación.

Complementos y canales

Cuando cambia de canal con openclaw update, OpenClaw también sincroniza las fuentes de los complementos:

dev prefiere complementos integrados desde la comprobación de git.
stable y beta restauran los paquetes de complementos instalados por npm.
Los complementos instalados por npm se actualizan después de que se completa la actualización del núcleo.

Verificar 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 (config, etiqueta git, rama git o predeterminado).

Mejores prácticas de etiquetado

Etiquete las versiones que desea que lleguen a las comprobaciones de git (vYYYY.M.D para estable, vYYYY.M.D-beta.N para beta).
vYYYY.M.D.beta.N también se reconoce por compatibilidad, pero se prefiere -beta.N.
Las etiquetas vYYYY.M.D-<patch> heredadas aún se reconocen como estables (no beta).
Mantenga las etiquetas inmutables: nunca mueva ni reutilice una etiqueta.
Los dist-tags de npm siguen siendo la fuente de verdad para las instalaciones de npm:
- latest -> estable
- beta -> compilación candidata o compilación estable con prioridad beta
- dev -> instantánea principal (opcional)

Disponibilidad de la app macOS

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

La etiqueta de git y la etiqueta de distribución de npm aún se pueden publicar.
Indique “no hay compilación de macOS para esta beta” en las notas de la versión o el registro de cambios.