OpenClaw Agent 删除
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_15292d5a/yjkj-agent-del。
技能介绍
要解决什么问题
在 OpenClaw 里下线一个 agent,如果只跑 openclaw agents delete,很容易踩到 gateway 侧的实现问题:配置会从 openclaw.json 里删掉,但 CLI 可能提前返回,workspace / agent 目录并没有被挪进回收站,数据就处在「注册已删、文件还在」或更糟的半残状态。手动 mv 再删又容易漏步骤、漏记路径,事后恢复也找不到对应目录。
技能如何工作
本技能把删除做成固定五步流程,由助手用 exec 驱动 CLI 与脚本:
- 列出:执行
openclaw agents list --json,展示编号、emoji、agent ID、显示名、模型、workspace;isDefault: true的 main 会标为默认且不可删。 - 选择:按用户给的编号解析出 agent ID;若选了 main,会单独确认是否真的要删。
- 确认:汇总待删 agent 的关键信息,等用户明确同意后再继续。
- 删除脚本:再次
list --json核对存在并取路径;先把 workspace、agent 目录mv到{skillDir}/.trash/agent-{id}-{timestamp}-*;再执行openclaw agents delete --force;在{baseDir}/history/history.md记录时间、ID、原名、原路径与回收站路径;最后用list校验结果。 - 收尾:列出已删 agent 与回收站位置,并提醒 bindings 与
openclaw gateway restart。
回收站放在技能目录下,是为了绕开 ~/.Trash/ 可能的权限问题,也避免依赖有 bug 的 gateway 搬文件逻辑。
适用边界与注意点
- 删除不是抹盘:数据在
{skillDir}/.trash/,需要时可手动移回原路径结构。 - main 默认 agent 通常应保留;列表里会出现,但流程会拦一层确认。
- 若 agent 曾绑定 channel,删除后请自行检查
openclaw.json里的 bindings。 history.md是审计与恢复的依据,格式在 SKILL 中有约定,便于对照时间戳与目录名。
使用场景
- 本地 OpenClaw 里堆了多个试验用 agent,需要按编号选定并下线,同时把 workspace 先挪进技能目录回收站
- gateway 执行 delete 曾导致目录未进回收站,希望按「先 mv 再 delete」流程删 agent 并留下 history.md 路径记录
- 要移除已废弃的 agent,但删除前需二次确认 main 默认 agent,并核对 ID、模型与 workspace 路径
- agent 删完后还要对照 openclaw.json 的 bindings,并视情况执行 gateway restart 让配置生效
适合人员
- 在多台机器维护 OpenClaw gateway、经常增删 agent 的运维,需要可审计、可恢复的删除流程
- 用 OpenClaw 做多 agent 联调的研发,试验结束后要批量清理非 main agent 且不想丢 workspace 数据
- 负责 OpenClaw 实例治理的平台同学,要求每次删除都有时间戳、原路径与回收站路径写入 history.md
- 曾踩过 agents delete 提前返回导致目录未搬迁的问题,希望由技能统一驱动 list、确认与脚本步骤