2026最新官方完整解答:OpenClaw技能卸载机制(解决你长期困扰的问题)
一、核心根源:为什么 openclaw skills install 没有配套 uninstall 子命令?
1. 架构设计区分两套安装体系(官方原生规则)
- openclaw skills install :OpenClaw内置本地安装指令,仅复制技能文件到 ~/.openclaw/skills/ ,无全局包追踪、无注册表记录,OpenClaw本体CLI没有设计卸载逻辑,因此不存在 openclaw skills uninstall 命令。
- clawhub install / npx clawhub@latest install :ClawHub市场包管理器安装,会自动写入技能锁定注册表、依赖树、版本记录,配套完整 uninstall 卸载指令,能完整清理文件+注册记录。
2. 你遇到的矛盾:哪怕用 openclaw skills install 装的技能,ClawHub也能识别并完整卸载,因为ClawHub会扫描全局 .openclaw 技能目录,统一管理所有安装来源的技能。
二、三种官方标准卸载方案(按推荐优先级排序,2026最新文档)
方案1:ClawHub标准卸载(你提到的npx方式,最干净无残留,首选)
适用场景:无论当初用 openclaw skills install 还是 clawhub install 安装的技能,都能彻底清理,自动删除技能文件夹、注册表、依赖缓存。
1)未全局安装ClawHub(你的Linux环境,直接用npx临时调用)
bash
基础卸载(交互式,需要确认)
npx clawhub@latest uninstall obsidian
自动化无确认(脚本/批量操作)
npx clawhub@latest uninstall obsidian --yes
2)全局装过ClawHub可简写
bash
clawhub uninstall obsidian --yes
执行后效果:
- 删除 ~/.openclaw/skills/obsidian 完整技能目录
- 清理 clawhub-lock.json 、 skill-registry.json 内注册条目
- 自动校验其他技能依赖,防止误删共用依赖包
方案2:手动彻底卸载(ClawHub命令失效、文件损坏时兜底)
流程必须按顺序,否则会残留配置导致OpenClaw报错:
1. 停止OpenClaw网关(释放占用文件)
bash
sudo systemctl stop openclaw-gateway
2. 删除技能本体文件夹
bash
rm -rf ~/.openclaw/skills/obsidian
3. 清理技能注册缓存(关键,不删会一直显示技能已安装)
bash
编辑注册表,删除obsidian对应JSON条目
nano ~/.openclaw/skill-registry.json
同时清理ClawHub锁定文件
rm -f ~/.openclaw/clawhub/clawhub-lock.json
4. 重启网关重载配置
bash
sudo systemctl start openclaw-gateway
方案3:软禁用(不想彻底删除,临时关闭技能)
无需卸载,仅关闭加载,后续可直接启用:
bash
编辑全局配置,将obsidian设置enabled: false
openclaw config edit
写入配置片段
{
"skills": {
"obsidian": {
"enabled": false
}
}
}
重启网关生效
sudo systemctl restart openclaw-gateway
四、一句话总结你的疑问
openclaw skills install 是本地简易安装指令,原生无卸载功能;ClawHub(npx clawhub uninstall)是官方配套完整卸载工具,兼容所有安装方式的技能,是目前唯一能全自动清理文件+注册表的标准方案,也是2026官方文档推荐的标准卸载流程。