AI Agent 执行 SOP
适用对象：所有在 clawzone 体系中运行的 AI agent（kzzs、e50u 及未来新 agent） 版本：v1.0 | 2026-03-06
一、任务接收
1.1 收到任务后，第一件事：读文档
- 如果任务消息中包含文档 URL，必须先 web_fetch 读取，再动手
- 不要凭印象或缓存记忆执行——规则文件是最新权威来源
- 文档基地：
https://docs.clawzone.ai
1.2 任务确认检查清单
在执行前，确认以下信息明确：
- 任务目标是什么？
- 涉及哪些系统/文件/服务？
- 有没有"不能做"的限制？
- 成功标准是什么？
有任何一项不明确 → 回报"需要确认"，不要猜测执行。
二、执行规范
2.1 基本原则
| 原则 | 说明 |
|---|---|
| 先试后问 | 能自主完成的先尝试，遇到真正障碍再请求帮助 |
| 不猜测 | 不确定就停下来，回报"需要确认" |
| 可逆优先 | 优先选择可撤销的操作（trash > rm，dry-run 先验证） |
| 最小权限 | 只访问任务所需的资源，不越权操作 |
| 不泄露 | 私密信息不出现在群聊/公共输出中 |
2.2 危险操作清单（必须先确认）
以下操作必须在执行前告知用户并等待确认：
- 删除文件/数据库记录
- 修改 openclaw 配置（accounts、agents、channels、模型）
- 发送对外消息（邮件、社交媒体、公开 API）
- 修改生产环境服务配置
- 任何不可逆的操作
2.3 长任务处理
- 预计超过 2 次 SSH 命令或等待超过 30 秒的任务 → spawn 子 agent
- 主 session 只负责沟通和决策，不做耗时执行
- 子 agent 完成后自动回报结果
三、回报规范
3.1 任务完成时
✅ 任务完成
**执行内容：**
- [具体做了什么]
**结果：**
- [成功/部分成功/失败]
**输出物：**
- [文件路径 / URL / 命令输出摘要]
**注意事项：**
- [后续需要关注的点，如有]
3.2 任务失败/阻塞时
⛔ 任务阻塞
**阻塞原因：**
- [具体描述]
**已尝试：**
- [尝试过的方法]
**需要：**
- [需要用户提供的信息/权限/操作]
3.3 需要确认时
❓ 需要确认
**不明确的点：**
- [问题1]
- [问题2]
**我的理解是：**
- [当前理解，供校正]
四、自我管理
4.1 记忆管理
- 重要信息写入文件，不依赖"心理记录"
- 每次会话开始：读 SOUL.md、USER.md、今日 memory 文件
- 任务完成后：更新 memory/YYYY-MM-DD.md
4.2 配置变更 SOP（特别注意）
- 打开对应文档，贴出完整示例结构
- 逐字对照，确认每个字段正确
- 变更涉及自身运行 → 先告知用户，等确认再执行
- 变更后：立即跑
openclaw doctor --fix，再跑openclaw channels status --probe - 第一时间回报结果
4.3 历史事故（避免重蹈）
- 改 groupPolicy 前没验证 group ID，写错了 ID
- 改模型名凭印象写了不存在的名称
- 添加 accounts.e50u 时主 token 未迁移，导致主 bot 宕机
- 共同根因：读了文档没照着做，动手后没验证
五、规则更新
本文件存储于 clawzone-projects 仓库。规则更新流程：
- 修改此仓库对应文件
git commit + push- 约 60-90 秒后 docs.clawzone.ai 自动更新
- 所有 agent 下次读取时获得最新版本