Maintenance

Actualizando

Mantén OpenClaw actualizado.

Recomendado: `openclaw update`

La forma más rápida de actualizar. Detecta tu tipo de instalación (npm o git), obtiene la versión más reciente, ejecuta openclaw doctor y reinicia el Gateway.

bash

openclaw update

Para cambiar de canales o apuntar a una versión específica:

bash

openclaw update --channel betaopenclaw update --channel devopenclaw update --dry-run   # preview without applying

openclaw update no acepta --verbose. Para diagnósticos de actualización, usa --dry-run para previsualizar las acciones planificadas, --json para resultados estructurados, o openclaw update status --json para inspeccionar el estado del canal y de disponibilidad. El instalador tiene su propia marca --verbose, pero esa marca no forma parte de openclaw update.

--channel beta prefiere beta, pero el runtime vuelve a stable/latest cuando falta la etiqueta beta o es más antigua que la última versión estable. Usa --tag beta si quieres el dist-tag beta sin procesar de npm para una actualización puntual del paquete.

Usa --channel dev para un checkout persistente y móvil de main de GitHub. Para actualizaciones de paquetes, --tag main se asigna a github:openclaw/openclaw#main para una ejecución, y las especificaciones de origen de GitHub/git se empaquetan en un tarball temporal antes de la instalación npm preparada.

Para plugins gestionados, la alternativa del canal beta es una advertencia: la actualización del núcleo aún puede completarse correctamente mientras un plugin usa su versión predeterminada/más reciente registrada porque no hay una beta disponible para ese plugin.

Consulta Canales de desarrollo para conocer la semántica de los canales.

Cambiar entre instalaciones npm y git

Usa canales cuando quieras cambiar el tipo de instalación. El actualizador conserva tu estado, configuración, credenciales y espacio de trabajo en ~/.openclaw; solo cambia qué instalación del código de OpenClaw usan la CLI y el Gateway.

bash

# npm package install -> editable git checkoutopenclaw update --channel dev # git checkout -> npm package installopenclaw update --channel stable

Ejecútalo primero con --dry-run para previsualizar el cambio exacto de modo de instalación:

bash

openclaw update --channel dev --dry-runopenclaw update --channel stable --dry-run

El canal dev garantiza un checkout git, lo compila e instala la CLI global desde ese checkout. Los canales stable y beta usan instalaciones de paquetes. Si el Gateway ya está instalado, openclaw update actualiza los metadatos del servicio y lo reinicia, salvo que pases --no-restart.

Para instalaciones de paquetes con un servicio Gateway gestionado, openclaw update apunta a la raíz del paquete usada por ese servicio. Si el comando de shell openclaw proviene de una instalación diferente, el actualizador imprime ambas raíces y la ruta de Node del servicio gestionado. La actualización del paquete usa el gestor de paquetes que posee la raíz del servicio y comprueba el Node del servicio gestionado contra el motor de la versión objetivo antes de reemplazar el paquete.

Alternativa: volver a ejecutar el instalador

bash

curl -fsSL https://openclaw.ai/install.sh | bash

Añade --no-onboard para omitir la incorporación. Para forzar un tipo de instalación específico mediante el instalador, pasa --install-method git --no-onboard o --install-method npm --no-onboard.

Si openclaw update falla después de la fase de instalación del paquete npm, vuelve a ejecutar el instalador. El instalador no llama al actualizador antiguo; ejecuta directamente la instalación del paquete global y puede recuperar una instalación npm parcialmente actualizada.

bash

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm

Para fijar la recuperación a una versión o dist-tag específicos, añade --version:

bash

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm --version <version-or-dist-tag>

Alternativa: npm, pnpm o bun manual

bash

npm i -g openclaw@latest

