Configura la detección de bucles en OpenClaw

¿Alguna vez has visto a un agente entrar en un bucle infinito, llamando a la misma herramienta una y otra vez sin llegar a ninguna parte? Es frustrante y, sobre todo, caro. Nadie quiere despertar con una factura enorme de tokens porque un proceso se quedó atascado en un error repetitivo o en un patrón sin salida.

OpenClaw puede evitar que los agentes se queden atrapados en estos patrones repetitivos de llamadas a herramientas. Esta protección está desactivada por defecto. Actívala solo donde sea necesario, ya que una configuración muy estricta podría bloquear llamadas repetidas que sí son legítimas.

Por qué existe esto

• Detectar secuencias repetitivas que no generan progreso.
• Detectar bucles de alta frecuencia sin resultados (misma herramienta, mismos inputs, errores repetidos).
• Detectar patrones específicos de llamadas repetidas para herramientas de polling conocidas.

Bloque de configuración

Valores globales por defecto:

{
  tools: {
    loopDetection: {
      enabled: false,
      historySize: 20,
      detectorCooldownMs: 12000,
      repeatThreshold: 3,
      criticalThreshold: 6,
      detectors: {
        repeatedFailure: true,
        knownPollLoop: true,
        repeatingNoProgress: true,
      },
    },
  },
}

Anulación por agente (opcional):

{
  agents: {
    list: [
      {
        id: "safe-runner",
        tools: {
          loopDetection: {
            enabled: true,
            repeatThreshold: 2,
            criticalThreshold: 5,
          },
        },
      },
    ],
  },
}

Comportamiento de los campos

• enabled: Interruptor principal. false significa que no se realiza ninguna detección de bucles.
• historySize: Número de llamadas a herramientas recientes que se guardan para el análisis.
• detectorCooldownMs: Ventana de tiempo utilizada por el detector de falta de progreso.
• repeatThreshold: Mínimo de repeticiones antes de que comience el aviso o el bloqueo.
• criticalThreshold: Umbral más fuerte que puede activar un manejo más estricto.
• detectors.repeatedFailure: Detecta intentos fallidos repetidos en la misma ruta de llamada.
• detectors.knownPollLoop: Detecta bucles conocidos de tipo sondeo (polling).
• detectors.repeatingNoProgress: Detecta llamadas repetidas de alta frecuencia sin cambios de estado.

Configuración recomendada

• Empieza con enabled: true y mantén los valores por defecto.
• Si ocurren falsos positivos:
  • Aumenta repeatThreshold o criticalThreshold.
  • Desactiva solo el detector que esté causando problemas.
  • Reduce historySize para tener un contexto histórico menos estricto.

Logs y comportamiento esperado

Cuando se detecta un bucle, OpenClaw reporta un evento de bucle y bloquea o mitiga el siguiente ciclo de herramientas dependiendo de la gravedad. Esto te protege de un gasto descontrolado de tokens y de bloqueos, mientras preserva el acceso normal a las herramientas.

• Se prefiere el aviso y la supresión temporal primero.
• Se escala solo cuando se acumula evidencia repetida.

Notas

• tools.loopDetection se combina con las anulaciones a nivel de agente.
• La configuración por agente anula o extiende completamente los valores globales.
• Si no existe ninguna configuración, las protecciones permanecen apagadas.

Pasos siguientes

• Configuración de agentes
• Uso de herramientas

AI Setup Assistant