OpenClaw 技能安装完整指南

📚 目录

什么是 OpenClaw 技能？

🤔 简单理解

OpenClaw 技能就像给 AI 助手安装"插件"或"应用"，让它具备更多专业能力：

• memory-manager → 让 AI 拥有长期记忆能力

• multi-search-engine → 让 AI 能搜索 17 个搜索引擎

• auto-updater → 让 AI 自动更新自己的技能

• skill-creator → 让 AI 能创建新技能

📦 技能来源

技能来自 ClawHub（技能市场），类似于：

• Python 的 PyPI

• Node.js 的 npm

• macOS 的 App Store

安装前的准备

1️⃣ 检查 OpenClaw 版本

openclaw --version
# 应该显示：OpenClaw 2026.3.7 或更高版本

2️⃣ 查看当前已安装技能

openclaw skills check
# 会显示：Total、Eligible、Disabled、Missing requirements

3️⃣ 确认 npx 可用

which npx
# 应该显示：/usr/bin/npx 或类似路径

三种安装方法

方法 1️⃣：使用 npx clawhub（推荐⭐）

适用场景： 从 ClawHub 市场安装官方技能

优点：

• ✅ 官方推荐方式

• ✅ 自动处理依赖

• ✅ 自动验证安装

命令：

# 安装单个技能
npx clawhub install <skill-name>

# 安装到指定目录
npx clawhub install --dir ~/.openclaw/skills <skill-name>

方法 2️⃣：从 ZIP 包安装

适用场景： 已下载技能包（.zip 文件）

步骤：

# 1. 解压技能包
unzip skill-name.zip -d /tmp/skills/

# 2. 复制到技能目录
cp-r /tmp/skills/skill-name ~/.openclaw/skills/

# 3. 验证安装
openclaw skills check

方法 3️⃣：从 GitHub 克隆

适用场景： 从源码仓库安装开发版本

命令：

# 克隆仓库
git clone https://github.com/username/skill-name.git ~/.openclaw/skills/skill-name

# 验证安装
openclaw skills check

完整安装流程

🎯 场景：批量安装多个技能

假设你已经下载了 13 个技能包到 /root/skill/ 目录。

步骤 1：查看技能包

ls /root/skill/*.zip
# 应该看到类似：
# auto-updater-1.0.0.zip
# memory-manager-1.0.0.zip
# ...

步骤 2：解压所有技能包

# 安装 unzip（如果没有）
apt-get install unzip -y# Ubuntu/Debian
# 或
yum install unzip -y# CentOS/RHEL

# 批量解压
cd /root/skill
for zip in *.zip; do
    unzip -o"$zip"
done

步骤 3：安装技能（推荐方式）

# 方法 A：使用 npx clawhub 逐个安装（推荐）
cd /root/skill
for dir in */; do
    skill_name=$(basename "$dir")
    echo "正在安装：$skill_name"
    npx clawhub install --dir ~/.openclaw/skills "$skill_name"
done

注意： 如果遇到 Rate limit exceeded 错误，可以：

• 等待几分钟后重试

• 或使用方法 B

