[调研] OpenClaw 解锁模型乱调工具问题汇总

背景

有人反映在 OpenClaw 中使用 unlocked/uncensored 模型时，agent 会胡乱调用工具、陷入无限循环。本文汇总社区讨论和研究结论。

结论（先说）

根因：OpenClaw 默认没有熔断机制，unlocked 模型对工具调用约束更弱，两者叠加导致工具乱调用/循环调用。

问题表现

1. 工具幻觉：模型调用不存在的工具，或传入错误参数
2. 无限循环：工具调用失败后返回模糊结果，模型误判为"需要重试"而非"已失败"，反复调用同一工具
3. 失控级联：失败后 agent 自主发起一连串 fallback 策略（换工具、换搜索、重试），每次都消耗 token

社区案例：有人记录到同一搜索被调用 47 次，单次会话花费 $12，最终无输出，手动终止。

根因分析

OpenClaw 的 agentic loop 设计：LLM 推理 → 工具执行 → 结果写回上下文 → 继续推理。

问题在于：

• 工具调用失败时，返回值往往是"模糊的部分结果"而非干净的错误
• 模型（尤其是 unlocked 模型）把模糊结果解读为"任务未完成，继续重试"
• 默认配置没有 max_iterations 限制，循环无上限

arxiv 论文 Clawdrain (2603.00902) 进一步发现：失败路径比成功路径消耗更多 token——agent 失败后会自主发起 fallback 级联，token 消耗反而更高（~9× vs ~6-7×）。

缓解方案

1. 加 max_iterations（最直接）

{
  "agents": {
    "defaults": {
      "max_iterations": 15,
      "on_maxiterations": "escalate_to_user"
    }
  }
}

2. SOUL.md 加停止指令

如果一个工具调用连续失败两次，立即停止重试并报告情况。
如果同一步骤尝试超过三种方法仍未成功，向用户请求指导。

3. AGENTS.md 列出工具白名单

对 unlocked 模型尤其重要——明确列出可用工具，防止幻觉出不存在的工具。

4. 单工具超时配置

{
  "tools": {
    "web_search": { "timeout_seconds": 30, "max_retries": 2 },
    "bash": { "timeout_seconds": 60, "max_retries": 0 }
  }
}

参考来源

• GitHub issue #19758：上下文裁剪后工具调用丢失
• roborhythms.com：循环根因与五种修复方案
• markaicode.com：工具幻觉的三种模式与防护
• arxiv 2603.00902：Clawdrain 论文，揭示失败路径更贵的反直觉结论