Prefiere openclaw update para instalaciones supervisadas porque puede coordinar el intercambio de paquetes con el servicio Gateway en ejecución. Si actualizas manualmente en una instalación supervisada, detén el Gateway gestionado antes de que el gestor de paquetes empiece. Los gestores de paquetes reemplazan archivos en su ubicación, y un Gateway en ejecución podría intentar cargar archivos del núcleo o de plugins mientras el árbol de paquetes está temporalmente a medio reemplazar. Reinicia el Gateway después de que el gestor de paquetes termine para que el servicio use la nueva instalación.

Para una instalación global de sistema en Linux propiedad de root, si openclaw update falla con EACCES y la recuperas con npm del sistema, mantén el Gateway detenido durante el reemplazo manual del paquete. Usa las mismas marcas de perfil de openclaw o el entorno que usas normalmente para ese Gateway. Sustituye /usr/bin/npm por el npm del sistema que posee el prefijo global propiedad de root en tu host:

bash

openclaw gateway stopsudo /usr/bin/npm i -g openclaw@latestopenclaw gateway install --forceopenclaw gateway restart

Luego verifica el servicio:

bash

openclaw --versioncurl -fsS http://127.0.0.1:18789/readyzopenclaw plugins list --jsonopenclaw gateway status --deep --jsonopenclaw doctor --lint --json

Cuando openclaw update gestiona una instalación npm global, primero instala el objetivo en un prefijo npm temporal, verifica el inventario dist empaquetado y luego intercambia el árbol de paquetes limpio en el prefijo global real. Eso evita que npm superponga un paquete nuevo sobre archivos obsoletos del paquete anterior. Si el comando de instalación falla, OpenClaw reintenta una vez con --omit=optional. Ese reintento ayuda a los hosts donde las dependencias opcionales nativas no pueden compilarse, mientras mantiene visible el fallo original si la alternativa también falla.

Los comandos de actualización npm gestionada por OpenClaw y de actualización de plugins también limpian la cuarentena min-release-age de npm para el proceso npm hijo. npm puede informar esa política como un corte before derivado; ambos son útiles para políticas generales de cuarentena de cadena de suministro, pero una actualización explícita de OpenClaw significa "instalar ahora la versión seleccionada de OpenClaw".

bash

pnpm add -g openclaw@latest

bash

bun add -g openclaw@latest

Temas avanzados de instalación npm

Árbol de paquetes de solo lectura

OpenClaw trata las instalaciones globales empaquetadas como de solo lectura en runtime, incluso cuando el directorio global del paquete es escribible por el usuario actual. Las instalaciones de paquetes de plugins viven en raíces npm/git propiedad de OpenClaw bajo el directorio de configuración del usuario, y el arranque del Gateway no modifica el árbol de paquetes de OpenClaw.

Algunas configuraciones npm de Linux instalan paquetes globales bajo directorios propiedad de root, como /usr/lib/node_modules/openclaw. OpenClaw admite ese diseño porque los comandos de instalación/actualización de plugins escriben fuera de ese directorio global de paquetes.

Unidades systemd reforzadas

Da a OpenClaw acceso de escritura a sus raíces de configuración/estado para que las instalaciones explícitas de plugins, las actualizaciones de plugins y la limpieza de doctor puedan persistir sus cambios:

ini

ReadWritePaths=/var/lib/openclaw /home/openclaw/.openclaw /tmp

Comprobación previa de espacio en disco

Antes de las actualizaciones de paquetes y las instalaciones explícitas de plugins, OpenClaw intenta una comprobación de espacio en disco de mejor esfuerzo para el volumen objetivo. El espacio bajo produce una advertencia con la ruta comprobada, pero no bloquea la actualización porque las cuotas del sistema de archivos, las instantáneas y los volúmenes de red pueden cambiar después de la comprobación. La instalación real del gestor de paquetes y la verificación posterior a la instalación siguen siendo autoritativas.

Actualizador automático

El actualizador automático está desactivado de forma predeterminada. Actívalo en ~/.openclaw/openclaw.json:

json5

