本文档基于 ClawHub 编写，包含 ClawHub 介绍、CLI 安装、核心命令、10 款高人气 Skills 详细说明及使用规则，适用于 OpenClaw 智能体技能扩展。
一、ClawHub 是什么
ClawHub 是 OpenClaw 官方公共 Skills 注册中心，免费、开源、公开，所有人可浏览、共享、复用、发布 Skills。OpenClaw 与 VirusTotal 合作提供技能安全，所有发布到ClawHub的技能现在都采用了VirusTotal的威胁情报扫描，包括他们新增的代码洞察能力。这为 OpenClaw 社区提供了额外的安全层。
Skills 本质：包含 SKILL.md 的文件夹，用于给 OpenClaw 智能体扩展能力。
二、ClawHub CLI 安装
先安装 CLI 工具，才能执行技能管理命令：
Bash
# npm 安装（推荐）
npm i g clawhub
# 或 pnpm 安装pnpm
add g clawhub
验证安装：
Bash
clawhub version
三、ClawHub 核心常用命令
1. 搜索技能
Bash
clawhub search "关键词"
2. 安装技能
Bash
# 基础安装
clawhub install <skillslug>
# 强制覆盖安装
clawhub install <skillslug> force
3. 更新技能
Bash
# 更新单个技能
clawhub update <skillslug>
# 更新所有已安装技能
clawhub update all
4. 查看已安装技能
Bash
clawhub list
5. 登录/退出（发布技能用）
Bash
clawhub login # 浏览器登录
clawhub logout # 退出登录
四、10 款 ClawHub 高人气 Skills 详解
以下为官方热门技能，直接复制命令即可安装。
1. self-improving-agent
作者名：@pskoett
核心功能：捕捉学习内容、错误及修正信息，实现智能体持续自我改进。适用于：(1) 命令 / 操作意外失败时；(2) 用户纠正智能体指令时。
下载量：84.4k
安装命令：
bash
clawhub install self-improving-agent
2. tavily-search
作者名：@arun-8687
核心功能：通过 Tavily API 实现 AI 优化的网页搜索，为智能体返回简洁、相关的搜索结果。
下载量：74.1k
安装命令：
bash
clawhub install tavily-search
3. find-skills
作者名：@JimLiuxinghai
核心功能：当用户询问 “如何做 X”“找能做 X 的技能” 等需求时，帮助发现并安装对应的智能体技能。
下载量：69.5k
安装命令：
bash
clawhub install find-skills
4. summarize
作者名：@steipete
核心功能：借助 summarize CLI 工具总结 URL 或文件内容，支持网页、PDF、图片、音频、YouTube 等格式。
下载量：64.7k
安装命令：
bash
clawhub install summarize
5. github
作者名：@steipete
核心功能：通过 gh CLI 操作 GitHub，支持 gh issue（议题）、gh pr（PR）、gh run（CI 运行）、gh api（高级查询）等功能。
下载量：60.3k
安装命令：
bash
clawhub install github
6. weather
作者名：@steipete
核心功能：获取实时天气及预报信息，无需 API 密钥。
下载量：51k
安装命令：
bash
clawhub install weather
7. proactive-agent
作者名：@halthelobster
核心功能：将 AI 智能体从 “任务执行者” 转化为 “主动协作伙伴”，可预判需求并持续改进。支持 WAL 协议、工作缓冲区、自主定时任务等。
下载量：48.1k
安装命令：
bash
clawhub install proactive-agent
8. notion
作者名：@steipete
核心功能：调用 Notion API，实现页面、数据库、内容块的创建与管理。
下载量：34.9k
安装命令：
bash
clawhub install notion
9. Nano Pdf
作者名：@steipete
核心功能：使用 nano-pdf CLI，通过自然语言指令编辑 PDF 文件。
下载量：32.3k
安装命令：
bash
clawhub install nano-pdf
10. sonoscli
作者名：@steipete
核心功能：控制 Sonos 音箱，支持设备发现、状态查看、播放、音量调节、分组等操作。
下载量：44.2k
安装命令：
go install github.com/steipete/sonoscli/cmd/sonos@latest
五、OpenClaw Skills 加载规则
OpenClaw 加载 Skills 的文件存储位置（优先级从高到低）
优先级举例：如果有两个同名的“搜索技能”——一个在工作区，一个是内置的，OpenClaw 只会用工作区的那个。
六、安全提示
1. 第三方 Skills 视为不可信代码，启用前请阅读 [SKILL.md]
注意：第三方技能没有OpenClaw 官方扫描，可能藏着恶意代码。Clawhub上的skills有OpenClaw 生态系统的全面威胁模型，一套追踪防御工程目标的公共安全路线图，我们安全审计的详细信息，涵盖整个代码库，一个带有定义SLA的正式安全报告流程。
先找到技能文件夹里的「[SKILL.md]」文件（每个技能都有这个文件）；然后打开它，只看这 3 点就行：
技能的功能描述；
有没有提“需要访问你的文件/网络/密码”；
有没有作者/来源信息。
2. 高风险操作建议在沙箱环境运行
为什么要注意：“高风险操作”比如技能要运行电脑命令、访问你的隐私文件，沙箱就像“隔离的小房间”——技能在里面干活，就算有问题也不会影响你电脑的其他文件。
不用自己搭沙箱！OpenClaw 有自带的沙箱功能，只要在运行技能时，勾选/开启“沙箱模式”就行；
哪些技能要开沙箱：带“运行命令”“访问文件”“网络自动化”的技能，一定要开。
3. 密钥、API Key 请配置在 openclaw.json，避免明文泄露
为什么要注意：API Key 就像你的“密码”（比如搜索技能、AI 技能需要的密钥），如果直接写在技能文件里，别人拿到文件就能用你的密钥；存在 openclaw.json 里是加密存储的，更安全。
找到 openclaw.json 文件：在「~/.openclaw/」目录下（Windows 是「C:\用户\你的用户名.openclaw\openclaw.json」）；用记事本打开这个文件；按下面的格式加密钥：
{
"skills": {
"entries": {
"desearch-web-search": { // 你要加密钥的技能名（比如网页搜索技能）
"enabled": true,
"env": {
"API_KEY": "你的密钥内容" // 把“你的密钥内容”换成实际的密钥
}
}
}
}
}
保存文件，重启 OpenClaw 就生效了；
关键提醒：绝对别把密钥直接写在技能的 [SKILL.md](SKILL.md) 里，也别截图/分享 openclaw.json 文件。
