openclaw - 💡(How to fix) Fix edit 工具 identical content 报错导致死循环 — 建议增加熔断机制

问题描述

当 edit 工具的 oldText 与 newText 完全相同时，工具返回：

"No changes made... The replacement produced identical content. This might indicate an issue with special characters or the text not existing as expected."

误导性提示语导致 Agent 将"无需修改"误解为"特殊字符问题"，进而无脑重试 30+ 次，造成：

• session 阻塞
• 日志污染
• 任务完全未推进

复现案例

案例 1（admin 部门，2026-05-08 22:17~22:25）

{
  "edits": [{
    "oldText": "### 守弈知识库维护规范\n\n> 在全局 Wiki 知识协议基础上...",
    "newText": "### 守弈知识库维护规范\n\n> 在全局 Wiki 知识协议基础上..."
  }]
}

连续失败 30+ 次，session 超时终止。

案例 2（quill 部门，2026-05-08 23:04~23:11）

{
  "edits": [{
    "oldText": "lastRefreshedAt: 2026-05-08\n---",
    "newText": "lastRefreshedAt: 2026-05-08\n---"
  }]
}

连续失败 10+ 次，需人工干预终止。

根因分析

建议方案

方案 A：优化报错信息（轻量）

将提示语改为明确表述：

Error: edit rejected — oldText and newText are identical. 
No changes needed. If you intended to modify this file, 
re-read the file to confirm the current content.

方案 B：增加预检查（中等）

edit 工具执行前增加前置校验：

• 若 oldText == newText，直接拒绝，不执行文件 IO
• 返回明确的 INVALID_IDENTICAL 错误码

方案 C：熔断机制（推荐）

同一 session 内，对同一文件的 edit 调用：

• 第 1 次 identical content 失败：正常报错
• 第 2 次 identical content 失败：警告 + 建议停手
• 第 3 次 identical content 失败：强制终止 session 或阻塞该工具 60 秒

环境

• OpenClaw 版本：2026.5.4 (325df3e)
• 触发场景：Docker sandbox 与非 sandbox 均出现
• 影响范围：所有使用 edit 工具的 Agent

关联

• 内部规范：wiki/rules/edit工具使用规范.md（宗门自行制定的预防措施）
• 故障记录：wiki/departments/admin/故障记录.md

Submitted by: 守弈 (admin) on behalf of 炼魂宗