OpenClawSkills彻底卸载指南

想彻底卸载OpenClaw Skills却总被残留文件、未释放端口、自动重注册或配置冲突困扰？本文提供一套覆盖CLI命令、手动文件清理、环境变量清除、配套扩展卸载及进程端口终结的五步全栈式卸载方案，精准解决“看似卸载成功实则暗藏隐患”的痛点，助你真正实现零残留、无干扰的干净移除——无论你是刚踩坑的新手，还是反复失败的老用户，这套方法都能一步到位还原系统纯净状态。

如果您已安装 OpenClaw 并希望彻底移除其全部 Skills（技能），但发现命令执行后仍存在残留加载、配置残留或端口占用，则很可能是仅卸载了部分组件而未清理 Skill 文件、注册表项与关联数据。以下是针对 Skills 的多种独立卸载方法，覆盖 CLI 操作、手动文件清理、环境与服务层干预等路径：

一、使用 OpenClaw CLI 命令卸载技能

该方法适用于 OpenClaw CLI 仍可正常调用且服务处于运行状态的场景，通过内置命令触发标准卸载流程，自动解除注册、删除运行时缓存并通知网关停用对应 Skill。

1、以管理员身份打开 PowerShell 或 CMD，确保当前用户具有执行权限；

2、输入 openclaw skill list 查看已安装 Skill 的名称与状态；

3、对目标 Skill 执行卸载命令：openclaw skill uninstall （将 替换为实际名称，如 weather、notion 等）；

4、等待命令返回 “Uninstalled successfully” 提示，并观察终端是否输出 “Removed from registry” 和 “Cleared runtime cache” 字样；

5、再次执行 openclaw skill list，确认目标 Skill 已从列表中消失。

二、手动删除 Skill 文件夹及 registry.json 条目

当 CLI 不可用、命令无响应或卸载后仍有文件残留时，必须进入文件系统层面直接清除物理载体和注册索引。OpenClaw 将所有 Skill 存放于 ~/.openclaw/skills/ 目录下，并通过 ~/.openclaw/registry.json 维护加载状态与元信息。

1、在文件资源管理器中定位路径：%USERPROFILE%\.openclaw\skills\（Windows）；

2、找到对应 Skill 的子文件夹（例如 notion-integration），右键选择“删除”并清空回收站；

3、使用记事本或 VS Code 打开 %USERPROFILE%\.openclaw\registry.json；

4、在 JSON 内容中搜索该 Skill 名称，定位到包含 "name": "xxx" 的完整对象块；

5、整段删除该对象（注意保留合法 JSON 结构，删除后需确保逗号、括号配对正确）；

6、保存文件并关闭编辑器。

三、清理 Skill 关联配置、数据与环境变量

某些 Skill 在启用时会写入独立配置文件、创建本地数据库或注入环境变量，若不一并清除，重启 OpenClaw 后可能触发自动重注册或初始化失败错误。

1、检查 %USERPROFILE%\.openclaw\config\ 目录下是否存在以 Skill 名命名的 YAML 或 JSON 配置文件（如 notion.yaml），如有则全部删除；

2、进入 %USERPROFILE%\.openclaw\data\，查找与 Skill 名相关的子目录（如 notion-db\），执行递归删除；

3、在 PowerShell 中运行：Get-ChildItem Env: | Where-Object Name -match "NOTION|WEATHER|CLAW_SKILL"，识别是否存在 Skill 相关环境变量；

4、对匹配到的变量，执行：Remove-Item Env:\（如 Remove-Item Env:\NOTION_API_KEY）；

5、重启终端以确保环境变量变更生效。

四、卸载配套扩展与前端集成组件

部分 Skill 依赖浏览器扩展或 VS Code 插件提供交互入口，这些组件独立于 OpenClaw 主进程运行，不随主程序卸载而清除，必须单独处理。

1、打开 Chrome 或 Edge 浏览器，在地址栏输入 chrome://extensions/，查找名称含 “OpenClaw”、“ClawBot” 或 Skill 关键词的扩展；

2、点击对应扩展右侧的“移除”按钮，确认操作；

3、启动 VS Code，进入扩展面板（Ctrl+Shift+X），搜索 openclaw 或 Skill 名，对已安装项点击“卸载”；

4、检查 %USERPROFILE%\.vscode\extensions\ 目录，手动删除以 openclaw- 开头的文件夹；

5、重启浏览器与 VS Code。

五、终止 Skill 相关服务进程并验证端口释放

部分 Skill 启动后会绑定本地 HTTP 端口（如 3001、8080）或后台 Node.js 子进程，即使 Skill 文件已删，残留进程仍可能维持监听状态，导致后续重装失败或端口冲突。

1、在 PowerShell 中运行：Get-NetTCPConnection | Where-Object LocalPort -in 3001,8080,9000 | Format-Table LocalAddress,LocalPort,State,AppliedSetting，筛选可疑端口；

2、对命中结果，记录其 OwningProcess PID；

3、执行：Get-Process -Id | Stop-Process -Force（替换 为实际值）；

4、运行：Get-Process | Where-Object {$_.Path -like "*openclaw*"} | Stop-Process -Force -ErrorAction SilentlyContinue，强制终止所有路径含 openclaw 的进程；

5、再次执行端口检查命令，确认目标端口不再出现在输出中。

到这里，我们也就讲完了《OpenClawSkills彻底卸载指南》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于openclaw的知识点！