Solución de problemas de OpenClaw: Un método de reinicio minimalista

Procedimiento de Reinicio de OpenClaw para Configuraciones Inestables

Cuando las configuraciones de OpenClaw se vuelven inestables—con habilidades consumiendo tokens innecesariamente, agentes reportando finalizaciones falsas o actualizaciones que rompen conexiones—un reinicio completo a una configuración mínima puede identificar la causa raíz. Este enfoque aísla los problemas eliminando la complejidad.

Proceso de Reinicio en Cinco Pasos

Paso 1: Eliminar Todas las Habilidades (60 segundos)

Mueve todas las habilidades a una copia de seguridad para eliminar fuentes comunes de inestabilidad como bucles silenciosos, consumo excesivo de tokens, inyección de contexto, sobrescritura de configuraciones o malware:

mkdir ~/.openclaw/skills-backup
mv ~/.openclaw/agents/*/skills/* ~/.openclaw/skills-backup/

Esto preserva las habilidades para una restauración posterior mientras se prueba la funcionalidad básica del agente.

Paso 2: Cambiar a Claude Sonnet (30 segundos)

Cambia la configuración del modelo de IA para eliminar problemas relacionados con el modelo:

{
  "ai": {
    "model": "claude-sonnet-4-5-20250929"
  }
}

Se recomienda Sonnet por ser económico, confiable y consistente con el uso de herramientas. Si tu configuración funciona con Sonnet pero no con Opus, GPT-5.4 o modelos locales, el modelo era el problema.

Paso 3: Borrar Sesiones (15 segundos)

Elimina el historial de conversaciones potencialmente corrupto:

rm -rf ~/.openclaw/agents/*/sessions/*

Esto no afecta a SOUL.md, memoria, USER.md o configuraciones permanentes—solo a los datos de sesión que pueden corromperse después de actualizaciones o cambios de modelo.

Paso 4: Simplificar SOUL.md (60 segundos)

Revisa tu SOUL.md actual y reemplázalo con una versión mínima si es necesario:

cat ~/.openclaw/agents/*/SOUL.md

Reemplázalo con esta versión de 5 líneas:

sé directo. sin relleno. adapta tu tono al mío.
si hago una pregunta, respóndela primero.
nunca digas "absolutamente", "gran pregunta" o "me encantaría".
si no sabes algo, dilo.
si una tarea costará muchos tokens, avísame antes de hacerla.

Añade más instrucciones gradualmente basándote en lo que te moleste durante la próxima semana.

Paso 5: Reiniciar y Probar (30 segundos)

Reinicia OpenClaw y envía un mensaje básico:

openclaw stop
openclaw start

Prueba con consultas simples como "¿qué día es hoy?" o "resume este artículo" con una URL. Si responde correctamente sin comportamientos extraños, tu configuración básica funciona. Los problemas provenían de lo que eliminaste. Añade componentes de vuelta uno por uno, probando después de cada adición.

Por Qué Funciona Esto

La mayoría de las configuraciones de OpenClaw acumulan habilidades, agentes, tareas programadas, cambios de modelo y ajustes de configuración hasta que un componente causa el colapso. Como todo se añadió simultáneamente, identificar la pieza problemática se vuelve imposible. Reducir a una configuración mínima y reconstruir incrementalmente crea configuraciones estables.

Después de implementar este reinicio, un usuario reportó una configuración estable con un agente, Sonnet y cuatro habilidades (búsqueda web, resumen diario, tomador de notas y un script personalizado de Python para filtrar correos) que costaba menos de $10 al mes y funcionaba sin problemas durante más de cuatro semanas.