Cómo actualizar OpenClaw

Mantener las herramientas de infraestructura actualizadas suele ser un proceso tedioso. A veces te preocupa que una actualización rompa tu configuración personalizada o que el flujo sea tan complejo que prefieras quedarte en una versión obsoleta.

OpenClaw se mueve rápido en su etapa pre-1.0. Lo ideal es tratar las actualizaciones como despliegues de infraestructura: actualiza, corre las verificaciones, reinicia y verifica que todo funcione.

Requisitos previos

• Saber cómo instalaste OpenClaw: global (npm/pnpm) o desde el código fuente (git clone).
• Identificar cómo corre tu Gateway: en una terminal o como un servicio supervisado (launchd/systemd).
• Hacer un snapshot de tu configuración (~/.openclaw/openclaw.json) y tus credenciales (~/.openclaw/credentials/).
• Asegurar que tu workspace (~/.openclaw/workspace) esté respaldado.

Inicio rápido

El camino recomendado es re-ejecutar el instalador desde el sitio web. Este detecta instalaciones existentes, actualiza en el sitio y ejecuta openclaw doctor si es necesario.

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

Si prefieres no ejecutar el asistente de configuración inicial de nuevo, añade el flag --no-onboard.

Actualización según tu instalación

Instalación global (npm o pnpm)

Si usas Node.js para gestionar OpenClaw, usa estos comandos:

npm i -g openclaw@latest
# o si prefieres pnpm
pnpm add -g openclaw@latest

No recomendamos usar Bun para el runtime del Gateway debido a bugs conocidos con WhatsApp y Telegram. Después de actualizar, ejecuta:

openclaw doctor
openclaw gateway restart
openclaw health

Instalación desde el código fuente (git)

Para quienes clonaron el repositorio, el comando openclaw update es la opción más segura. Este comando requiere que tu árbol de trabajo esté limpio, hace un fetch y rebase, instala dependencias y reconstruye la Control UI.

Si prefieres hacerlo manualmente desde el repo:

git pull
pnpm install
pnpm build
pnpm ui:build
openclaw doctor
openclaw health

Cambio de canales

Puedes moverte entre diferentes versiones de estabilidad fácilmente:

openclaw update --channel beta
openclaw update --channel stable

Siempre ejecuta: openclaw doctor

Este comando es la pieza central para una actualización segura. No solo verifica el estado, sino que realiza tareas esenciales:

• Migra claves de configuración obsoletas a las nuevas ubicaciones.
• Audita tus políticas de DM y te advierte sobre configuraciones abiertas riesgosas.
• Detecta y migra servicios de Gateway antiguos (como legacy schtasks) a los servicios actuales de OpenClaw.
• En Linux, asegura que el “user lingering” de systemd esté activo para que el Gateway no se detenga al cerrar tu sesión.

Solución de problemas

• Bugs en WhatsApp/Telegram: Si experimentas comportamientos extraños en estos protocolos, verifica que no estés usando Bun como runtime.
• Fallo en el rebase (Git): Si openclaw update falla al intentar unir el código, el Gateway abortará la operación y reiniciará con la versión anterior sin aplicar cambios.
• El Gateway no inicia tras actualizar: Ejecuta openclaw doctor. A menudo, el problema es una migración de configuración pendiente que el comando puede resolver automáticamente.
• Servicio no responde: Si usas un servicio supervisado, prefiere openclaw gateway restart en lugar de matar procesos manualmente para evitar conflictos de PIDs.

Rollback (Volver atrás)

Si algo se rompe, puedes regresar a una versión conocida.

Para instalaciones globales:

npm i -g openclaw@<versión>
openclaw doctor
openclaw gateway restart

Para instalaciones desde fuente (por fecha):

git fetch origin
git checkout "$(git rev-list -n 1 --before="2026-01-01" origin/main)"
pnpm install
pnpm build
openclaw gateway restart

¿Necesitas ayuda específica con tu configuración? Prueba el AI Setup Assistant.

Próximos pasos

• Gateway runbook
• Doctor CLI reference
• Development channels
• Troubleshooting guide