Validación estricta de configuración y migraciones con Doctor

¿Alguna vez has pasado horas depurando un error solo para descubrir que tenías una errata en el archivo de configuración? Es frustrante cuando un sistema ignora parámetros incorrectos en silencio o intenta aplicar cambios automáticos que terminan rompiendo otros componentes.

Mantener la estabilidad de un Gateway requiere que cada pieza encaje con precisión. En lugar de permitir que los errores pasen desapercibidos, OpenClaw ahora exige que tu configuración sea exacta desde el primer momento, deteniendo cualquier ejecución que pueda poner en riesgo la integridad del sistema.

What You’ll Need

• Archivo de configuración del Gateway.
• Plugins con el manifest openclaw.plugin.json incluido.

Quick Start

Si quieres poner en marcha tu Gateway con el nuevo sistema de validación, sigue estos pasos:

1. Inicia el sistema: Al arrancar, OpenClaw ejecuta automáticamente un dry-run de doctor.
2. Revisa los errores: Si la configuración es inválida, el sistema bloqueará los comandos operativos y mostrará una lista de errores.
3. Corrige automáticamente: Ejecuta el comando openclaw doctor --fix para aplicar migraciones y eliminar claves desconocidas.
4. Verifica el estado: Confirma que todo está en orden con openclaw status.

Reglas de validación estricta

El sistema ya no permite el paso de claves desconocidas. La configuración debe coincidir con el schema en todos los niveles, tanto en la raíz como en objetos anidados. Si intentas usar una clave que no está definida, recibirás un error de validación.

Para los plugins, el control es igual de riguroso. Cada plugin debe tener un manifest openclaw.plugin.json con su propio JSON Schema. Si un plugin no tiene schema o su configuración es incorrecta, OpenClaw bloquea su carga y registra el fallo con la ruta específica del error.

Flujo de Doctor y bloqueo de comandos

El comando doctor es ahora el único responsable de las migraciones. Se han eliminado las migraciones automáticas durante la carga para evitar cambios inesperados en tus archivos.

Si tu configuración no es válida, OpenClaw entra en un modo restringido. En este estado, solo puedes usar comandos de diagnóstico:

• openclaw doctor
• openclaw logs
• openclaw health
• openclaw help
• openclaw status
• openclaw gateway status

Cualquier otro comando fallará con el mensaje: “Config invalid. Run openclaw doctor --fix.”

Troubleshooting

Error: Config invalid al iniciar el Gateway Esto ocurre porque el dry-run automático detectó problemas.

• Solución: Ejecuta openclaw doctor --fix. Esto aplicará las migraciones necesarias, eliminará las claves que no reconoce y escribirá el archivo actualizado.

Error: Plugin load blocked El plugin no se cargó porque falta el schema o la configuración es errónea.

• Solución: Verifica que el archivo openclaw.plugin.json del plugin incluya un JSON Schema válido y que los datos en plugins.entries.<id>.config coincidan con lo que el plugin espera.

¿Necesitas ayuda para configurar tus esquemas? Prueba nuestro AI Setup Assistant.

What’s Next

• Configuración de plugins
• Referencia de comandos CLI