📦

OpenClaw Skill 安装完整指南

从零开始，手把手教你正确安装和管理 Agent Skills

📑 目录

🤔 什么是 Skill？

Skill 是 OpenClaw Agent 的「超能力模块」。每个 Skill 都包含：

  • SKILL.md — 技能的「身份证」，描述功能和使用方法
  • 工具函数 — 实现特定功能的代码（可选）
  • 配置文件 — 技能运行所需的配置（可选）
  • 资源文件 — 图片、模板等资产（可选）
💡 小知识 Skill 让你可以扩展 Agent 的能力，比如添加天气查询、电商数据抓取、Shopify 管理等功能！

📋 安装方法总览

方法 难度 适用场景 推荐度
ClawHub CLI 简单 从官方市场安装技能 ⭐⭐⭐⭐⭐
手动下载 中等 安装本地/第三方技能包 ⭐⭐⭐
Git Clone 较难 开发中技能或 GitHub 项目 ⭐⭐⭐

🚀 方法一：ClawHub CLI（强烈推荐）

✨ 为什么推荐这个方法？

  • 一键安装，自动处理依赖
  • 支持版本管理和更新
  • 官方技能市场，质量保证
  • 可以搜索、浏览所有可用技能

📝 详细步骤

1 安装 ClawHub CLI 工具

打开 PowerShell 或命令提示符，运行：

npm install -g clawhub
⚠️ 注意 如果提示 npm 找不到，请先安装 Node.js：https://nodejs.org/
2 验证安装成功 
clawhub --version

如果显示版本号，说明安装成功！

3 搜索想要的技能 
clawhub search "关键词"

例如：

clawhub search "weather"
clawhub search "shopify"
clawhub search "amazon"
4 安装技能 
clawhub install 技能名

例如：

clawhub install weather
clawhub install shopify
📍 安装位置 默认安装到：~/.agents/skills/技能名/
5 指定版本安装（可选） 
clawhub install 技能名 --version 1.2.3
6 查看已安装的技能 
clawhub list
⚠️ 重要说明 clawhub list 只显示通过 ClawHub 安装的技能。手动复制或 git clone 的技能不会显示在这里，但 Agent 仍然可以使用！只要文件夹在正确位置且包含 SKILL.md 即可。
7 更新技能 
# 更新单个技能
clawhub update 技能名

# 更新所有技能
clawhub update --all

# 强制更新（覆盖本地修改）
clawhub update 技能名 --force

🔧 常用命令速查

命令 说明
clawhub search "关键词" 搜索技能
clawhub install 技能名 安装技能
clawhub list 列出已安装技能
clawhub update --all 更新所有技能
clawhub login 登录（发布技能需要）

📥 方法二：手动下载安装

🎯 适用场景

  • 从 GitHub 下载的技能包（ZIP 文件）
  • 朋友分享的本地技能
  • 自己开发的技能

📝 详细步骤

1 获取技能文件夹

下载技能的 ZIP 文件并解压，或者从其他地方复制技能文件夹。

2 确认技能结构

确保文件夹内包含 SKILL.md 文件（必需）。

技能名/ ├── SKILL.md # 必需！技能描述文件 ├── src/ # 可选：源代码 ├── assets/ # 可选：资源文件 └── package.json # 可选：依赖配置
3 选择安装位置

将技能文件夹复制到以下任一位置：

路径 作用域 用途
~/.agents/skills/技能名/ 全局 所有工作区可用
~/.openclaw/workspace/skills/技能名/ 工作区 仅当前工作区可用
📂 路径说明 ~ 代表用户主目录，在 Windows 上通常是 C:\Users\你的用户名\
4 重启 Gateway

让 OpenClaw 重新加载技能：

openclaw gateway restart
5 验证安装

在聊天中询问 Agent：「你现在有哪些可用的技能？」

🌿 方法三：Git Clone

🎯 适用场景

  • 从 GitHub 安装开发中技能
  • 需要跟踪技能更新
  • 想要贡献代码或修改技能

📝 详细步骤

