---

name: fly-install description: 当 ClawHub CLI 速率限制或安装失败时，通过多种备用方式安装技能：1) clawhub.ai 下载 zip；2) GitHub 搜索并克隆；3) 手动流程指导。

Fly Install - ClawHub 备用安装方案

当 clawhub install 遭遇速率限制时的逃生通道 🚀

问题场景

• npx clawhub install <skill> 返回 Rate limit exceeded
• clawhub CLI 无法访问或安装失败
• 急需安装某个技能但官方渠道受阻

解决方案（三种方式）

方式一：全自动脚本（推荐）

# 使用 fly-install 脚本，自动尝试多种安装方式
~/.openclaw/workspace/skills/fly-install/fly-install.sh <skill-name>

# 示例
~/.openclaw/workspace/skills/fly-install/fly-install.sh nano-pdf
~/.openclaw/workspace/skills/fly-install/fly-install.sh skill-vetter

脚本会按以下顺序尝试：

1. 检查是否已安装
2. 尝试从 GitHub 搜索并克隆
3. 从 clawhub.ai 下载 zip
4. 输出手动安装指导

方式二：GitHub 直接克隆

# 搜索 GitHub 上的技能仓库并克隆
cd ~/.openclaw/workspace/skills

# 搜索技能（示例）
curl -s "https://api.github.com/search/repositories?q=nano-pdf+openclaw" | jq -r '.items[0].clone_url'

# 克隆到本地
git clone --depth 1 <clone_url> <skill-name>

方式三：ClawHub 下载 zip

访问 https://clawhub.ai/skills 搜索技能，下载 zip 包手动安装。

详细使用指南

全自动安装脚本

# 基础用法
~/.openclaw/workspace/skills/fly-install/fly-install.sh <skill-name>

# 指定安装目录
~/.openclaw/workspace/skills/fly-install/fly-install.sh <skill-name> /custom/skills/path

# 查看帮助
~/.openclaw/workspace/skills/fly-install/fly-install.sh --help

手动 GitHub 克隆流程

步骤 1: 搜索 GitHub 仓库

# 使用 GitHub API 搜索技能仓库
SEARCH_QUERY="<skill-name>+openclaw+skill"
curl -s "https://api.github.com/search/repositories?q=$SEARCH_QUERY" | jq -r '.items[0:3] | .[] | "\(.full_name): \(.clone_url)"'

步骤 2: 验证并克隆

cd ~/.openclaw/workspace/skills

# 克隆仓库（替换为实际的 clone_url）
git clone --depth 1 <clone_url> <skill-name>

# 验证安装
ls <skill-name>/SKILL.md
cat <skill-name>/SKILL.md

手动 ClawHub zip 流程

步骤 1: 搜索技能

访问 https://clawhub.ai/skills 搜索你要安装的技能名称

步骤 2: 进入详情页

点击技能卡片进入详情页，确认：

• ✅ 安全扫描状态（VirusTotal + OpenClaw）
• ✅ 作者信息
• ✅ 下载次数和评分

步骤 3: 获取下载链接

在详情页找到 "Download zip" 按钮，复制链接地址

步骤 4: 下载并安装

cd ~/.openclaw/workspace/skills

# 下载 zip 包（替换为实际的下载链接）
wget -O <skill-name>.zip "<下载链接>"

# 解压到独立文件夹
unzip -q <skill-name>.zip -d <skill-name>

# 删除 zip 包
rm <skill-name>.zip

# 验证安装
ls <skill-name>/SKILL.md

批量安装

# 创建技能列表
cat > skills-to-install.txt << EOF
nano-pdf
skill-vetter
clawshield
atxp
EOF

# 批量安装
while read skill; do
  ~/.openclaw/workspace/skills/fly-install/fly-install.sh "$skill"
done < skills-to-install.txt

安装方式对比

方式	优点	缺点	适用场景
GitHub 克隆	版本控制、可更新	需要找到正确仓库	开源技能
ClawHub zip	官方来源、安全可靠	需手动下载	闭源/官方技能
fly-install 脚本	全自动、多方式尝试	依赖网络	快速安装

安全提醒 ⚠️

• 只从可信来源安装：clawhub.ai 官方或知名 GitHub 仓库
• 安装前检查 VirusTotal 扫描结果
• 审查 SKILL.md 内容后再使用
• 不要安装来源不明的技能

故障排除

GitHub 克隆失败

# 检查仓库是否存在
curl -s https://api.github.com/repos/<owner>/<repo> | jq -r '.message'

# 使用 https 替代 ssh
git clone https://github.com/<owner>/<repo>.git

zip 下载失败

# 使用 curl 替代 wget
curl -L -o skill.zip "<下载链接>"

解压失败

# 安装 unzip
apt-get install unzip  # Ubuntu/Debian
brew install unzip     # macOS

更新技能

# GitHub 克隆的技能
cd ~/.openclaw/workspace/skills/<skill-name>
git pull

# zip 安装的技能（需重新下载）
mv <skill-name> <skill-name>-backup
~/.openclaw/workspace/skills/fly-install/fly-install.sh <skill-name>

相关技能

• find-skills - 搜索发现新技能
• healthcheck - 检查系统健康状态
• security-check - 扫描技能安全性

---

🦞 大龙虾的逃生通道，CLI 受阻时的救命稻草。