Agent Del — 删除 OpenClaw Agent#

按照 OpenClaw 官方规范删除一个或多个 agent，使用 openclaw agents delete CLI 命令，自动将数据移到技能目录下的回收站（ {skillDir}/.trash/），并在 history.md 中记录删除时间和回收站路径。

---

⚠️ Agent 必读：防跳步规则（最高优先级）#

本技能是 严格五步流程。未完成当前步的「完成标志」， 禁止 进入下一步。

规则说明一步一停每步做完、等用户回复（如需），再进入下一步第四步只 exec 一次用户确认后， 只执行下面「第四步」里那一条 bash 命令，不要拆成多条试探禁止猜路径不要用 ls scripts/、不要假设 {baseDir}、不要手写 workspace 下的路径禁止抢先 delete第四步完成前， 不要 调用 openclaw agents delete禁止脚本失败后擅自手动删脚本非零退出时，先把 完整 stderr/stdout 给用户看，问是否重试；只有用户同意才走「手动回退」禁止跳过确认用户未明确回复「确认」类字样，不得执行删除建议新会话对话很长时，建议用户开新会话再跑本技能，避免 SKILL 被上下文淹没

当前步骤追踪（Agent 必须在回复里维护）#

每轮回复开头用一行标明进度，例如：

text

📍 agent-del 进度：第 2 步 / 共 5 步 — 等待你选择要删除的 agent

---

流程#

第一步：列出当前所有 agent#

完成标志： 已向用户展示编号列表，并等待用户选择。

用 exec 只执行这一条：

bash

openclaw agents list --json

解析 JSON，展示列表。 main 也要列出，但标注不可删除：

text

📋 当前已配置的 Agent：

1. 📜 main（管仲）— ⭐ 默认 agent — 🔒 不可删除
   - 模型: r730xd-vllm/kasimat-fp8
   - Workspace: /data1/.openclaw/workspace

2. 🎓 xiaolaoshi（小老师）
   - 模型: r730xd-vllm/kasimat-fp8
   - Workspace: /data1/.openclaw/workspace-xiaolaoshi

回复编号来选择要删除的 agent，可多个（如 "2,3" 或 "2 3"）。

展示：编号、emoji、agent ID、显示名称、模型、workspace。 isDefault: true 的标注为默认且不可删。

本步禁止： 调用 delete、运行任何删除脚本、猜测要删哪个 agent。

---

第二步：用户选择要删除的 agent#

完成标志： 已解析出 agent ID 列表，并进入第三步展示摘要。

等用户回复编号，解析为 agent ID 列表。

若用户选了 main：提示「main 是默认 agent，通常保留。确认要删除吗？」并等用户再次确认。

本步禁止： 执行删除或脚本。

---

第三步：展示待删除信息并等待确认#

完成标志： 用户已明确回复「确认」「是的」「删吧」等肯定语。

text

🗑️ 即将删除以下 Agent：

1. xiaolaoshi（小老师）🎓
   - Workspace: /data1/.openclaw/workspace-xiaolaoshi
   - Agent 目录: ~/.openclaw/agents/xiaolaoshi/
   - 模型: r730xd-vllm/kasimat-fp8

⚠️ 删除后将：
- 从 openclaw.json 移除 agent 配置
- 将 workspace 和 agent 目录移到技能目录回收站 `{skillDir}/.trash/`
- 在 history.md 记录删除时间和回收站路径

确认删除？回复「确认」即可。

必须等用户确认后再进入第四步。

本步禁止： 任何 exec 删除操作。

---

第四步：执行删除（核心 — 只允许一条命令）#

完成标志： 脚本输出里出现全部阶段标记（见下方 checklist），且 exit code 为 0。

用户确认后，用 exec 只执行下面这一条（把 <agentId> 换成实际 ID，多个用空格分隔）：

bash

bash "$(find "$HOME/.openclaw" -maxdepth 5 -path "*/skills/agent-del/scripts/run-del.sh" -print -quit 2>/dev/null)" <agentId1> <agentId2>

