OpenClaw can keep agents from getting stuck in repeated tool-call patterns. Enable it only where needed, because it can block legitimate repeated calls with strict settings.<\/p>\n Global defaults:<\/p>\n “`json5 theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}} When a loop is detected, OpenClaw reports a loop event and blocks or dampens the next tool-cycle depending on severity. Tool-loop detection OpenClaw can keep agents from getti […]<\/p>\n","protected":false},"author":0,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[],"class_list":["post-643","post","type-post","status-publish","format-standard","hentry","category-docs"],"_links":{"self":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/643","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/comments?post=643"}],"version-history":[{"count":2,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/643\/revisions"}],"predecessor-version":[{"id":709,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/643\/revisions\/709"}],"wp:attachment":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/media?parent=643"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/categories?post=643"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/tags?post=643"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
\nThe guard is disabled by default<\/strong>.<\/p>\nWhy this exists<\/h2>\n
\n
Configuration block<\/h2>\n
\n{
\n tools: {
\n loopDetection: {
\n enabled: false,
\n historySize: 30,
\n warningThreshold: 10,
\n criticalThreshold: 20,
\n globalCircuitBreakerThreshold: 30,
\n detectors: {
\n genericRepeat: true,
\n knownPollNoProgress: true,
\n pingPong: true,
\n },
\n },
\n },
\n}<\/p>\n\nPer-agent override (optional):\n\n```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}\n{\n agents: {\n list: [\n {\n id: "safe-runner",\n tools: {\n loopDetection: {\n enabled: true,\n warningThreshold: 8,\n criticalThreshold: 16,\n },\n },\n },\n ],\n },\n}\n<\/code><\/pre>\nField behavior<\/h3>\n
\n
enabled<\/code>: Master switch. false<\/code> means no loop detection is performed.<\/li>\nhistorySize<\/code>: number of recent tool calls kept for analysis.<\/li>\nwarningThreshold<\/code>: threshold before classifying a pattern as warning-only.<\/li>\ncriticalThreshold<\/code>: threshold for blocking repetitive loop patterns.<\/li>\nglobalCircuitBreakerThreshold<\/code>: global no-progress breaker threshold.<\/li>\ndetectors.genericRepeat<\/code>: detects repeated same-tool + same-params patterns.<\/li>\ndetectors.knownPollNoProgress<\/code>: detects known polling-like patterns with no state change.<\/li>\ndetectors.pingPong<\/code>: detects alternating ping-pong patterns.<\/li>\n<\/ul>\nRecommended setup<\/h2>\n
\n
enabled: true<\/code>, defaults unchanged.<\/li>\nwarningThreshold < criticalThreshold < globalCircuitBreakerThreshold<\/code>.<\/li>\nwarningThreshold<\/code> and\/or criticalThreshold<\/code><\/li>\nglobalCircuitBreakerThreshold<\/code><\/li>\nhistorySize<\/code> for less strict historical context<\/li>\n<\/ul>\nLogs and expected behavior<\/h2>\n
\nThis protects users from runaway token spend and lockups while preserving normal tool access.<\/p>\n\n
Notes<\/h2>\n
\n
tools.loopDetection<\/code> is merged with agent-level overrides.<\/li>\n