Mantén tu Gateway sano con openclaw doctor

¿Alguna vez has sentido que tu configuración debería funcionar pero simplemente no lo hace? A veces pasas demasiado tiempo revisando archivos buscando un error tipográfico o una variable mal puesta. Es frustrante perder tiempo en problemas de entorno cuando podrías estar construyendo cosas nuevas.

Para esos momentos, la mejor opción es dejar que las herramientas trabajen por ti.

Requisitos previos

• Acceso a la CLI de OpenClaw.
• Gateway y canales instalados.

Inicio rápido

El comando doctor realiza chequeos de salud y aplica correcciones rápidas. Sigue estos pasos para limpiar tu entorno:

1. Ejecuta el diagnóstico básico:

   openclaw doctor

2. Si encuentras errores, usa el flag de reparación automática:

   openclaw doctor --repair

3. Para un análisis más exhaustivo, utiliza la opción profunda:

   openclaw doctor --deep

Ten en cuenta que --fix es un alias de --repair. Cuando usas este comando, el sistema genera un backup en ~/.openclaw/openclaw.json.bak y elimina las claves de configuración desconocidas, listando cada una de ellas.

Las solicitudes interactivas (como arreglos de OAuth o keychain) solo aparecen si usas una terminal TTY y no has activado el flag --non-interactive. En entornos automatizados como cron o Telegram, estos avisos se omiten.

Solución de problemas

Conflictos de variables en macOS

Si usas macOS y recibes errores de “unauthorized” que no desaparecen, es probable que existan variables de entorno en launchctl que sobreescriben tu archivo de configuración.

Verifica si tienes valores guardados:

launchctl getenv OPENCLAW_GATEWAY_TOKEN
launchctl getenv OPENCLAW_GATEWAY_PASSWORD

Si los comandos anteriores devuelven algún valor, elimínalos para recuperar el control de tu configuración:

launchctl unsetenv OPENCLAW_GATEWAY_TOKEN
launchctl unsetenv OPENCLAW_GATEWAY_PASSWORD

Ejecución en modo Headless

Si corres el comando en un entorno sin terminal, recuerda que el sistema saltará cualquier paso que requiera interacción humana. Asegúrate de configurar las credenciales correctamente antes de automatizar estas tareas.

Si necesitas ayuda adicional con tu configuración, consulta el AI Setup Assistant.

Próximos pasos

• Troubleshooting
• Security