Claw Runaway Loop Detector
/install claw-runaway-loop-detector
Claw Runaway Loop Detector
Detect infinite loops and runaway token usage risks in Claw AI workflows.
AI agents built with Claw can sometimes enter unintended loops when tools retry repeatedly, tasks recurse, or prompts encourage repeated exploration. These loops can rapidly generate massive token usage and unexpectedly high API costs.
This skill analyzes a Claw workflow or prompt and identifies patterns that could lead to runaway loops.
Example input
Agent searches the web for competitor pricing and keeps retrying the search tool until it finds reliable data.
or
Agent reviews documents, summarizes them, and retries the summarization tool until the result improves.
How to use
Paste your Claw workflow, task description, or agent prompt.
The detector will analyze the workflow and identify potential loop risks that could lead to runaway token usage.
Analysis instructions
You are an AI agent reliability and cost analysis expert.
Analyze the provided Claw workflow or prompt and detect patterns that could cause an agent to repeatedly execute tasks, retry tools, or recursively call itself.
Focus on identifying conditions that could create runaway loops and excessive token usage.
Analysis process
When analyzing the workflow:
- Identify potential loop triggers.
- Check whether termination conditions exist.
- Evaluate retry or recursion patterns.
- Estimate possible token amplification if the loop occurs.
- Assign an overall runaway loop risk level.
Common runaway loop patterns
The detector looks for common patterns including:
- Recursive agent calls
- Unbounded retry logic
- Prompts encouraging repeated exploration
- Tool retry chains
- Missing termination conditions
- Long reasoning chains without limits
Risk level guidelines
Low The workflow has clear termination conditions and limited retries.
Medium The workflow contains retry logic or open-ended exploration but appears somewhat bounded.
High The workflow may repeatedly call tools, recurse tasks, or lacks clear stopping conditions.
Output format
Output must follow this structure:
Runaway Loop Risk Analysis
Risk level: (Low / Medium / High)
Loop triggers detected: (list)
Estimated token amplification: (short explanation)
Estimated token impact: (range)
Recommended safeguards: (list)
Example Output
Runaway Loop Risk Analysis
Risk level: High
Loop triggers detected:
- Tool retry pattern without limit
- Prompt encourages repeated searching
Estimated token amplification: The agent may repeatedly call the search tool until success, causing exponential token growth.
Estimated token impact: 10k – 50k tokens per run if the loop occurs.
Recommended safeguards:
- Limit tool retries to 3
- Add explicit termination conditions
- Restrict recursive agent calls
- Set maximum reasoning steps
Why this matters
Runaway loops are one of the most common causes of unexpected AI API costs.
A single workflow mistake can cause an agent to repeatedly call tools or itself, generating thousands of tokens per minute.
Detecting these patterns early helps prevent runaway token usage before deploying agents to production.
Tip
In production environments, it is useful to combine loop detection with automated safeguards such as token limits, retry limits, and behavior monitoring.
Gateways such as ClawFirewall can automatically stop abnormal loops and protect your API budget.
License
MIT-0
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install claw-runaway-loop-detector - 安装完成后,直接呼叫该 Skill 的名称或使用
/claw-runaway-loop-detector触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Claw Runaway Loop Detector 是什么?
Detects potential infinite loops and runaway token usage risks in Claw AI workflows by analyzing retry, recursion, and termination conditions. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 255 次。
如何安装 Claw Runaway Loop Detector?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install claw-runaway-loop-detector」即可一键安装,无需额外配置。
Claw Runaway Loop Detector 是免费的吗?
是的,Claw Runaway Loop Detector 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Claw Runaway Loop Detector 支持哪些平台?
Claw Runaway Loop Detector 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Claw Runaway Loop Detector?
由 ShowMeTheMoney2023(@showmethemoney2023)开发并维护,当前版本 v1.0.0。