--- read_when: - Actualizar OpenClaw - Algo deja de funcionar después de una actualización summary: Actualizar OpenClaw de forma segura (instalación global o desde el código fuente), más estrategia de reversión title: Actualizando x-i18n: generated_at: "2026-05-11T20:41:02Z" model: gpt-5.5 provider: openai source_hash: cb1506ed87b1cf2e4928987c9dbfaff17d47b87f6c18239d694e0f55deb609f7 source_path: install/updating.md workflow: 16 --- 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 beta openclaw update --channel dev openclaw update --tag main openclaw 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](/es/install/development-channels) 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 checkout openclaw update --channel dev # git checkout -> npm package install openclaw update --channel stable ``` Ejecuta primero con `--dry-run` para previsualizar el cambio exacto de modo de instalación: ```bash openclaw update --channel dev --dry-run openclaw 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 ``` ## 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 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. 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 ``` 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](/es/gateway/doctor) ### Reiniciar el gateway ```bash openclaw gateway restart ``` ### Verificar ```bash openclaw health ``` ## Reversión ### Fijar una versión (npm) ```bash npm i -g openclaw@ openclaw doctor openclaw gateway restart ``` `npm view openclaw version` muestra la versión publicada actual. ### Fijar un commit (código fuente) ```bash git fetch origin git checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)" pnpm install && pnpm build openclaw 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](/es/gateway/troubleshooting) - Pregunta en Discord: [https://discord.gg/clawd](https://discord.gg/clawd) ## Relacionado - [Resumen de instalación](/es/install): todos los métodos de instalación. - [Doctor](/es/gateway/doctor): comprobaciones de estado después de las actualizaciones. - [Migración](/es/install/migrating): guías de migración de versiones principales.