Mantén OpenClaw actualizado.Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
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.
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.
--dry-run para previsualizar el cambio exacto de modo de instalación:
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
--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.
--version:
Alternativa: npm, pnpm o bun manuales
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.
Temas avanzados de instalación con npm
Read-only package tree
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
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:
Comprobación previa de espacio en disco
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:
| 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. |
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
Migra la configuración, audita las políticas de DM y comprueba el estado del gateway. Detalles: Doctor
Reversión
Fijar una versión (npm)
Fijar un commit (código fuente)
git checkout main && git pull.
Si estás bloqueado
- Ejecuta
openclaw doctorde nuevo y lee la salida con atención. - Para
openclaw update --channel deven checkouts de código fuente, el actualizador inicializa automáticamentepnpmcuando es necesario. Si ves un error de inicialización de pnpm/corepack, instalapnpmmanualmente (o vuelve a habilitarcorepack) 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.