Saltar al contenido principal

​
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 la gateway. 
openclaw update
Para cambiar de canal o apuntar a una versión específica: 
openclaw update --channel beta
openclaw update --tag main
openclaw update --dry-run   # vista previa sin aplicar
--channel beta prioriza beta, pero el entorno de ejecución recurre 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 raw npm beta dist-tag para una actualización puntual del paquete. Consulta Canales de desarrollo para la semántica de canales.

​
Alternativa: volver a ejecutar el instalador

curl -fsSL https://openclaw.ai/install.sh | bash
Añade --no-onboard para omitir la incorporación guiada. Para instalaciones desde código fuente, pasa --install-method git --no-onboard.

​
Alternativa: npm, pnpm o bun manual

npm i -g openclaw@latest

pnpm add -g openclaw@latest

bun add -g openclaw@latest

​
Actualizador automático

El actualizador automático está desactivado de forma predeterminada. Habilítalo en ~/.openclaw/openclaw.json: 
{
  update: {
    channel: "stable",
    auto: {
      enabled: true,
      stableDelayHours: 6,
      stableJitterHours: 12,
      betaCheckIntervalHours: 1,
    },
  },
}
CanalComportamiento
stableEspera stableDelayHours, luego aplica con jitter determinista a lo largo de stableJitterHours (despliegue gradual).
betaComprueba cada betaCheckIntervalHours (predeterminado: cada hora) y aplica de inmediato.
devSin aplicación automática. Usa openclaw update manualmente.
La gateway también registra una sugerencia de actualización al iniciarse (desactívala con update.checkOnStart: false).

​
Después de actualizar

1
Ejecutar doctor
2
openclaw doctor
3
Migra la configuración, audita las políticas de MD y comprueba el estado de la gateway. Detalles: Doctor
4
Reiniciar la gateway
5
openclaw gateway restart
6
Verificar
7
openclaw health

​
Reversión

​
Fijar una versión (npm)

npm i -g openclaw@<version>
openclaw doctor
openclaw gateway restart
Consejo: npm view openclaw version muestra la versión publicada actual.

​
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 última versión: git checkout main && git pull.

​
Si estás atascado

  • Ejecuta openclaw doctor de nuevo y lee la salida con atención.
  • Para openclaw update --channel dev en copias del 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 ejecuta la actualización de nuevo.
  • Consulta: Resolución de problemas
  • Pregunta en Discord: https://discord.gg/clawd

​
Relacionado