为什么用 run-del.sh： 入口脚本与 agent-del.sh 同目录，find 到即可运行， 不需要 dirname、 xargs 或 ls scripts/。

第四步 Agent 行为约束

1. 只 exec 一次 — 不要先 ls、不要先单独 openclaw agents delete
2. 脚本包办一切 — 回收站备份 → delete → 清残留 → 写 history → 验证
3. 完整输出给用户 — 原样展示脚本 stdout（含 checklist）
4. 不要重复 delete — 脚本内部已调用 openclaw agents delete
5. 失败时 — 展示完整输出 + 退出码，问用户「重试脚本 / 走手动回退 / 取消」； 不要 静默改手动流程

成功 checklist（输出里必须全部出现）

text

[1/5] 验证 agent 是否存在
[2/5] 移到回收站
[3/5] 执行删除命令
[3b/5] 清理残留目录
[4/5] 最终验证
[5/5] 删除完成

若缺少任一项 → 视为未完成， 不要 进入第五步，按失败流程处理。

---

第五步：完成提示#

完成标志： 已向用户汇报结果。

根据脚本输出告知：

• ✅ 已删除的 agent 名称与 ID
• 回收站路径（来自脚本输出）
• 剩余 agent 列表（脚本末尾 openclaw agents list）
• 可选：是否 openclaw gateway restart

history.md 已由脚本写入， Agent 不要 再手动读写 history，除非走了手动回退。

---

history.md 记录格式#

markdown

# Agent 删除记录

## xiaolaoshi (🎓)

- **删除时间:** 2026-06-06 01:43:00 CST
- **Agent ID:** xiaolaoshi
- **显示名称:** 小老师
- **原 Workspace:** /data1/.openclaw/workspace-xiaolaoshi
- **原 Agent 目录:** ~/.openclaw/agents/xiaolaoshi
- **回收站 workspace:** {skillDir}/.trash/agent-xiaolaoshi-20260606-014300-workspace
- **回收站 agent dir:** {skillDir}/.trash/agent-xiaolaoshi-20260606-014300-agentdir

---

手动回退（仅当用户同意且脚本完全失败）#

触发条件： run-del.sh 找不到、或 exit ≠ 0 且用户选择手动回退。

1. openclaw agents list --json 获取 workspace 路径

2. 定位技能目录： bash

   SKILL_DIR=$(find "$HOME/.openclaw" -maxdepth 5 -path "*/skills/agent-del/SKILL.md" -print -quit 2>/dev/null | xargs dirname)
   
   

3. mkdir -p "$SKILL_DIR/.trash"

4. mv <workspace> "$SKILL_DIR/.trash/agent-{id}-$(date +%Y%m%d-%H%M%S)-workspace"

5. 移整个 agent 外层目录（含 agent/、 sessions/、 models.json）： mv ~/.openclaw/agents/<id> "$SKILL_DIR/.trash/agent-{id}-$(date +%Y%m%d-%H%M%S)-agentdir"

6. openclaw agents delete <id> --force

7. 在 $SKILL_DIR/history/history.md 追加记录

8. 验证： test ! -d ~/.openclaw/agents/<id>

---

Bash 兼容性#

脚本兼容 Bash 3.2（macOS 默认）。执行时 务必用 bash，不要用 sh。

推荐入口（与第四步相同）：

bash

bash "$(find "$HOME/.openclaw" -maxdepth 5 -path "*/skills/agent-del/scripts/run-del.sh" -print -quit 2>/dev/null)" <agentId>

---

已知 Bug#

openclaw agents delete 经 gateway 时有 bug：配置会从 openclaw.json 移除，但 CLI 可能提前 return，导致官方 trash 逻辑未执行。

Workaround： 脚本 先 mv 到 {skillDir}/.trash/，再 openclaw agents delete，最后清理残留目录。

---

注意事项#

• main 可列出，通常保留不删
• 删除后数据在回收站， 可恢复
• 若 agent 绑定了 channel，需手动检查 openclaw.json 的 bindings