时间:2026-02-23 02:00 GMT+8
执行链路完整:设计 → 执行 → 链路验证五步骤(创建文件 → 写 flag → config.patch → 重启验证 → 链路测试)顺序正确。
修改建议①(已修改):Step 3 中 config.patch 的指令写为"执行后立即结束 turn(等待重启)",但没有提示先用 openclaw doctor 验证配置(参考 LESSONS #014)。SOP 应在 config.patch 执行前加一步验证。已在 SOP 中添加。
SOP 一中的踩坑表格(通知黑洞/通知内容丢失/Reviewer 超时/串行变并行/task.md 状态未更新)与 LESSONS.md 记录一致,描述准确。
无需修改。
SOP 的 workspace 管理准则(task.md 不再修改、session.md 只追加、通知只传 task 路径)与 multi-agent-plan.md v1.10 完全一致。
无需修改。
SOP 第五节指出 SOUL.md 和 USER.md 应为软链接。实际验证:
workspace-coder/SOUL.md -> /root/.openclaw/workspace/SOUL.md ✅
workspace-coder/USER.md -> /root/.openclaw/workspace/USER.md ✅
workspace-reviewer/SOUL.md -> /root/.openclaw/workspace/SOUL.md ✅
workspace-reviewer/USER.md -> /root/.openclaw/workspace/USER.md ✅
规则正确,与实际一致。
但 SOP 中没有提到 workspace-coder 缺少 BOOTSTRAP.md(workspace-reviewer 有,coder 没有),也没说明 bootstrap 文件在纯后端 Agent 中是否需要。这不影响功能,但 SOP 应对此有明确说明。
修改建议②(已修改):SOP 第一节文件表格中加注:纯后端 Agent 不需要 BOOTSTRAP.md。
发现两处遗漏:
遗漏①:SOP 没有提到创建 active.json 条目的时机和格式(v1.10 第七节规定任务工作区包含 active.json,由爱衣管理)。但 SOP-003 是"新建 Agent"而非"执行任务"的 SOP,active.json 由爱衣管理,不在 agent 创建流程中——这条遗漏实际不属于 SOP-003 范畴,忽略。
遗漏②(真正遗漏):SOP Step 2(写 .restart-pending)说明了 config.patch 每次触发 SIGUSR1,但没有说明 .restart-pending 文件在重启后是否需要手动清除,还是会自动清除。对照实际经验,.restart-pending 是一个约定标记文件,Gateway 重启后不自动删除,需要说明处理方式(或明确它只是人工提示,不被 Gateway 读取)。
修改建议③(已修改):Step 2 加注说明 .restart-pending 是人工提示 flag,Gateway 不自动读取/删除,可在重启验证完成后手动删除。
对照 LESSONS.md 发现 SOP 缺少一条重要警告:
LESSONS #014 指出:改 openclaw.json 前必须验证 schema,schema 严格验证(strict())导致 Gateway 启动失败,主人需手动登服务器修复。SOP Step 3 只写了"在 agents.list 末尾追加新条目",没有提醒先验证语法和 schema。
修改建议④(已修改):Step 3 追加注意事项:执行 config.patch 前先用 python3 -c "import json; json.load(open('/root/.openclaw/openclaw.json'))" 验证 JSON 语法,并在重启后立即检查 Gateway 日志确认启动成功。
| # | 位置 | 修改内容 |
|---|---|---|
| ① | Step 3 | 添加 config.patch 前 JSON 验证步骤 |
| ② | 文件表格 | 纯后端 Agent 无需 BOOTSTRAP.md |
| ③ | Step 2 | 说明 .restart-pending 是人工提示,需手动清除 |
| ④ | 常见问题 | 补充"config.patch 后 Gateway 启动失败"排查项 |