ClawHub 全局命令  clawhub  与  npx clawhub  完整区别（2026官方文档标准）

一、底层运行原理差异

1.  clawhub  直接运行（全局安装模式）

前置操作：必须先执行全局安装

bash

npm install -g clawhub
 

1. npm 将  clawhub  二进制脚本永久写入全局目录  ~/.npm-global/bin ；
2. 只要该目录加入系统 PATH ，任意终端直接输入 clawhub 即可调用；
3. 工具包完整保存在全局 lib/node_modules/clawhub ，永久占用磁盘；
4. 每次执行直接读取本地缓存包，无需重复下载，执行速度更快。

2.  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技能的痛点）

1. 全局  clawhub uninstall obsidian 

优势：

• 长期服务器运维首选，一次安装永久使用；
• 登录ClawHub账号后，发布/同步/批量管理技能更稳定；
  劣势：
• 一旦全局包损坏、PATH配置丢失，直接提示 clawhub:未找到命令 （你之前obsidian-cli踩过同款坑）；
• 全局版本老旧会出现兼容bug，无法自动更新。

2.  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 是最省心、踩坑最少的方案。

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

一、全局安装clawhub
npm install -g clawhub
二、使用clawhub安装技能
clawhub search 技能的名称（模糊查找，找到下载次数最多的下载）
三、安装抖音博主提到的8个必备技能
1、像杀毒软件一样扫描技能中的代码拦截恶意程序和窃取隐私的代码
clawhub install skill-vetter
2、找技能的技能，可以直接向龙虾询问相关技能的问题
clawhub install find-skills-skill
3、实时搜索技能。ai的知识库是有时间截至的。该技能能实时在线获取最新的知识数据。
clawhub install tavily-search
4、长期记忆.可以跨对话记住项目偏好，上下文。
clawhub install agent-memory
5、基于rust的无头浏览器自动化命令行工具。可以操控浏览器登陆网址、点击按钮、填写表单等操作
clawhub install agent-browser-clawdbot
6、自我迭代，会记录自我犯过的错误和纠正方法。越用越聪明，装上它龙虾进入自动进化阶段。
clawhub install self-improving
7、无论是几小时的录音还是几百页的文档，都能提炼出核心要点。
clawhub install summarize-pro

要让 CC-Switch（开源名通常为 code-switch）将 Claude Code 的请求转发到本地运行的模型（例如通过 Ollama 运行的本地模型），核心原理是利用 CC-Switch 在本地建立的代理服务（默认端口通常为 18100 或 15721），将 Claude Code 的 API 格式转换为兼容本地模型的接口。

以下是具体的设置步骤：
第一步：准备本地模型（以 Ollama 为例）

确保你的本地模型服务已经启动，并且开启了 API 监听。

下载并运行 Ollama，启动一个适合代码生成的本地模型（例如 qwen2.5-coder 或 deepseek-coder）。

默认情况下，Ollama 会在本地的 http://127.0.0.1:11434 开启 OpenAI 兼容接口。你可以通过浏览器访问该地址，看到 Ollama is running 说明正常。

第二步：在 CC-Switch 中添加本地供应商

打开 CC-Switch 客户端。

在主界面顶部选中 Claude Code 图标，点击右上角的 「+」（添加新供应商）。

填写本地模型的配置信息：

    供应商名称：自定义（例如 Ollama-Local）

    接口类型：选择 OpenAI 或 Custom（取决于 CC-Switch 提供的选项，Ollama 完美兼容 OpenAI 接口规范）

    请求地址 (Base URL)：输入你本地模型的 API 地址。

        如果是 Ollama，输入： http://127.0.0.1:11434/v1

    API Key：本地模型通常不需要 Key，但为了通过 Claude Code 的校验，可以随意填一个占位符（例如 ollama 或 local-key）。

配置模型映射（关键步骤）：
展开高级选项中的模型映射（Model Mapping）。Claude Code 内部写死了向 claude-3-5-sonnet 等模型发送请求，你需要把它们映射为你本地模型的实际名称：

    主模型 / Sonnet 默认模型：输入你本地模型的真实名称（例如 qwen2.5-coder:7b 或 deepseek-r1:14b）。

    Haiku 默认模型：也可以映射为相同的本地模型。

点击保存/添加，并在主界面点击该供应商右侧的 「启用」。

第三步：配置 Claude Code 环境变量

CC-Switch 启用后，会在本地创建一个代理端口（假设为默认的 http://127.0.0.1:18100）。你需要告诉 Claude Code 将请求发送到 CC-Switch，而不是 Anthropic 官方服务器。

打开你的终端，根据操作系统执行以下命令：

对于 Linux / macOS：
Bash

export ANTHROPIC_BASE_URL=http://127.0.0.1:15721
export ANTHROPIC_AUTH_TOKEN=local-key

