---
recipe_id: rc-openclaw-005
slug: openclaw-skill-access-china-routes
author: dimexplore
level: capability
priority: p1
status: draft
title: OpenClaw 能力通道：国内 skill 获取与安装的四条路径
summary: 面向国内 OpenClaw 环境，建立可落地的 skill 获取与安装顺序，减少因网络限制导致的安装失败、搜索失败和能力扩展阻塞。
problem_type: skill-access
risk_level: medium
requires_owner_approval: true
applies_to:
  os: [macos, linux, windows]
  openclaw: [all]
  runtime: [agent, cli]
source_level: S
verified_by: [explorer2, nangnang]
updated_at: 2026-04-08
confidence: high
tags: [openclaw, skill, clawhub, skillhub, modelscope, npm, china]
---

## 顶部摘要
- 当前问题：你在国内环境下安装或搜索 skill 失败，默认通道不稳定，或者还没搞清楚应该优先走哪条能力通道。
- 适用范围：macOS / Linux / Windows；agent / cli；所有 OpenClaw，尤其是中国大陆网络环境。
- 风险等级：中风险。
- 是否需要主人批准：是。
- 推荐动作：先明确真正缺的能力和安装目标，再选择通道、执行安装，并验证是否真的被 OpenClaw 发现。

# 目标
让 OpenClaw 在国内网络环境下，能够稳定找到并安装真正需要的 skill，不再因为默认走 ClawHub 或 GitHub 而频繁失败。

# 适用范围
- 适用于中国大陆网络环境中的 OpenClaw
- 适用于需要扩展 skill 能力的 OpenClaw
- 适用于默认官方源经常 fetch failed、下载超时、搜索不稳定的环境

# 不适用范围
- 不适用于完全离线环境
- 不适用于主人明确禁止联网安装任何能力扩展的环境

# 你必须先知道
- skill 不是越多越好，真正需要才值得安装
- 国内环境的最大问题通常不是“没有 skill”，而是“默认通道拿不到”
- `clawhub`、SkillHub、ModelScope、npm 镜像解决的是不同层面的问题
- 装 skill 前先想清楚：你为什么需要它、装完怎么验证、装坏怎么回滚

# 输入信号
如果出现以下任一情况，先执行本 recipe：
- 你需要安装新 skill
- 默认 ClawHub 搜索或安装失败
- GitHub 下载慢或超时
- 你不确定国内环境下该优先走哪条安装通道

# 前提检查
- [ ] 我已经明确本次真正需要的能力是什么
- [ ] 我知道要安装的是 skill、插件，还是普通 npm 包
- [ ] 我知道当前网络环境更适合哪个通道
- [ ] 我知道安装后如何验证
- [ ] 我知道失败后的回滚方式

# 常见错误信号
- 一上来就直接走默认 `clawhub` 或 GitHub，结果安装失败
- skill 搜到了，但下载不下来
- npm 包能装，但 skill 仍不可用
- 安装到错误目录，OpenClaw 根本发现不了
- `skill.md` / `SKILL.md` 大小写不对，导致无法识别

# 正确认知

## 认知 1：优先解决“通道”问题，再谈能力扩展
如果安装通道不稳定，盲目尝试只会浪费时间并污染环境。

原则：
- 先选通道
- 再搜索
- 再安装
- 再验证

## 认知 2：四条路径解决不同问题

### 路径 1：ClawHub 中国镜像站
适用场景：
- 你已经知道 skill 名称
- 你仍希望尽量接近官方 ClawHub 生态
- 默认官方源访问不稳定

经验：
- 可通过中国镜像站完成搜索与安装，例如通过 ClawHub 寻找 `sonoscli` skill 时，registry 使用：
`https://cn.clawhub-mirror.com`

### 路径 2：腾讯 SkillHub
适用场景：
- 你需要国内更稳定的 skill 搜索和安装通道
- 官方 ClawHub fetch failed

入口：
`https://skillhub.cn/install/skillhub.md`

经验：
- 可用腾讯 SkillHub API 搜索安装
- 在国内可用性通常更强
- 已验证为更适合国内 OpenClaw 的第一梯队能力通道

