核心用法
config-modification 是一套强制性的配置文件修改安全流程，适用于所有 ~/.openclaw/ 目录下的 JSON 配置文件变更。该技能采用双层守护架构，确保配置修改过程中的系统安全与可恢复性。
第一层守护：fswatch 即时拦截
- 基于 macOS 原生 kqueue 事件驱动机制，实现亚秒级响应
- 文件写入瞬间自动执行 JSON 语法校验
- 检测到语法错误立即自动回滚，零 token 消耗
- 通过 LaunchAgent 持久化运行，崩溃后自动重启
第二层守护：cron 健康巡检
- 每 5 分钟轮询 Gateway 健康状态（
/api/health） - 使用轻量模型
lovbrowser/claude-haiku-4.5，单次约 500 token - 捕获"语法正确但语义错误"导致的运行时异常
- 连续 3 次健康检查后自动禁用，总成本约 1500 token
显著优点
1. 零延迟防护：fswatch 的亚秒级响应在错误配置生效前即完成拦截
2. 分层防护设计：语法错误与语义错误分别由不同机制捕获，覆盖全面
3. 自动化闭环：健康检查通过后自动禁用，无需人工干预，成本可控
4. 强制流程约束：6 步完整流程无例外原则，杜绝"测试可跳过"的风险行为
潜在缺点与局限性
1. 语义错误盲区：Gateway 返回 200 但功能异常的情况无法自动检测，需人工介入
2. 平台依赖：fswatch 依赖 macOS kqueue，跨平台迁移需适配
3. 成本下限：即使无异常，健康检查仍需消耗约 1500 token
4. 恢复延迟：运行时异常的回滚需 5-15 分钟，非即时恢复
适合人群
- 运行 OpenClaw Gateway 的生产环境管理员
- 需要频繁调整技能配置的高级用户
- 对系统稳定性有严格要求、可接受一定 token 开销的用户
常规风险
- 流程绕过风险：代理或用户试图跳过授权/备份步骤
- 守护进程失效：fswatch 未运行导致第一层防护缺失
- 健康状态误判：Gateway 虚假健康导致异常配置被误认为稳定
- 回滚链污染：多次快速修改可能导致备份点选择困难
实践验证
2026-03-01 双保险竞速测试证实：fswatch 在 1 秒内完成语法错误回滚，cron 在 15 分钟内完成稳定确认并自动关闭，两层机制协同有效。