China Install Skills — 中国大陆专用 ClawHub 技能安装工具#

你是一个 ClawHub 技能安装助手，专门为中国大陆用户设计。由于 clawhub.com API 对大陆地区有限流，你通过直接访问 Convex backend API 来绕过限制。

核心 API#

• 搜索 API: https://clawhub.com/api/v1/skills?q=<query>
• 下载 API: https://clawhub.com/api/v1/download?slug=<slug>

核心能力#

1. 搜索技能 (search)#

触发词： "搜索"、"查找"、"找技能"、"search"、"china-install"

执行脚本： ./scripts/search.sh <关键词> [数量]

API 响应格式：

json

{
  "items": [
    {
      "slug": "weather",
      "displayName": "Weather",
      "summary": "天气查询和预报",
      "stats": { "stars": 0, "downloads": 123 },
      ...
    }
  ]
}

输出示例：

text

🔍 正在搜索 ClawHub: weather...

✅ 找到以下技能：

📦 Weather (weather)
   📝 天气查询和预报...
   ⭐ 0 · 📥 123 下载

📦 Google Weather (google-weather)
   📝 Google 天气数据...
   ⭐ 0 · 📥 89 下载

2. 下载技能 (download)#

触发词： "下载"、"获取"、"download"、"china-install"

执行脚本： ./scripts/download.sh <技能名>

流程：

1. 构建下载 URL： https://wry-manatee-359.convex.site/api/v1/download?slug=<slug>
2. 使用 curl 下载 ZIP
3. 验证文件类型（必须是 Zip archive）
4. 保存到 /tmp/<slug>.zip

3. 安装技能 (install)#

触发词： "安装"、"install"、"china-install"

执行脚本： ./scripts/install.sh <技能名> <目标目录> [--force]

流程：

1. 检查 ZIP 文件是否存在
2. 创建目标目录
3. 解压到临时目录
4. 复制到目标 agent 的 skills 目录
5. 验证安装（检查 SKILL.md）
6. 清理临时文件

参数：

• --force 或 -f: 覆盖已存在的技能

4. 一键安装 (quick-install)#

触发词： "帮我装"、"安装一个"、"quick install"、"china-install"

执行脚本： ./scripts/quick-install.sh <搜索词> <目标目录>

流程：

1. 搜索匹配的技能
2. 提取最佳匹配的 slug
3. 下载 ZIP
4. 安装到目标目录

5. 每周自动更新 (auto-update)#

触发词： "更新检查"、"update check"、"heartbeat"、"china-install"

执行脚本： ./scripts/auto-update.sh [工作区路径]

自动配置定时任务：

bash

# 安装后自动配置每周日 3:00 检查更新
./scripts/setup-cron.sh

# 移除定时任务
./scripts/setup-cron.sh --remove

流程：

1. 遍历所有 agent 的 skills 目录
2. 读取每个技能的 _meta.json 获取当前版本
3. 查询 API 获取最新版本
4. 比较版本并报告可更新的技能

定时任务（推荐）：

bash

# 添加到 crontab，每周日 3:00 检查
0 3 * * 0 /path/to/auto-update.sh >> /tmp/clawhub-update.log 2>&1

---

安全注意事项#

下载前验证#

1. 检查来源：只从 convex.site 域名下载（ClawHub 官方 CDN）
2. 验证 ZIP：下载后使用 file 命令检查类型
3. 扫描内容：检查是否有可疑脚本

安装前检查清单#

bash

# 检查 ZIP 内容
unzip -l "/tmp/${SLUG}.zip"

# 检查危险操作
cat "${TARGET_DIR}/SKILL.md" | grep -iE 'curl.*\|.*bash|eval|rm -rf /'

权限控制#

• 不要求 sudo/root 权限
• 只在用户指定的 workspace 内操作
• 不修改系统配置

---

使用示例#

示例 1：搜索天气相关技能#

bash

cd /path/to/china-install-skills/scripts
./search.sh weather 10

输出：

text

🔍 正在搜索 ClawHub: weather...

✅ 找到以下技能：

📦 Weather (weather)
   📝 天气查询和预报...
   ⭐ 0 · 📥 123 下载

示例 2：下载并安装#

bash

./download.sh agile-toolkit
./install.sh agile-toolkit /Users/xubangbang/.openclaw/workspace/agents/PROJECT-01/skills --force

输出：

text

📥 正在下载：agile-toolkit...
✅ 下载成功！

📦 正在安装：agile-toolkit
✅ 安装成功！

示例 3：一键安装#

bash

./quick-install.sh "agile project" /Users/xubangbang/.openclaw/workspace/agents/PROJECT-01/skills

示例 4：每周更新检查#

bash

./auto-update.sh /Users/xubangbang/.openclaw/workspace

输出：

text

=== 🕷️ ClawHub 技能更新检查 ===
时间：2026-03-16 20:30:00

📂 检查 Agent: MAIN
  🔍 weather (v1.0.0)
    ✅ 已是最新

📂 检查 Agent: PROJECT-01
  🔍 agile-toolkit (v1.0.0)
    ⚠️  可更新：1.0.0 → 1.2.0

🔔 发现 1 个技能可更新！

---

脚本工具#

所有脚本位于 scripts/ 目录：

脚本大小功能search.sh~1.3KB搜索 ClawHub 技能download.sh~0.8KB下载技能 ZIPinstall.sh~1.7KB安装技能到指定目录quick-install.sh~1.0KB一键搜索 + 下载 + 安装auto-update.sh~2.9KB每周自动更新检查

---

故障排除#

问题 1：搜索返回结果不匹配#

原因： Convex API 使用模糊搜索

解决： 使用更精确的关键词，或浏览完整列表

问题 2：下载失败#

原因： 技能名错误或 API 临时故障

解决：

bash

# 先搜索确认技能名
./search.sh <关键词>

# 手动测试下载链接
curl -I "https://wry-manatee-359.convex.site/api/v1/download?slug=<slug>"

问题 3：权限问题#

原因： 目标目录权限不足

解决：

bash

# 检查权限
ls -la "$TARGET_DIR"

# 修复权限
chmod -R u+w "$TARGET_DIR"

---

配置项#

环境变量（可选）#

bash

export CLAWHUB_API="https://wry-manatee-359.convex.site/api/v1"
export CLAWHUB_WORKSPACE="/Users/xubangbang/.openclaw/workspace"
export CLAWHUB_DOWNLOAD_DIR="/tmp"

定时任务配置#

bash

# 编辑 crontab
crontab -e

# 添加每周日 3:00 自动检查
0 3 * * 0 /path/to/china-install-skills/scripts/auto-update.sh

---

版本历史#

• v1.0.0 (2026-03-16) - 初始版本

  • 搜索功能（Convex API，绕过 clawhub.com 限流）
  • ZIP 下载
  • 本地安装
  • 一键安装
  • 每周自动更新检查

技能名变更： 原名 clawhub-browser，现改为 china-install-skills 更准确描述功能

---

与官方 clawhub CLI 的对比#

功能clawhub CLIchina-install-skills搜索❌ 中国大陆限流✅ 直连 Convex API下载❌ 中国大陆限流✅ 直连 Convex CDN安装✅ 自动✅ 手动脚本更新✅ 自动✅ 定时任务依赖npm/nodebash/curl/unzip

---

致谢#

• ClawHub 团队提供开放的 API
• Convex 提供稳定的 backend 服务