OpenClaw ClawHub技能市场使用指南

前言

ClawHub 是 OpenClaw 的官方技能市场，类似于 npm 之于 Node.js、扩展商店之于 VS Code。通过 ClawHub，你可以一条命令安装社区开发的技能，也可以将自己的技能分享给全世界。

截至目前，ClawHub 上已有数百个技能，涵盖生产力工具、信息查询、娱乐互动等多个领域。

ClawHub 工作原理

ClawHub 上的技能本质上是 SKILL.md 文件，安装后存放在 ~/.openclaw/skills/ 目录中。每个技能都是一个 Markdown 文件，定义了触发条件、行为逻辑和输出格式。

~/.openclaw/skills/
├── weather.SKILL.md
├── translator.SKILL.md
├── reminder.SKILL.md
└── github-notify.SKILL.md

浏览技能市场

在线浏览

访问 ClawHub 官方网站查看所有可用技能：

https://clawhub.dev

网站提供分类浏览、热门推荐和最新发布等功能。

命令行浏览

你也可以在终端中浏览和搜索技能：

# 列出已安装的技能
openclaw skill list

# 搜索技能
npx clawhub@latest search weather

# 查看技能详情
npx clawhub@latest info weather-forecast

搜索结果示例：

Search results for "weather":
  weather-forecast    ★ 4.8  ↓ 12.3k  Weather forecast with multi-source data
  weather-alert       ★ 4.5  ↓ 3.2k   Severe weather alerts and notifications
  weather-clothing    ★ 4.2  ↓ 1.1k   Clothing recommendations based on weather

3 skills found

安装技能

基本安装

使用 npx clawhub@latest install 命令安装技能：

# 安装天气预报技能
npx clawhub@latest install weather-forecast

# 安装翻译技能
npx clawhub@latest install translator

# 批量安装多个技能
npx clawhub@latest install weather-forecast translator reminder

安装完成后，重启 OpenClaw 以激活技能：

openclaw restart

安装指定版本

# 安装指定版本
npx clawhub@latest install [email protected]

# 安装最新预览版
npx clawhub@latest install weather-forecast@next

从 Git 仓库安装

如果技能尚未发布到 ClawHub，可以直接从 Git 仓库安装：

npx clawhub@latest install --git https://github.com/username/my-skill.git

安装本地技能

开发过程中，可以从本地目录安装：

npx clawhub@latest install --local ./my-weather-skill/

管理已安装的技能

查看已安装的技能

openclaw skill list

输出示例：

Installed Skills:
  NAME               VERSION   STATUS    SOURCE
  weather-forecast   1.3.2     active    clawhub
  translator         2.1.0     active    clawhub
  reminder           1.0.5     active    clawhub
  custom-greeter     -         active    local

4 skills installed, 4 active

更新技能

# 更新单个技能
npx clawhub@latest update weather-forecast

# 更新所有技能
npx clawhub@latest update --all

# 检查可用更新（不执行更新）
npx clawhub@latest outdated

outdated 输出示例：

Outdated Skills:
  NAME               CURRENT   LATEST    CHANGELOG
  weather-forecast   1.3.2     1.4.0     Added hourly forecast support
  translator         2.1.0     2.2.1     Fixed CJK language detection

2 skills can be updated
Run 'npx clawhub@latest update --all' to update

卸载技能

# 卸载单个技能
npx clawhub@latest uninstall weather-forecast

# 卸载并清理数据
npx clawhub@latest uninstall weather-forecast --purge

启用/禁用技能

你可以临时禁用某个技能而不卸载它：

# 禁用技能
openclaw skill disable translator

# 重新启用
openclaw skill enable translator

也可以在配置文件中管理：

{
  skills: {
    // 全局禁用列表
    disabled: ["translator"],
    // 或者使用白名单模式
    // enabled: ["weather-forecast", "reminder"]
  }
}

技能分类与推荐

ClawHub 上的技能按以下类别组织：

类别	说明	热门技能
效率工具	提升工作效率	reminder, todo-list, calculator
信息查询	实时数据获取	weather-forecast, stock-price, exchange-rate
翻译语言	多语言支持	translator, dictionary, grammar-check
开发工具	编程辅助	code-runner, github-notify, regex-helper
娱乐互动	休闲交互	trivia, joke, music-recommend
数据处理	数据分析	csv-parser, json-formatter, data-viz
服务集成	外部服务对接	jira, notion, google-calendar
安全工具	安全相关	password-gen, hash-checker, ip-lookup

将技能发布到 ClawHub

准备工作

npx clawhub@latest register

npx clawhub@latest login

技能目录结构

发布前，你的技能需要遵循以下目录结构：

my-awesome-skill/
├── SKILL.md            # 技能定义文件（必需）
├── clawhub.json        # 元数据文件（必需）
├── README.md           # 文档说明（推荐）
├── CHANGELOG.md        # 变更日志（推荐）
└── examples/           # 使用示例（推荐）
    └── demo.md

元数据文件

创建 clawhub.json 来描述你的技能：

{
  "name": "my-awesome-skill",
  "version": "1.0.0",
  "description": "A brief description of what this skill does",
  "author": "your-username",
  "license": "MIT",
  "keywords": ["utility", "productivity"],
  "category": "效率工具",
  "openclaw": {
    "minVersion": "1.0.0"
  },
  "repository": "https://github.com/username/my-awesome-skill"
}

发布前验证

# 在技能目录中运行验证
npx clawhub@latest validate

# 本地测试安装
npx clawhub@latest install --local ./

发布

# 发布到 ClawHub
npx clawhub@latest publish

# 发布预览版
npx clawhub@latest publish --tag next

更新已发布的技能

# 升级版本号后重新发布
npx clawhub@latest publish

# 撤销某个版本（24 小时内）
npx clawhub@latest unpublish [email protected]

技能安全审核

ClawHub 会对所有发布的技能进行安全审核：

自动扫描：检查恶意代码和隐私泄露风险
社区审查：热门技能会接受社区审查
签名验证：安装时验证文件完整性

你可以查看技能的安全评级：

npx clawhub@latest info weather-forecast --security

Security Report: [email protected]
  Verified author:     ✓
  No external calls:   ✓ (uses MCP tools only)
  Community reviewed:  ✓ (23 reviews)
  Security score:      A+

常见问题

安装的技能不工作

# 确认技能已正确安装
openclaw skill list

# 重启 OpenClaw
openclaw restart

# 检查技能是否被禁用
openclaw skill list | grep disabled

技能版本冲突

如果两个技能冲突，检查它们的优先级设置：

# 查看技能加载顺序
openclaw skill list --verbose

npx 命令速度慢

可以全局安装 ClawHub CLI：

npm install -g clawhub@latest

# 之后直接使用
clawhub install weather-forecast
clawhub search translator

总结

ClawHub 技能市场极大地扩展了 OpenClaw 的能力边界。通过简单的命令行操作，你就能为 AI 助手添加各种实用功能。如果你开发了出色的技能，欢迎发布到 ClawHub 与社区分享。

接下来，你可以参考技能开发教程，学习如何从零开始创建自己的技能。