OpenClaw从入门到应用——工具(Tools):工具循环检测
通过OpenClaw实现副业收入《OpenClaw赚钱实录从“养龙虾“到可持续变现的实践指南》工具循环检测配置可选的防护措施以防止重复或停滞的工具调用循环工具循环检测OpenClaw 可以防止代理陷入重复的工具调用模式。该防护措施默认处于禁用状态。仅在需要时启用因为在严格设置下它可能会阻止合法的重复调用。存在原因检测无进展的重复序列。检测高频无结果循环相同工具、相同输入、重复错误。检测已知轮询工具的特定重复调用模式。配置块全局默认值{ tools: { loopDetection: { enabled: false, historySize: 30, warningThreshold: 10, criticalThreshold: 20, globalCircuitBreakerThreshold: 30, detectors: { genericRepeat: true, knownPollNoProgress: true, pingPong: true, }, }, }, }每个代理的覆盖配置可选{ agents: { list: [ { id: safe-runner, tools: { loopDetection: { enabled: true, warningThreshold: 8, criticalThreshold: 16, }, }, }, ], }, }字段行为enabled总开关。设为false则不执行任何循环检测。historySize保留用于分析的最近工具调用数量。warningThreshold将模式分类为仅警告之前的阈值。criticalThreshold阻止重复循环模式的阈值。globalCircuitBreakerThreshold全局无进展断路器的阈值。detectors.genericRepeat检测重复的相同工具 相同参数模式。detectors.knownPollNoProgress检测无状态变化的已知轮询类模式。detectors.pingPong检测交替的乒乓模式。推荐设置从enabled: true开始保持默认值不变。保持阈值顺序为warningThreshold criticalThreshold globalCircuitBreakerThreshold。如果出现误报提高warningThreshold和/或criticalThreshold可选提高globalCircuitBreakerThreshold仅禁用导致问题的检测器减少historySize以放宽历史上下文限制日志与预期行为当检测到循环时OpenClaw 会报告循环事件并根据严重程度阻止或抑制下一个工具周期。这可以保护用户免受失控的令牌消耗和死锁的影响同时保留正常的工具访问。优先使用警告和临时抑制。仅在积累重复证据时才升级处理。注意事项tools.loopDetection会与代理级别的覆盖配置合并。每个代理的配置会完全覆盖或扩展全局值。如果不存在配置防护措施将保持关闭状态。构建于 Mintlify