Actualización

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.

openclaw update

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

openclaw update --channel beta
openclaw update --channel dev
openclaw update --tag main
openclaw update --dry-run   # vista previa sin aplicar

openclaw update no acepta --verbose. Para diagnósticos de actualización, usa --dry-run para obtener una vista previa de las acciones planificadas, --json para resultados estructurados, o openclaw update status --json para inspeccionar el canal y el estado 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 anterior a la versión estable más reciente. Usa --tag beta si quieres el dist-tag beta de npm sin procesar para una actualización puntual del paquete.

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

# Cambiar entre instalaciones de 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 de código de OpenClaw usan la CLI y el Gateway.

# instalación de paquete npm -> checkout git editable
openclaw update --channel dev

# checkout git -> instalación de paquete npm
openclaw update --channel stable

Ejecuta primero con --dry-run para obtener una vista previa del cambio exacto de modo de instalación:

openclaw update --channel dev --dry-run
openclaw 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.

# Alternativa: volver a ejecutar el instalador

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.

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ífico, añade --version:

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

# Alternativa: npm, pnpm o bun manual

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 administrado, 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 administra una instalación global de npm, instala primero el destino en un prefijo temporal de npm, verifica el inventario dist empaquetado y luego cambia el árbol de paquetes limpio al 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 lo reintenta una vez con --omit=optional. Ese reintento ayuda en hosts donde las dependencias opcionales nativas no pueden compilarse, mientras mantiene visible el fallo original si el fallback también falla.

pnpm add -g openclaw@latest

bun add -g openclaw@latest

# Temas avanzados de instalación npm

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

# Actualizador automático

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

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

El Gateway también registra una sugerencia de actualización al iniciar (desactívala con update.checkOnStart: false). Para degradación de versión 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 handler del plano de control del Gateway en vivo fuerzan un reinicio de actualización no diferido y sin periodo de espera después del cambio de paquete. 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 alrededor de la actualización.

# Después de actualizar

openclaw doctor

openclaw gateway restart

openclaw health

# Reversión

# Fijar una versión (npm)

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

# Fijar un commit (código fuente)

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 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 salud después de actualizaciones.
• Migración: guías de migración de versiones mayores.