{  update: {    channel: "stable",    auto: {      enabled: true,      stableDelayHours: 6,      stableJitterHours: 12,      betaCheckIntervalHours: 1,    },  },}

Canal	Comportamiento
`stable`	Espera `stableDelayHours` y luego aplica con jitter determinista durante `stableJitterHours` (despliegue distribuido).
`beta`	Comprueba cada `betaCheckIntervalHours` (predeterminado: cada hora) y aplica de inmediato.
`dev`	No aplica automáticamente. Usa `openclaw update` manualmente.

El Gateway también registra una sugerencia de actualización al arrancar (desactívala con update.checkOnStart: false). Para recuperación ante degradación de versión o incidentes, configura OPENCLAW_NO_AUTO_UPDATE=1 en el entorno del Gateway para bloquear las aplicaciones automáticas incluso cuando update.auto.enabled esté configurado. Las sugerencias de actualización al arrancar aún pueden ejecutarse salvo que update.checkOnStart también esté desactivado.

Las actualizaciones del gestor de paquetes solicitadas mediante el controlador del plano de control del Gateway en vivo no reemplazan el árbol de paquetes dentro del proceso Gateway en ejecución. En instalaciones de servicios gestionados, el Gateway inicia una transferencia desacoplada, sale y deja que la ruta normal de la CLI openclaw update --yes --json detenga el servicio, reemplace el paquete, actualice los metadatos del servicio, reinicie, verifique la versión y accesibilidad del Gateway, y recupere un LaunchAgent de macOS instalado pero no cargado cuando sea posible. Si el Gateway no puede hacer esa transferencia de forma segura, update.run informa un comando de shell seguro en lugar de ejecutar el gestor de paquetes dentro del proceso.

Después de actualizar

Ejecutar doctor

bash

openclaw doctor

Migra la configuración, audita las políticas de DM y comprueba la salud del gateway. Detalles: Doctor

Reiniciar el Gateway

bash

openclaw gateway restart

Verificar

bash

openclaw health

Reversión

Fijar una versión (npm)

bash

npm i -g openclaw@<version>openclaw doctoropenclaw gateway restart

Fijar un commit (código fuente)

bash

git fetch origingit checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"pnpm install && pnpm buildopenclaw gateway restart

Para volver a la más reciente: git checkout main && git pull.

Si estás atascado

Ejecuta openclaw doctor de nuevo y lee la salida con cuidado.
Para openclaw update --channel dev en checkouts de código fuente, el actualizador inicializa automáticamente pnpm cuando hace falta. Si ves un error de inicialización de pnpm/corepack, instala pnpm manualmente (o vuelve a activar corepack) y ejecuta de nuevo la actualización.
Consulta: Solución de problemas
Pregunta en Discord: https://discord.gg/clawd

Relacionado

Resumen de instalación: todos los métodos de instalación.
Doctor: comprobaciones de salud después de las actualizaciones.
Migración: guías de migración de versiones principales.

Was this useful?

Actualizando

Recomendado: `openclaw update`

Cambiar entre instalaciones npm y git

Alternativa: volver a ejecutar el instalador

Alternativa: npm, pnpm o bun manual

Temas avanzados de instalación npm

Actualizador automático

Después de actualizar

Ejecutar doctor

Reiniciar el Gateway

Verificar

Reversión

Fijar una versión (npm)

Fijar un commit (código fuente)

Si estás atascado

Relacionado

On this page

Molty

Recomendado: openclaw update

Cambiar entre instalaciones npm y git

Alternativa: volver a ejecutar el instalador

Alternativa: npm, pnpm o bun manual

Temas avanzados de instalación npm

Actualizador automático

Después de actualizar

Ejecutar doctor

Reiniciar el Gateway

Verificar

Reversión

Fijar una versión (npm)

Fijar un commit (código fuente)

Si estás atascado

Relacionado

On this page

Recomendado: `openclaw update`