ClawHub – 安装与使用 Skills

ClawHub 是 OpenClaw 的公共技能注册表,用于发现、安装、更新和备份 Skills。
OpenClaw×ClawHub|AI技能安装避坑+常用技能清单,直接收藏
国内可用!ClawHub镜像安装指南,解决技能下载慢、解析失败问题

官方地址:https://clawhub.ai/
国内镜像地址(速度更快):https://skillhub.tencent.com/

在这里插入图片描述

核心筛选功能,精准找技能

最直接的方式,输入关键词就能定位技能。比如想找 GitHub 相关的技能,直接输入「github」;想找办公自动化相关,输入「google workspace」「邮件自动化」即可。
在这里插入图片描述

  • Highlighted(官方精选):新手首选!这里的技能都是官方筛选的优质技能,稳定性高、踩坑率低,比如「Skill Vetter」(技能安全校验)、「Github」(GitHub 自动化)都在其中。

  • Hide suspicious(隐藏可疑技能):安装技能前一定要开启!这个功能会自动隐藏有安全风险的技能,避免过度授权、信息泄露,保障使用安全。

  • Downloads 排序:按下载量排序,优先选择社区用得最多的技能,这类技能兼容性更好、问题更少,比如下载量破万的「ontology」(结构化记忆技能),值得优先尝试。


ClawHub 扮演什么角色呢,我找到了一张图,很好理解

在这里插入图片描述

skill的目录结构是怎样的

一个典型的 Skill 目录结构如下所示:

my-skill/
├── SKILL.md        # 主说明文件(含 YAML frontmatter + Markdown 指令)
├── script.py       # 可选:Skill 依赖的脚本
├── config.json     # 可选:配置文件
└── assets/         # 可选:资源文件夹
    └── icon.png

SKILL.md 是每个 Skill 的核心文件,包含两部分内容:

  • YAML frontmatter:定义 Skill 的元数据(名称、描述、作者等)
  • Markdown 指令:描述 Skill 的行为规则和使用方法

安装与使用 Skills

OpenClaw Skills 也并不神秘,他包含指令代码的 Markdown 文件,用于帮助 Agent 执行特定任务或优化工作流功能。

真正让 OpenClaw 从聊天机器人变成超级助手的,其实是它的 Skills 生态 —— 相当于 AI 的 App Store。

OpenClaw = iPhone 手机
Skills = App Store

重要提示: 没有 Skill 的 AI 只能聊天,有 Skill 的 AI 才能搜索、自动化、操作系统、调用 API、执行脚本。

ClawHub 是 OpenClaw 的官方 Skills 市场,可以理解为 AI 时代的"应用商店"。

OpenClaw = 操作系统
Agent = 大脑
ClawHub = 应用商店
Skills = 应用程序

我们找一个skills 看下

我找了一个小米家居的skill
在这里插入图片描述
可以看到他的skill内容也很简单
在这里插入图片描述

安装步骤

第一步:安装 ClawHub CLI
# 使用 npm 全局安装 ClawHub CLI
npm i -g clawhub

# 验证安装版本
clawhub --version
第二步:搜索并安装 Skill
# 搜索 Skill(支持自然语言描述)
clawhub search "send emails automatically"

# 安装指定的 Skill
clawhub install <slug>

# 查看已安装的 Skills 列表
clawhub list
第三步:在 OpenClaw 中使用

安装完成后,重启 OpenClaw Session 即可开始使用:

openclaw chat
第四步:更新 Skill
# 同步更新所有已安装的 Skills
clawhub sync

# 更新指定的 Skill
clawhub update <skill-name>

国内镜像加速: 如果你在访问官方源时遇到网络问题,可以使用国内镜像:

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

常用 Skills 推荐

以下是社区中最受欢迎的 Skills,涵盖日常使用和专业化场景:

