Agent Skills
返回列表
OpenClaw Agent 删除

OpenClaw Agent 删除

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 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 与脚本:

  1. 列出:执行 openclaw agents list --json,展示编号、emoji、agent ID、显示名、模型、workspace;isDefault: true 的 main 会标为默认且不可删。
  2. 选择:按用户给的编号解析出 agent ID;若选了 main,会单独确认是否真的要删。
  3. 确认:汇总待删 agent 的关键信息,等用户明确同意后再继续。
  4. 删除脚本:再次 list --json 核对存在并取路径;先把 workspace、agent 目录 mv 到 {skillDir}/.trash/agent-{id}-{timestamp}-*;再执行 openclaw agents delete --force;在 {baseDir}/history/history.md 记录时间、ID、原名、原路径与回收站路径;最后用 list 校验结果。
  5. 收尾:列出已删 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、确认与脚本步骤