ClawHub 全局命令 clawhub 与 npx clawhub 完整区别（2026官方文档标准）
ClawHub 全局命令 clawhub 与 npx clawhub 完整区别（2026官方文档标准）
一、底层运行原理差异
- clawhub 直接运行（全局安装模式）
前置操作：必须先执行全局安装
bash
npm install -g clawhub
1. npm 将 clawhub 二进制脚本永久写入全局目录 ~/.npm-global/bin ；
2. 只要该目录加入系统 PATH ，任意终端直接输入 clawhub 即可调用；
3. 工具包完整保存在全局 lib/node_modules/clawhub ，永久占用磁盘；
4. 每次执行直接读取本地缓存包，无需重复下载，执行速度更快。
- npx clawhub@latest 临时运行模式
无需提前全局安装，执行流程自动完成：
1. npx 先检查本地/全局是否存在clawhub；
2. 不存在则从npm仓库临时下载最新版本到缓存目录 ~/.npm/_npx ；
3. 执行完当前命令后，临时文件不会常驻系统（仅保留缓存，不会污染全局命令）；
4. 每次加 @latest 强制拉取最新版ClawHub CLI，避免全局旧版本bug。
二、核心维度对比表
对比项 全局 clawhub 命令 npx clawhub@latest
安装前置 必须提前 npm i -g clawhub 零安装，开箱即用
版本锁定 固定全局单一版本，更新需手动 npm update -g clawhub 每次执行自动拉取最新版，版本永远最新
磁盘占用 永久占用全局存储，长期残留 仅临时缓存，无全局污染
PATH依赖 强依赖 ~/.npm-global/bin 写入环境变量（你之前obsidian-cli找不到命令就是PATH缺失） 完全不依赖系统PATH，不会出现“命令未找到”问题
执行速度 首次安装后速度快，无下载过程 首次执行会下载包，重复执行有缓存提速
脚本/自动化 适合长期固定服务器、批量定时脚本 适合临时调试、一次性卸载/安装技能、多环境切换
账号登录状态 登录token永久保存在全局目录，所有终端共用 登录状态仅当前临时会话有效，重启终端失效
三、OpenClaw技能管理场景下的关键差异（针对你卸载Obsidian技能的痛点）
- 全局 clawhub uninstall obsidian
优势：
- 长期服务器运维首选，一次安装永久使用；
- 登录ClawHub账号后，发布/同步/批量管理技能更稳定；
劣势： - 一旦全局包损坏、PATH配置丢失，直接提示 clawhub:未找到命令 （你之前obsidian-cli踩过同款坑）；
- 全局版本老旧会出现兼容bug，无法自动更新。
- npx clawhub@latest uninstall obsidian （最适配你的Linux服务器）
优势（完美解决你长期困扰的问题）：
1. 规避PATH环境变量坑：不需要配置npm全局bin路径，不会出现命令找不到；
2. 永远使用官方最新CLI，修复了旧版卸载逻辑缺陷，能完整清理 openclaw skills install 安装的技能注册表；
3. 用完无残留，不会和其他npm全局工具产生版本冲突；
4. 不用维护全局包，换服务器、重装系统无需重复安装ClawHub；
劣势：重复执行会有短暂下载耗时（npm缓存后可忽略）。
四、官方推荐使用场景（2026最新文档）
场景1：长期固定服务器、需要频繁管理技能、写定时脚本
选全局安装 clawhub
bash
npm i -g clawhub
clawhub list
clawhub uninstall obsidian
场景2：临时操作、一次性卸载/安装、多机器轮换、不想配置PATH（你的现状）
选 npx clawhub@latest （优先推荐，解决你PATH缺失导致命令失效的核心痛点）
bash
卸载技能，无任何前置配置
npx clawhub@latest uninstall obsidian --yes
场景3：开发技能、发布上传、长期登录账号管理仓库
必须全局安装 clawhub ，登录状态持久化。
五、针对你之前遇到的问题补充说明
1. 你之前 obsidian-cli 全局安装后提示命令不存在，根源是 npm全局bin目录未写入PATH ；
若使用 npx clawhub ，完全不会出现同类问题，不需要修改 .bashrc 环境变量；
2. openclaw skills install 安装的技能，新旧版全局clawhub可能存在卸载不全bug，而 npx clawhub@latest 每次拉取最新CLI，卸载逻辑完整，能清理注册表+技能文件夹；
3. 如果你只是单纯安装、卸载OpenClaw扩展技能，日常直接用 npx clawhub@latest 是最省心、踩坑最少的方案。