Saltar al contenido principal

​
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