# 方法 B：直接复制到技能目录
mkdir -p ~/.openclaw/skills
cp -r /root/skill/* ~/.openclaw/skills/

步骤 4：验证安装

# 检查所有技能状态
openclaw skills check

# 查看已就绪技能列表
openclaw skills list --all

# 查看单个技能详情
openclaw skills info memory-manager

验证安装结果

✅ 成功标志

运行 openclaw skills check 后看到：

Total: 66
✓ Eligible: 19
⏸ Disabled: 0
🚫 Blocked by allowlist: 0
✗ Missing requirements: 47

Ready to use:
  📦 auto-updater
  📦 memory-manager
  📦 multi-search-engine
  ...

关键指标：

• ✅ Eligible = 已就绪可用的技能数量

• ✅ Ready to use 下列出了你安装的技能

❌ 常见失败原因

1. Skill not found → 技能名称错误或不存在

2. Rate limit exceeded → ClawHub API 限流，等待后重试

3. Missing requirements → 缺少依赖（如二进制工具、环境变量）

常见问题解决

❓ 问题 1：clawhub 命令找不到

原因： clawhub 没有全局安装

解决： 使用 npx clawhub 代替 clawhub

# ❌ 错误
clawhub install memory-manager

# ✅ 正确
npx clawhub install memory-manager

❓ 问题 2：技能安装了但看不到

原因： 技能目录位置错误

检查：

# 查看技能目录
ls ~/.openclaw/skills/

# 应该看到技能文件夹，如：
# memory-manager-1.0.0/
# auto-updater-1.0.0/

解决：

# 确保技能在正确位置
openclaw skills check

❓ 问题 3：Missing requirements

原因： 技能需要特定的工具或配置

示例：

✗ Missing requirements:
  📦 openai-whisper (bins: whisper)

解决：

# 安装缺少的工具
brew install openai-whisper  # macOS
# 或
pip install openai-whisper   # Python

❓ 问题 4：Rate limit exceeded

原因： ClawHub API 请求过于频繁

解决：

# 等待 5-10 分钟后重试
# 或使用离线安装方法（方法 B）

最佳实践

✅ 推荐做法

1. 先检查再安装

   # 检查技能是否已存在
   openclaw skills info skill-name

2. 批量安装时控制速度

   # 每安装一个技能后等待 2 秒
   for skill in skill1 skill2 skill3; do
       npx clawhub install "$skill"
       sleep 2
   done

3. 安装后立即验证

   # 验证单个技能
   openclaw skills info skill-name
   
   # 验证所有技能
   openclaw skills check

4. 运行技能初始化脚本

   # 某些技能需要初始化
   ~/.openclaw/skills/memory-manager/init.sh

❌ 避免做法

1. 不要同时安装太多技能 → 容易触发 Rate limit

2. 不要跳过验证步骤 → 可能导致安装失败未发现

3. 不要忽略 Missing requirements → 技能可能无法正常工作

技能目录结构

安装完成后，技能目录结构：

~/.openclaw/skills/
├── memory-manager-1.0.0/
│   ├── SKILL.md          # 技能说明文档
│   ├── README.md         # 使用指南
│   ├── init.sh           # 初始化脚本
│   ├── detect.sh         # 检测脚本
│   └── scripts/          # 其他脚本
├── auto-updater-1.0.0/
│   ├── SKILL.md
│   └── ...
└── ...

常用命令速查

# 查看所有技能状态
openclaw skills check

# 查看已就绪技能
openclaw skills list --all

# 查看单个技能详情
openclaw skills info <skill-name>

# 安装技能（推荐）
npx clawhub install <skill-name>

# 安装到指定目录
npx clawhub install --dir ~/.openclaw/skills <skill-name>

# 查看技能文档
cat ~/.openclaw/skills/<skill-name>/SKILL.md

附录：本次安装日志

📊 安装统计

• 开始时间： 2026-03-08 12:08 UTC

• 完成时间： 2026-03-08 13:16 UTC

• 总耗时： 68 分钟

• 安装技能数： 10 个新技能

• 成功率： 100%

🎯 安装清单

🔍 遇到的问题

1. clawhub 命令不存在 → 使用 npx clawhub 解决

2. Rate limit exceeded → 等待后自动恢复

3. 技能目录不存在 → 创建 ~/.openclaw/skills/ 目录

✅ 解决方案

• 使用 npx clawhub 作为官方推荐安装方式

• 批量安装时控制速度，避免触发限流

• 安装后立即运行 openclaw skills check 验证

🎓 学习建议

新手入门路径

1. 第一周： 安装基础技能

• memory-manager（记忆管理）

• multi-search-engine（搜索增强）

• skill-creator（创建自己的技能）

2. 第二周： 配置和初始化

• 运行 init.sh 脚本

• 理解技能目录结构

• 阅读每个技能的 SKILL.md

3. 第三周： 实践使用

• 在实际任务中使用技能

• 记录遇到的问题

• 尝试创建自己的技能

📚 参考资料

• OpenClaw 官方文档：https://docs.openclaw.ai/cli/skills

• ClawHub 技能市场：https://clawhub.com

• 技能规范：https://agentskills.io/specification

💡 提示： 如果在安装过程中遇到任何问题，请先查看"常见问题解决"章节，或查阅 OpenClaw 官方文档。