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 canal o apuntar a una versión específica:

bash

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

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

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

Para plugins administrados, la alternativa del canal beta es una advertencia: la actualización principal puede seguir completándose correctamente mientras un plugin usa su versión default/latest registrada porque no hay una beta del plugin disponible.

Consulta Canales de desarrollo para ver 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 área de trabajo en ~/.openclaw; solo cambia qué instalación de 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

Ejecuta 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 de 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, a menos que pases --no-restart.

Alternativa: volver a ejecutar el instalador

bash

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

Agrega --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 actualizada parcialmente.

bash

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

Para fijar la recuperación a una versión específica o dist-tag, agrega --version:

bash

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

Alternativa: npm, pnpm o bun manuales

bash

npm i -g openclaw@latest

Prefiere openclaw update para instalaciones supervisadas porque puede coordinar el cambio de paquete con el servicio Gateway en ejecución. Si actualizas manualmente mientras se está ejecutando un Gateway gestionado, reinicia el Gateway inmediatamente después de que el gestor de paquetes termine para que el proceso antiguo no siga sirviendo desde archivos de paquete reemplazados.

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 antiguo. Si el comando de instalación falla, OpenClaw lo reintenta una vez con --omit=optional. Ese reintento ayuda a hosts donde las dependencias opcionales nativas no pueden compilarse, a la vez que mantiene visible el fallo original si la alternativa también falla.

bash

pnpm add -g openclaw@latest

bash

bun add -g openclaw@latest

Temas avanzados de instalación con npm

Read-only package tree

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

Algunas configuraciones de npm en Linux instalan paquetes globales en 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 de paquete global.

Unidades systemd reforzadas

Otorga 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 conservar 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 realizar una comprobación de espacio en disco de mejor esfuerzo para el volumen de destino. Si hay poco espacio, se genera una advertencia con la ruta comprobada, pero no se 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 la fuente de autoridad.

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 inmediatamente.
`dev`	No se aplica automáticamente. Usa `openclaw update` manualmente.

El Gateway también registra una sugerencia de actualización al iniciar (desactívala con update.checkOnStart: false). Para una reversión a una versión anterior o recuperación ante incidentes, establece 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 inicio 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 en vivo del Gateway fuerzan un reinicio de actualización no diferido y sin periodo de espera después del intercambio de paquetes. Eso evita dejar un proceso antiguo en memoria el tiempo suficiente para cargar de forma diferida fragmentos desde un árbol de paquetes que ya ha sido reemplazado. El comando de shell openclaw update sigue siendo la ruta preferida para instalaciones supervisadas porque puede detener y reiniciar el servicio durante la actualización.

Después de actualizar

Ejecutar doctor

bash

openclaw doctor

Migra la configuración, audita las políticas de DM y comprueba el estado 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 versión más reciente: git checkout main && git pull.

Si estás bloqueado

Ejecuta openclaw doctor de nuevo y lee la salida con atención.
Para openclaw update --channel dev en checkouts de código fuente, el actualizador inicializa automáticamente pnpm cuando es necesario. Si ves un error de inicialización de pnpm/corepack, instala pnpm manualmente (o vuelve a habilitar corepack) y vuelve a ejecutar 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 estado después de las actualizaciones.
Migración: guías de migración de versiones principales.

Was this useful?

Recomendado: openclaw update

Cambiar entre instalaciones npm y git

Alternativa: volver a ejecutar el instalador

Alternativa: npm, pnpm o bun manuales

Temas avanzados de instalación con 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 bloqueado

Relacionado

Recomendado: `openclaw update`