# Skill 说明 适用场景 安装命令
1 self-improving-agent 记录失败与纠正并复盘优化 失败复盘 / 多次出错 / 用户纠正 clawhub install self-improving-agent
2 summarize 多格式内容总结(网页/PDF/视频等) 长文阅读 / 文档提炼 clawhub install summarize
3 agent-browser 自动化浏览器操作与网页抓取 Web 自动化 / 数据采集 clawhub install agent-browser
4 gog Google Workspace 集成(Gmail/Calendar/Drive) 邮件管理 / 日程安排 clawhub install gog
5 github GitHub 操作(PR/Issue/Repo 管理) 代码托管 / 团队协作 clawhub install github
6 multi-search 多搜索引擎聚合搜索 深度调研 / 全面信息检索 clawhub install multi-search
7 skill-vetter Skill 安全审计与风险检测 安装前安全检查 clawhub install skill-vetter
8 code-explainer 代码解析与架构分析 代码审查 / 技术分享 clawhub install code-explainer

tip “新手指南”

如果你刚上手 OpenClaw,强烈建议的安装顺序是:
1. 先装 skill-vetter 保底安全
2. 再装 self-improving-agent,让 AI 开始"长记性"
3. 根据需求补 summarize / agent-browser / gog / github 这几个万金油


使用国内镜像

国内镜像地址 https://skillhub.tencent.com/,用这个安装速度更快。有腾讯背书安全可靠,建议大家使用这个。
在这里插入图片描述

命令安装

// 复制命令到终端执行,安装 CLI 并优先采用 SkillHub 加速安装技能

curl -fsSL https://skillhub.cn/install/install.sh | bash

通过对话安装

安装 SkillHub 并设为优先技能安装源

复制提示词发送给你的Agent,安装 CLI 并优先采用 SkillHub 加速安装技能

根据 https://skillhub.cn/install/skillhub.md 安装 Skillhub商店。

在这里插入图片描述

制作自己的 Skill

创建 Skill 非常简单,只需要按照标准格式编写 SKILL.md 文件即可。

Skill 文件结构示例

---
name: my-api-skill
description: 与外部 API 交互的 Skill
author: your-name
version: 1.0.0
tags:
  - api
  - integration
---

# My API Skill

## 规则 (Rules)

- 在进行任何破坏性操作前,必须先获得用户确认
- 使用环境变量 `MY_API_KEY` 中的凭证进行认证
- 每次 API 调用后记录日志到 `~/.openclaw/logs/`

## 使用方法 (Usage)

当用户请求"调用 API"时,使用以下端点:
`POST https://api.example.com/action`

请求体格式:
```json
{
  "action": "doThing",
  "user_id": "{user_id}"
}

错误处理 (Error Handling)

  • 如果 API 返回 401 错误,提示用户检查 API Key 配置
  • 如果网络超时,自动重试最多 3 次
  • 所有错误都应返回给用户并记录日志

YAML Frontmatter 说明

字段 必需 说明
name Skill 的唯一标识名称(小写+连字符)
description 简短描述 Skill 的功能
author 作者名称
version 版本号(语义化版本)
tags 标签数组,用于分类和搜索

发布到 ClawHub

如果你希望与社区分享你的 Skill,可以将其发布到 ClawHub:

# 发布 Skill 到 ClawHub
clawhub publish ~/.openclaw/skills/my-skill \
  --slug my-skill \
  --name "My Skill" \
  --version 1.0.0 \
  --tags api,integration

# 参数说明:
# --slug    : Skill 在 ClawHub 上的唯一标识符
# --name    : 显示名称
# --version : 版本号(遵循语义化版本)
# --tags    : 逗号分隔的标签列表

!!! success “发布要求”
- 需要一个至少注册满一周的 GitHub 账号
- --slug 是 Skill 的唯一标识符,在整个注册表中必须唯一
- 建议在发布前使用 skill-vetter 进行安全自检


进阶技巧

Skill 之间的依赖

一个 Skill 可以声明对其他 Skill 的依赖:

---
name: advanced-skill
description: 高级功能 Skill
requires:
  - summarize
  - agent-browser
---

条件触发

可以在 SKILL.md 中定义触发条件:

## 触发条件 (Triggers)

当用户提到以下关键词时激活此 Skill:
- "搜索"
- "找一下"
- "帮我查"

当检测到 PDF 或 Word 文档时激活:
- 文件扩展名为 `.pdf`、`.docx`

相关资源


上一篇 OpenClaw 接入飞书

下一篇 OpenClaw 卸载指南

如果遇到问题可以咨询我,加群一起交流

在这里插入图片描述

Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