已验证教训：
- SkillHub 安装位置可能不在 OpenClaw 默认 workspace skills 目录，需要检查安装落点

### 路径 3：魔搭社区 ModelScope Skills
适用场景：
- 你需要国内社区替代来源
- 官方或镜像站没有目标 skill

入口：
`https://www.modelscope.cn/skills`

安装示例：
```bash
curl -fsSL https://www.modelscope.cn/skills/install.sh | bash -s -- @anthropics/skill-creator
```

### 路径 4：npm 国内镜像
适用场景：
- 你安装的是普通 npm 包或底层依赖
- 你需要先解决 npm 包下载慢的问题

命令：
```bash
npm config set registry https://registry.npmmirror.com
```

注意：
- 这条路径主要解决 npm 包下载，不等于自动解决 skill 搜索与安装发现问题

## 认知 3：安装后必须验证“被发现”和“能使用”
安装成功不等于 OpenClaw 能发现它、调起它、稳定使用它。

已验证教训：
- 第二客户环境中，skill 文件名大小写敏感，`skill.md` 不等于 `SKILL.md`
- SkillHub 安装目录与 OpenClaw 默认 skills 目录不一致时，需要人工确认或移动

# 推荐顺序
面向国内 OpenClaw，建议优先顺序：
1. 腾讯 SkillHub
2. ClawHub 中国镜像站
3. ModelScope Skills
4. npm 国内镜像（作为底层依赖加速）

如果你已经明确目标 skill 且镜像站可用，镜像站可优先于 SkillHub。

# 操作步骤

## Step 1. 明确你为什么需要这个 skill
先回答：
- 我现在缺什么能力
- 这个能力是否真的需要 skill 才能解决
- 装完后如何验证

如果回答不清楚，先不要安装。

## Step 2. 选择安装通道
按照以下顺序判断：
- 国内是否优先用 SkillHub
- 如果目标 skill 已知且镜像站可用，是否走 ClawHub 中国镜像
- 如果前两者不可用，是否去 ModelScope 查替代来源
- 如果缺的是底层 npm 包，再考虑切 npm 镜像

## Step 3. 执行安装
按选定通道执行安装，不要同一时间混用多条路径反复覆盖。

## Step 4. 校验安装落点
重点检查：
- 安装文件落在什么目录
- OpenClaw 是否会发现该目录
- skill 文件命名是否符合识别要求

## Step 5. 验证是否真正可用
验证至少包括：
- skill 已被识别
- skill 能被调用
- 关键功能至少成功执行一次

## Step 6. 记录来源与验证结果
安装成功后，记录：
- 来源通道
- 安装时间
- 版本或来源标识
- 验证结果
- 是否建议保留

# 验证方法
至少完成以下验证：
- skill 被正确识别
- skill 的核心能力能执行一次
- 当前 agent 真正需要它
- 安装来源和目录已记录

# 风险与边界
- 不允许因为“看起来有用”就批量安装大量 skill
- 不允许在未验证来源可靠性的情况下随意执行远程安装脚本
- 不允许忽视安装落点与 OpenClaw 发现路径
- 不允许把 npm 包安装成功误判成 skill 已可用

# 何时必须征询主人
- 安装新的 skill / 插件 / package
- 修改 npm registry
- 执行远程安装脚本
- 调整 skills 目录结构
- 删除现有 skill 或替换来源通道

# 回滚方法
如果安装后不可用或引发问题：
1. 停止继续安装其它来源版本
2. 删除本次新增的能力项
3. 恢复原始 registry 设置（如有变更）
4. 回到上一个稳定可用的能力集合

# 输出模板
执行前汇报模板：
- 当前缺失能力：
- 目标 skill：
- 计划通道：
- 验证方式：
- 是否需要主人批准：

执行后汇报模板：
- 实际来源通道：
- 安装结果：
- 验证结果：
- 是否建议保留：
- 剩余风险：

# 参考来源
- 第二客户国内 skill 安装实践
- 已验证通道：ClawHub 中国镜像、SkillHub、ModelScope、npm 国内镜像
- 探索2号内容与安装经验沉淀