问题极可能源于npm镜像源不可达或clawhub未正确连接远程仓库；需切换至https://registry.npmmirror.com、重装clawhub、验证仓库连接、必要时直连ip或离线安装。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试安装 OpenClaw 技能插件，但执行 clawhub install 命令后失败，终端显示连接超时、registry 404 或依赖解析失败，则问题极可能源于 npm 镜像源不可达或 ClawHub 客户端未正确连接远程仓库。以下是解决此问题的步骤：
一、强制切换为最新可用 npm 镜像源
OpenClaw 技能安装底层依赖 npm 包管理流程，而国内用户访问默认 registry.npmjs.org 易因跨境网络丢包导致超时或 shasum 校验失败；需确认使用的是 2026 年仍有效且受支持的镜像地址——https://registry.npmmirror.com，旧版淘宝源 registry.npm.taobao.org 已于 2026 年初彻底停用并失效。
1、执行命令设置全局 registry：
npm config set registry https://registry.npmmirror.com
2、同步配置至 yarn（如使用）：
yarn config set registry https://registry.npmmirror.com
3、同步配置至 pnpm（如使用）：
pnpm config set registry https://registry.npmmirror.com
4、清除本地缓存以避免旧源残留干扰：
npm cache clean --force
二、验证并重装 ClawHub 客户端
ClawHub 是技能安装的入口工具，若其自身损坏、版本过低或未初始化，会导致所有 install 命令静默失败或报错“command not found”。必须确保 ClawHub 处于可执行状态且已绑定有效仓库地址。
1、卸载现有版本：
npm uninstall -g clawhub
2、重新安装最新版（推荐使用 npm）：
npm install -g clawhub@latest
3、初始化 ClawHub 配置：
clawhub init
4、检查是否成功连接默认仓库：
clawhub status
5、若返回 “Repository unreachable” 或超时，手动指定国内镜像仓库地址：
clawhub config set registry https://hub.npmmirror.com
三、绕过 DNS 解析直连仓库 IP（临时应急）
当系统 DNS 缓存污染或运营商劫持导致 registry.npmmirror.com 解析失败时，可跳过域名解析，直接通过已知稳定 IP 地址发起请求。该方法不修改系统 hosts，仅对当前 npm 进程生效。
1、获取 registry.npmmirror.com 当前有效 IPv4 地址（截至 2026 年 4 月，常用 IP 为 114.114.114.114 或 223.5.5.5）
2、设置 npm 使用该 IP 的 HTTPS 端口进行通信：
npm config set registry https://114.114.114.114:443
3、验证配置是否生效：
npm config get registry
4、执行安装命令并观察是否跳过 DNS 阶段：
clawhub install skill-vetter
四、启用离线模式安装本地技能包
当网络完全不可用或企业防火墙严格拦截外网请求时，可放弃远程仓库连接，改用预下载的技能 tarball 文件进行安装。该方式不依赖任何 registry，适用于断网环境或安全审计场景。
1、从 GitHub Releases 页面下载对应技能的 .tgz 包（例如 skill-vetter-2026.2.1.tgz）
2、将文件保存至本地路径（如 ~/Downloads/skill-vetter.tgz）
3、执行离线安装命令：
clawhub install ./Downloads/skill-vetter.tgz
4、安装完成后检查物理路径是否写入：
ls ~/.openclaw/workspace/skills/ | grep vetter
五、检查并修复全局 npm 前缀权限异常
即使安装命令显示 success，若 npm 全局前缀目录（如 /usr/local 或 C:\Users\XXX\AppData\Roaming\npm）存在权限拒绝或符号链接损坏，ClawHub 将无法读取已安装的技能二进制文件，表现为“安装成功但技能不可见”。
1、查询当前全局路径：
npm config get prefix
2、检查该路径下 node_modules/clawhub 是否存在且可读：
ls -la $(npm config get prefix)/node_modules/clawhub
3、若提示 Permission denied，Linux/macOS 用户执行：
sudo chown -R $(whoami) $(npm config get prefix)
4、Windows 用户以管理员身份运行 PowerShell，执行：
icacls "$(npm config get prefix)" /grant "${env:USERNAME}:(OI)(CI)F" /t
