openclaw update¶

Actualice OpenClaw de forma segura y cambie entre canales stable/beta/dev.

Si instaló vía npm/pnpm (instalación global, sin metadatos de git), las actualizaciones se realizan mediante el flujo del gestor de paquetes en Updating.

Uso¶

openclaw update
openclaw update status
openclaw update wizard
openclaw update --channel beta
openclaw update --channel dev
openclaw update --tag beta
openclaw update --no-restart
openclaw update --json
openclaw --update

Opciones¶

• --no-restart: omite reiniciar el servicio del Gateway después de una actualización exitosa.
• --channel <stable|beta|dev>: establece el canal de actualización (git + npm; persistido en la configuración).
• --tag <dist-tag|version>: sobrescribe el dist-tag o la versión de npm solo para esta actualización.
• --json: imprime JSON UpdateRunResult legible por máquina.
• --timeout <seconds>: tiempo de espera por paso (el valor predeterminado es 1200 s).

Nota: las degradaciones requieren confirmación porque versiones anteriores pueden romper la configuración.

update status¶

Muestra el canal de actualización activo + la etiqueta/rama/SHA de git (para checkouts de código), además de la disponibilidad de actualizaciones.

openclaw update status
openclaw update status --json
openclaw update status --timeout 10

Opciones:

• --json: imprime JSON de estado legible por máquina.
• --timeout <seconds>: tiempo de espera para las comprobaciones (el valor predeterminado es 3 s).

update wizard¶

Flujo interactivo para elegir un canal de actualización y confirmar si se debe reiniciar el Gateway después de actualizar (el valor predeterminado es reiniciar). Si selecciona dev sin un checkout de git, ofrece crear uno.

Qué hace¶

Cuando cambia de canal explícitamente (--channel ...), OpenClaw también mantiene alineado el método de instalación:

• dev → garantiza un checkout de git (predeterminado: ~/openclaw, sobrescriba con OPENCLAW_GIT_DIR), lo actualiza e instala la CLI global desde ese checkout.
• stable/beta → instala desde npm usando el dist-tag correspondiente.

Flujo de checkout de git¶

Canales:

• stable: hace checkout de la etiqueta no beta más reciente y luego build + doctor.
• beta: hace checkout de la etiqueta -beta más reciente y luego build + doctor.
• dev: hace checkout de main y luego fetch + rebase.

A alto nivel:

1. Requiere un árbol de trabajo limpio (sin cambios sin confirmar).
2. Cambia al canal seleccionado (etiqueta o rama).
3. Obtiene cambios upstream (solo dev).
4. Solo dev: lint previo + compilación de TypeScript en un árbol de trabajo temporal; si la punta falla, retrocede hasta 10 commits para encontrar la compilación limpia más reciente.
5. Hace rebase sobre el commit seleccionado (solo dev).
6. Instala dependencias (pnpm preferido; alternativa npm).
7. Compila + compila la UI de Control.
8. Ejecuta openclaw doctor como la comprobación final de “actualización segura”.
9. Sincroniza plugins con el canal activo (dev usa extensiones integradas; stable/beta usa npm) y actualiza los plugins instalados por npm.

Atajo --update¶

openclaw --update se reescribe a openclaw update (útil para shells y scripts de lanzamiento).

Ver también¶

• openclaw doctor (ofrece ejecutar la actualización primero en checkouts de git)
• Canales de desarrollo
• Actualización
• Referencia de CLI