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官方文档推荐的标准卸载流程。