1 确保已安装 Git 
git --version

如果提示找不到 git，请安装：https://git-scm.com/

2 Clone 技能仓库 
# 安装到全局技能目录
git clone https://github.com/作者/技能名 ~/.agents/skills/技能名

# 或安装到工作区技能目录
git clone https://github.com/作者/技能名 ~/.openclaw/workspace/skills/技能名
3 安装依赖（如果有） 
cd ~/.agents/skills/技能名
npm install
4 重启 Gateway 
openclaw gateway restart
5 后续更新技能 
cd ~/.agents/skills/技能名
git pull

📁 Skill 目录结构详解

weather/ ├── SKILL.md # 【必需】技能描述和使用说明 ├── src/ # 【可选】源代码目录 │ ├── index.js │ └── utils.js ├── assets/ # 【可选】资源文件 │ └── icon.png ├── package.json # 【可选】Node.js 依赖 ├── README.md # 【可选】额外文档 └── config.example.json # 【可选】配置示例

📄 SKILL.md 文件示例

---
name: weather
description: 获取天气预报和实时天气数据
metadata:
  requires:
    env: ["WEATHER_API_KEY"]
---

# Weather Skill

## 功能
- 查询实时天气
- 获取天气预报
- 支持全球城市

## 使用方法
直接询问天气即可，例如：
- "北京天气怎么样？"
- "上海明天会下雨吗？"

## 配置
需要设置 WEATHER_API_KEY 环境变量。

✅ 验证安装成功

✓ 检查清单
  • 技能文件夹存在于正确位置
  • 文件夹内包含 SKILL.md 文件
  • 已运行 openclaw gateway restart
  • Agent 能识别并使用新技能

🧪 测试方法

在聊天中向 Agent 提问与技能相关的问题：

# 如果安装了 weather skill
"北京今天天气怎么样？"

# 如果安装了 shopify skill
"帮我查一下商店的订单"

# 通用测试
"你现在可以使用哪些技能？"

🔧 常见问题排查

❓ 问题 1：clawhub 命令找不到

原因：Node.js 未安装或 npm 全局路径不在 PATH 中

解决：

  1. 安装 Node.js：https://nodejs.org/
  2. 重新运行：npm install -g clawhub
  3. 重启终端或添加 npm 全局路径到 PATH

❓ 问题 2：安装后技能不生效

原因：Gateway 未重启或安装位置错误

解决：

  1. 确认技能在正确目录：~/.agents/skills/ 或工作区 skills/
  2. 确认包含 SKILL.md 文件
  3. 运行：openclaw gateway restart
  4. 等待 10-20 秒让 Gateway 完全重启

❓ 问题 3：技能冲突或覆盖

原因：同技能名存在于多个位置

解决：

  1. 工作区技能优先级 > 全局技能
  2. 删除重复的技能文件夹
  3. 使用 clawhub list 查看已安装列表

❓ 问题 4：权限错误

原因：没有写入权限

解决：

# Windows PowerShell（管理员运行）
Takeown /F "~/.agents/skills" /R
Icacls "~/.agents/skills" /grant administrators:F

# 或以管理员身份运行终端后重试安装

❓ 问题 5：clawhub list 看不到我的技能

原因：技能不是通过 ClawHub 安装的

说明：

  • clawhub list 只记录通过 clawhub install 安装的技能
  • 手动复制或 git clone 的技能不会显示在列表中
  • 但这不影响使用！Agent 仍然可以加载和使用这些技能

验证技能是否生效的正确方法：

# 直接在聊天中问 Agent
"你现在有哪些可用的技能？"
"你能用 weather skill 查一下天气吗？"
⚠️ 重要提示 修改任何技能文件后，都必须运行 openclaw gateway restart 才能生效！

📌 快速参考卡片

操作 命令
安装 CLI npm i -g clawhub
搜索技能 clawhub search "关键词"
安装技能 clawhub install 技能名
查看已安装 clawhub list
更新所有 clawhub update --all
重启 Gateway openclaw gateway restart