- name
- er-ge-config-safe-edit
- description
- 安全修改配置文件的系统性流程。当需要修改 openclaw.json、models.json、或其他任何系统配置文件时激活。核心价值：改前备份 + 版本对比 + 确认差异后再操作。适合：（1）修改任何配置文件前；（2）升级后出现异常需要溯源；（3）无法确认某字段来源时；（4）用户要求验证配置变化时。避免因配置错误导致系统故障或数据丢失。
二哥的配置文件修改指南
配置文件修改是系统中最敏感的操作之一。本技能将"谨慎修改"变成可复用的标准流程。
核心原则
先备份，再对比，后操作。 宁可多一步，不要凭直觉直接改。配置改错可能需要重装系统才能恢复。
标准流程（4步）
第一步：确认修改范围
在动手之前，明确回答这三个问题：
- 改什么文件？
- 改哪几个字段？
- 预期改完之后效果是什么？
如果用户没有明确说明，不擅自猜测，先问清楚。
第二步：备份
修改之前，先把原文件复制一份带日期的备份：
# Windows
Copy-Item "C:\path\ o\config.json" "C:\path\ o\config.json.backup.2026-04-25.bak"# Linux/macOS
cp /path/to/config.json /path/to/config.json.backup.2026-04-25.bak第三步：执行修改
用 edit 或 write 工具修改配置文件。
修改完成后，立刻进行第四步对比，不要跳过。
第四步：对比确认
对比备份和新文件，确认只有预期的变化：
# PowerShell - 逐行对比
diff (Get-Content "C:\path\ o\config.json.backup.2026-04-25.bak") (Get-Content "C:\path\ o\config.json")# Linux/macOS
diff /path/to/config.json.backup.2026-04-25.bak /path/to/config.json对比结果必须完全符合预期，才可以继续（重启等）。
如果发现意外变化：
- 立即用备份文件恢复：
Copy-Item "备份文件" "原文件" - 重新分析，再来一遍
场景操作手册
场景A：用户要求修改配置
- 问清楚：改什么、预期效果
- 备份
- 执行修改
- 对比，确认差异符合预期
- 告知用户可以重启/可以执行
场景B：升级后出现异常
- 用备份文件（升级前的干净版本）与当前文件对比
- 找出升级引入的新字段
- 判断哪些变化可能导致异常
- 用户确认后，再针对性修改
场景C：不确定某字段从哪来
- 找到用户确认的干净版本备份
- 与当前版本对比
- 差异 = 来源
配置修改禁忌
| 禁忌 | 原因 |
|---|---|
| 未备份就修改 | 改错无法回滚 |
| 未获授权就修改 | 用户信任受损 |
| 未对比就重启 | 可能放大错误 |
| 假设"应该没问题" | 直觉经常出错 |
| 修改后不告知用户 | 用户无法感知变化 |
快速参考
修改前：备份 Copy-Item "x.json" "x.json.backup.日期.bak"
修改后：对比 diff (Get-Content "x.json.backup.bak") (Get-Content "x.json")
异常时：恢复 Copy-Item "x.json.backup.bak" "x.json"