Migración de flota a OpenClaw 2.0: Qué se rompió realmente

Actualizar una sola instancia de OpenClaw es una cosa, pero hacerlo para una flota de clientes en vivo significa que cada error se multiplica. Un equipo pasó un día entero migrando a OpenClaw 2.0 y compartió los bordes más afilados. Esto es lo que realmente se rompió y cómo evitarlo.

El Esquema de Configuración se Volvió Más Estricto

En 2.0, el esquema de configuración es más estricto y varios campos se movieron (claves de entorno, TTS, modelos de medios). La trampa más grande: doctor --fix elimina silenciosamente campos desconocidos. Si tu clave de modelo está en un área que ahora está obsoleta, puede desaparecer junto con esos campos. El equipo reescribió las configuraciones a mano antes de ejecutar doctor para no perder claves.

Los Plugins Externos Rompen la Puerta de Enlace

WhatsApp, Brave, Discord y Perplexity ya no están en la imagen central; son plugins externos. Si tu configuración todavía hace referencia a ellos, la puerta de enlace nunca se vuelve lista, el contenedor entra en un bucle de reinicio y desde afuera parece un error 502. Simplemente agregar los plugins a la imagen no es suficiente porque el consentimiento de capacidades está vinculado a la máquina específica, y doctor no lo acepta. El único enfoque que funciona es ejecutar openclaw plugins install ... --accept-capabilities como un paso separado.

Emparejamiento de Dispositivos: Las Cabeceras de Cloudflare Rompen la Localidad

El chat web comenzó a mostrar PAIRING_REQUIRED. La causa raíz: 2.0 solo confía en solicitudes desde loopback sin cabeceras reenviadas. No configurarlas en nginx no es suficiente: Cloudflare envía sus propias cabeceras, por lo que debes anularlas explícitamente en nginx. Esto parecía un token roto, pero en realidad era un conflicto entre Cloudflare, nginx y la lógica de localidad de OpenClaw.

Perplexity se Auto-Carga No Deseado

Perplexity se auto-cargará si detecta una clave de OpenRouter, y luego exige consentimiento incluso si no quieres el plugin. Configurar enabled: false no ayuda; debes usar plugins.deny para bloquearlo.

Conclusión: Prioriza el Tiempo de Actividad Sobre las Funciones

El principio final: es mejor perder temporalmente la búsqueda web o un canal individual que dejar caer todo el agente con un error 502. Planifica múltiples rupturas y prueba cada componente individualmente.

Esto se basa en un informe real de migración de una plataforma en la nube que aloja OpenClaw para clientes. Si estás planeando una actualización, lee la fuente para más detalles y perspectivas de la comunidad.