（注：如果永久生效，可以将上述两行写入 ~/.bashrc 或 ~/.zshrc 中）

对于 Windows (PowerShell)：
PowerShell

$env:ANTHROPIC_BASE_URL="http://127.0.0.1:15721"
$env:ANTHROPIC_AUTH_TOKEN="local-key"

第四步：启动 Claude Code 测试

在配置好环境变量的终端里，进入你的项目目录，直接运行：
Bash

claude

此时，Claude Code 发出的所有指令都会经过 CC-Switch，被自动转换为本地模型的接口，从而实现完全本地化/免费的代码助手体验。

⚠️ 避坑提示：
如果启动后报错提示连接超时或认证失败，请检查 CC-Switch 主页左上角「设置」中的 路由监听地址与端口，确保第参步中的 ANTHROPIC_BASE_URL 端口号（如 18100 或 15721）与 CC-Switch 实际监听的端口完全一致。

如果你的 Ollama 模型运行在局域网（LAN）的另一台 Ubuntu/Windows 计算机上，而你想在当前的本地电脑上运行 Claude Code，你需要进行两步配置：

让远端计算机的 Ollama 允许局域网访问（默认它只听 localhost）。

在本地电脑上配置环境变量指向远端 IP。

以下是完美的配置流程：

步骤一：配置远端计算机（运行 Ollama 的那一台）
默认情况下，Ollama 出于安全考虑，只接受 127.0.0.1（本地循环地址）的请求。你需要修改它的监听配置。

1. 如果远端是 Ubuntu 系统：
   打开终端，编辑 Ollama 的 systemd 服务配置文件：

Bash
sudo systemctl edit ollama.service
系统会打开一个文本编辑器，在空行中输入或粘贴以下内容：

Ini, TOML
[Service]
Environment="OLLAMA_HOST=0.0.0.0"
Environment="OLLAMA_ORIGINS=*"
💡 0.0.0.0 表示允许任意 IP 访问它，OLLAMA_ORIGINS=* 允许跨域请求（对 Claude Code 握手很重要）。

保存并退出编辑器（如果是 nano，按 Ctrl+O 确认，再按 Ctrl+X 退出）。

刷新配置并重启 Ollama 服务：

Bash
sudo systemctl daemon-reload
sudo systemctl restart ollama

2. 如果远端是 Windows 系统：
   在 Windows 任务栏右下角找到 Ollama 图标，右键点击并选择 Quit Ollama 退出。

打开 Windows 高级系统设置 -> 环境变量。

在“用户变量”或“系统变量”中，点击新建，添加以下两个变量：

变量名：OLLAMA_HOST ，变量值：0.0.0.0

变量名：OLLAMA_ORIGINS ，变量值：*

重新在开始菜单启动 Ollama 软件。

步骤二：获取远端计算机的局域网 IP
在远端计算机上查看它的局域网内网 IP（形如 192.168.x.x）：

Ubuntu 终端输入：hostname -I 或 ip route show

Windows 终端输入：ipconfig

假设我们获取到的远端 IP 是：192.168.1.100

步骤三：在本地电脑连接并启动 Claude Code
回到你当前写代码的这台 Ubuntu 本地电脑上，打开终端，将接口地址重定向到远端：

方法 A：直接注入环境变量启动（推荐）
Bash

1. 将 Base URL 指向远端计算机的 11434 端口

export ANTHROPIC_BASE_URL="http://100.99.36.102:11434"

2. 绕过授权验证（固定写法）

export ANTHROPIC_AUTH_TOKEN="ollama"
export ANTHROPIC_API_KEY=""
export ANTHROPIC_MODEL="qwen3.5:4b"

3. 启动并指定远端已拉取好的模型

claude --model qwen3.5:14b
方法 B：使用你之前安装的 cc-switch 快速管理
如果你已经装好了 cc-switch 命令行或图形端，你只需要进入配置，新建一个名为 Ollama-Remote 的节点：

Provider URL: http://192.168.1.100:11434

API Key / Token: （留空或填 ollama）

之后每次切到这个配置，直接在终端敲 claude --model 模型名 就能直接白嫖另一台电脑的显卡算力了！

🛠️ 网络连通性排查
如果在本地输入 claude 提示连接超时（Timeout）或无法连接，请在本地终端运行以下命令，测试是否能穿透到远端：

Bash
curl http://192.168.1.100:11434
如果成功：会返回一行文字 Ollama is running。

如果失败：说明被远端计算机的防火墙拦截了。

解决办法（远端是 Ubuntu）：在远端运行 sudo ufw allow 11434/tcp 放行端口。

解决办法（远端是 Windows）：在Windows高级安全防火墙中，新建入站规则，允许 11434 端口的 TCP 连接。