> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# actualizar

# `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](/install/updating).

## Uso

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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.

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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](/install/development-channels)
* [Actualización](/install/updating)
* [Referencia de CLI](/cli)