Actualización de OpenClaw v2.0: Lista de Verificación Crítica Previo a la Actualización para Evitar Cambios Disruptivos

La Gran Actualización de OpenClaw Requiere Preparación Previa

OpenClaw ha lanzado su mayor actualización en meses con 12 cambios importantes, un sistema de complementos completamente nuevo y más de 30 parches de seguridad. La actualización romperá silenciosamente las configuraciones si los usuarios ejecutan npm update sin prepararse primero.

Paso 1: Verificar Variables de Entorno

Las variables de entorno heredadas de cuando OpenClaw se llamaba Clawdbot o Moltbot ya no funcionarán. No hay compatibilidad, respaldo o advertencia. Busca variables antiguas:

env | grep -i clawdbot
env | grep -i moltbot

Si aparece algo, cámbiales el nombre:

• CLAWDBOT_* → OPENCLAW_*
• MOLTBOT_* → OPENCLAW_*

Revisa tus archivos .env, .bashrc, .zshrc, .profile y cualquier archivo docker-compose. Las variables faltantes harán que OpenClaw se inicie con configuraciones predeterminadas en lugar de tu configuración.

Paso 2: Verificar Directorio de Estado

La detección automática del nombre antiguo del directorio ha desaparecido. Verifica tu directorio de estado actual:

ls ~/.moltbot 2>/dev/null && echo "NECESITAS MOVER ESTO"
ls ~/.openclaw 2>/dev/null && echo "estás bien"

Si todavía estás en ~/.moltbot, muévelo antes de actualizar:

mv ~/.moltbot ~/.openclaw

O establece la ruta explícitamente:

export OPENCLAW_STATE_DIR=~/.openclaw

Si actualizas primero, OpenClaw creará un directorio ~/.openclaw nuevo con configuración vacía.

Paso 3: Hacer Copia de Seguridad de tu Configuración

Crea una copia de seguridad antes de actualizar:

cp -r ~/.openclaw ~/.openclaw-backup-$(date +%Y%m%d)

Esto incluye tu SOUL.md, USER.md, MEMORY.md, configuración de agentes, habilidades y todo lo demás.

Paso 4: Verificar Configuración de Automatización del Navegador

El relé de la extensión de Chrome heredado se ha eliminado por completo. Si tu configuración del navegador usa driver: "extension" o browser.relayBindHost, esos ajustes ahora no hacen nada. Verifica tu configuración:

openclaw config get | grep -i browser

El nuevo enfoque utiliza la conexión a sesiones de navegador existentes. OpenClaw se conecta a un navegador que ya está en ejecución en lugar de controlar uno a través de una extensión. OpenClaw ahora gestiona su propio perfil de navegador (el perfil openclaw) o se conecta a una sesión de Chrome existente mediante CDP.

Paso 5: Comprender el Cambio de Clawhub

Clawhub es ahora la tienda predeterminada de complementos y habilidades. Cuando ejecutas openclaw plugins install o openclaw skills install, primero busca en Clawhub y solo recurre a npm si no encuentra el paquete allí. Esto significa:

• Algunas habilidades instaladas vía npm podrían necesitar reinstalarse vía Clawhub
• openclaw skills search, openclaw skills install y openclaw skills update son nuevos comandos que usan ClawHub de forma nativa
• Si una habilidad no está en Clawhub, aún puedes instalarla desde npm (es un respaldo, no una eliminación)

Después de actualizar, ejecuta:

openclaw skills update

Para asegurarte de que tus habilidades existentes estén sincronizadas con el nuevo sistema.