Lista de Verificación para la Actualización de OpenClaw 3.22: Pasos Prácticos de un Desarrollador que Aprendió por las Malas

Antes de actualizar a OpenClaw 3.22

Revisa tu archivo .env en busca de cualquier variable con prefijo CLAWDBOT_ o MOLTBOT_. La versión 3.22 eliminó todas estas variables sin respaldo ni compatibilidad. Si las tienes, tu agente no se iniciará y el mensaje de error no será útil. Primero renombra todo a OPENCLAW_. Si configuraste OpenClaw antes de mediados de febrero, casi seguro que tienes al menos una de estas variables.

Ejecuta openclaw backup create antes de tocar nada. Considera etiquetar tu imagen actual de Docker como :pre-upgrade para poder revertir al instante si es necesario.

Después de actualizar a OpenClaw 3.22

Ejecuta openclaw doctor --fix, que detecta automáticamente la mayoría de las migraciones de configuración.

Revisa /tools en cualquier canal para ver qué herramientas están realmente disponibles. La versión 3.22 cambió la superficie del SDK de complementos (pasó de openclaw/extension-api a openclaw/plugin-sdk/*), por lo que los complementos de terceros que usen rutas de importación antiguas simplemente no se cargarán en silencio.

Ejecuta openclaw secrets audit para encontrar claves API en texto plano en tu espacio de trabajo. El desarrollador encontró dos que estaban completamente olvidadas, guardadas en archivos de configuración de habilidades.

Nuevas características en 3.22

• Conversaciones laterales con /btw
• Instalación nativa de ClawHub desde CLI (openclaw skills install en lugar de descargar manualmente archivos skill.md)
• Limpieza de sesiones inactivas
• Reintentos escalonados de cron para que un trabajo fallido no agote tu presupuesto de API durante la noche
• Tiempo de espera del agente de 48 horas en lugar de 10 minutos, lo que significa que las tareas largas ahora realmente se completan

El desarrollador recomienda presupuestar 30-45 minutos para una actualización cuidadosa en lugar de asumir que será fluida, señalando que una vez terminada, "es genuinamente mejor".