OpenClaw 拥有庞大的 Skills 生态系统，包括内置49个、官方93个、社区1715+个，总计1800+个可用 Skills，深入理解Skills本质，学会使用ClawHub技能市场，掌握必装Skills推荐，学习自定义Skills开发和管理技巧。没有Skills的OpenClaw只是1个聊天机器人，有了Skills才能真正成为你的AI助手！

8.0.1 什么是Skills？

简单理解：

Skills 本质上就是教 AI 按固定流程做事的操作说明书，一旦写好，就能像函数一样反复调用。

可以把 Skills 看成把”某类事情应该怎么专业做”这件事，封装成1个可复用、可自动触发的能力模块。

形象比喻：

把 AI 想象成1个刚毕业的聪明但没经验的实习生：

普通Prompt = 你每次都要从头教他怎么做事（今天教一遍，明天还得重新教）
Rule / 记忆 = 你给他贴一张”公司行为守则”在工位上（一直生效，但只能管态度和格式）
MCP / Tools = 你给他电脑装了一堆软件和API（他能调用外部工具，但不知道什么时候该用、怎么组合用）
Skills = 你直接给他一整套“岗位培训大礼包”（PDF+流程图+SOP+话术模板+常用脚本），告诉他：”当老板让你做这类事情时，就按这个文件夹里的方法来做”

8.0.2 Skills vs 传统Prompt

核心区别：按需加载 + 渐进式披露（只在需要时才把厚厚的 SOP 塞进上下文，极大节省 token）

对比项	普通 Prompt	Skills 机制
每次都要重新描述	是	否（只描述一次）
上下文长度占用	每次全量塞入	渐进式加载（只在触发时才读完整内容）
一致性	依赖每次 prompt 质量	高（固定 SOP + 模板）
复用性	手动复制粘贴	自动匹配 / slash 命令 / 项目共享
维护方式	改一次 prompt 就要重新发	修改 SKILL.md 文件，全局/项目生效

实际例子：

比如我们平时写文章，在没有 Skills 之前，每次都要按以下步骤重复说：

帮我总结文章 → 翻译 → 改成公众号风格 → 加标题 → 输出 Markdown

有了 Skills 之后：

你只需要一句：使用「技术文章转公众号」Skill

AI 会自动按你设定的步骤执行。

8.0.3 Skills vs MCP vs Tools

三者的区别：

特性	Skills	MCP	Tools
核心作用	知识复用	能力扩展	功能调用
实现方式	Markdown文件	服务器端配置	API接口
使用难度	⭐ 简单	⭐⭐⭐ 复杂	⭐⭐ 中等
Token消耗	低（渐进式加载）	高（启动时全量加载）	中等
适用场景	经验、最佳实践、工作流程	连接API、数据库、外部工具	单一功能调用
创建门槛	任何人都可以创建	需要编码能力	需要API开发
部署要求	无需服务器	需要服务器端设置	需要后端支持

使用建议：

✅ Skills：用于知识分享、经验复用、工作流程
✅ MCP：用于连接外部系统、数据库、API
✅ Tools：用于单一功能调用、快速集成

8.0.4 Skills的工作原理

渐进式加载机制：

Skills用渐进式加载来高效管理上下文：

发现阶段：启动时，AI 只加载每个技能的名称和描述，只保留最基本的识别信息
激活阶段：当任务匹配某个技能的描述时，AI 才把完整的 SKILL.md 指令读入上下文
执行阶段：AI 按照指令执行，按需加载参考文件或运行代码

这种设计让 AI 保持快速，同时能按需获取更多信息。

Token消耗对比：

传统方式（全量加载）：
- 10个Skills × 500字/个 = 5000字
- 约1250 tokens

Skills方式（渐进式加载）：
- 发现阶段：10个Skills × 50字/个 = 500字（约125 tokens）
- 激活阶段：只加载需要的1个Skills = 500字（约125 tokens）
- 总计：约250 tokens

节省：80% tokens

8.0.5 支持Skills的工具

目前能用 Skills 的主流客户端：

排序	工具名	是否免费使用Skills	推荐人群	技能存放默认路径	备注
1	Claude Code	是（官方）	所有人	~/.claude/skills	标准制定者，生态最全
2	Cursor	是	写代码最常用	~/.cursor/skills	几乎无缝兼容Claude Skills
3	Trae / OpenCode	是	追求性价比	看工具设置	国内用户较多
4	VS Code + 插件	部分支持	已经深度用vscode	插件设置里配置	正在快速跟进
5	扣子/其他国内平台	部分支持	喜欢网页版	平台自带技能市场	有的要会员

OpenClaw的优势：

✅ 完全兼容Claude Skills格式
✅ 支持本地和云端部署
✅ 可以通过飞书、企微、钉钉使用
✅ 支持自定义Skills开发
✅ 社区生态丰富（1715+个Skills）

8.0.6 Skills核心结构

最小Skills结构：

1个 Skill 本质上就是1个 Markdown 文件（文件名固定为 SKILL.md）

my-skill/
└── SKILL.md   （唯一必需）

SKILL.md 基本模板：

---
name: pdf-processing
description: 从 PDF 中提取文本和表格，填写表单，并合并文档
---

# PDF 处理

## 使用场景

当需要对 PDF 文件进行操作时使用，例如：
- 提取 PDF 文本或表格数据
- 填写 PDF 表单
- 合并多个 PDF 文件

## 提取文本

- 使用 `pdfplumber` 提取文本型 PDF 内容
- 扫描版 PDF 需配合 OCR 工具

## 填写表单

- 读取 PDF 表单字段
- 按输入数据填充并生成新文件
```text
**Skills核心结构示意图**：

![Skills核心结构图 - SKILL.md定义技能能力](https://upload.maynor1024.live/file/1770813820310_image1.png)

**Frontmatter字段说明**：

| 字段 | 必需 | 说明 |
|------|------|------|
| name | ✅ | Skill 名称，最长 64 字符，只能使用小写字母、数字和 `-`，且不能以 `-` 开头或结尾 |
| description | ✅ | 功能与使用场景说明，最长 1024 字符，不能为空 |
| license | ❌ | 许可证名称或指向随 Skill 附带的许可证文件 |
| compatibility | ❌ | 环境与依赖说明（产品、系统包、网络权限等），最长 500 字符 |
| metadata | ❌ | 自定义键值对，用于扩展元数据（如作者、版本号） |
| allowed-tools | ❌ | 允许使用的工具列表（空格分隔，实验性功能） |

**完整Skills结构**（包含资源文件）：

如果你需要一些参考资料、参考实例、执行脚本，可以使用更复杂的 Skill 目录结构：

my-skill/ ├── SKILL.md # 必需：指令 + 元数据 ├── scripts/ # 可选：可执行代码 ├── references/ # 可选：文档资料 └── assets/ # 可选：模板、资源

![复杂Skills目录结构 - 包含脚本和依赖](https://upload.maynor1024.live/file/1770813829999_image2.png)

---

## 🎯 Skills生态概览

**最新数据（2026年2月）**：
- 📊 **总技能数**：1715+个技能
- 📁 **主要分类**：31个分类
- 🌟 **活跃贡献者**：数百位开发者
- 📈 **增长速度**：每月新增50+个技能

**主要分类及技能数量**：
- 🌐 Web前端开发：46个
- 💻 编程代理和IDE：55个
- 🔧 Git和GitHub：34个
- ☁️ DevOps和云服务：144个
- 🌐 浏览器和自动化：69个
- 🎨 图像和视频生成：41个
- 🤖 AI和LLMs：159个
- 📊 数据和分析：18个
- ✅ 生产力和任务管理：93个

> 💡 **Skills是什么？** Skills是OpenClaw的插件系统，是让AI助手从"能说"到"能做"的关键转变。安装了Skills之后，你的AI助手可以自动浏览网页、收发邮件、操作GitHub、控制智能家居、生成图片、管理任务，甚至控制你的Tesla汽车！

## 🔧 本章内容

- 8.1 ClawHub技能市场
- 8.2 核心Skills推荐
- 8.3 Skills 安装方法
- 8.4 实战应用案例
- 8.5 安全使用指南
- 8.6 Skills开发指南
- 8.7 Skills管理技巧

---

## 8.1 ClawHub技能市场

### 8.1.1 什么是ClawHub

**定义**：
ClawHub是OpenClaw的官方技能市场（https://clawhub.ai），类似于App Store，提供各种扩展功能。

**核心价值**：
- 🎯 **扩展能力**：让OpenClaw能做更多事情
- 🚀 **快速部署**：一键安装，即刻使用
- 🌍 **社区驱动**：开发者共享优质Skills
- 🔄 **持续更新**：Skills不断优化升级
- 📦 **统一管理**：安装、更新、备份一站式

**与其他AI的区别**：

| 特性 | OpenClaw + Skills | ChatGPT Plugins | Claude |
|------|------------------|-----------------|--------|
| 本地执行 | ✅ | ❌ | ❌ |
| 系统操作 | ✅ | ❌ | ❌ |
| 自定义开发 | ✅ | ❌ | ❌ |
| 社区生态 | ✅ | ✅ | ❌ |
| 免费使用 | ✅ | 部分付费 | ❌ |

### 8.1.2 Skills加载机制

**Skills加载位置**：

OpenClaw从3个位置加载Skills，优先级从高到低：

工作区Skills：/skills（最高优先级）
- 单智能体专用
- 项目特定的Skills
托管/本地Skills：~/.openclaw/skills
- 所有智能体共享
- 用户自定义Skills
内置Skills：随安装包发布（最低优先级）
- OpenClaw官方Skills
- 基础功能Skills “`text 优先级规则：

如果同名Skills存在于多个位置：
工作区Skills > 托管/本地Skills > 内置Skills

示例：
- 内置Skills：file-search v1.0
- 本地Skills：file-search v1.2（自定义版本）
- 工作区Skills：file-search v2.0（项目专用）

最终加载：工作区的 v2.0 版本
```text
**额外Skills目录**：

可以通过配置添加额外的Skills文件夹：

```json
{
  "skills": {
    "load": {
      "extraDirs": [
        "/path/to/shared-skills",
        "/path/to/team-skills"
      ]
    }
  }
}
```text
### 8.1.3 ClawHub使用指南

**访问方式**：

```bash
# 方式1：网页访问（推荐）
https://clawhub.ai

# 方式2：命令行工具
clawhub --help

# 方式3：OpenClaw内访问
你：打开ClawHub
```text
**常用命令**：

```bash
# 搜索Skills
clawhub search <关键词>

# 查看Skills详情
clawhub info <skill-slug>

# 安装Skills到工作区
clawhub install <skill-slug>

# 安装到指定目录
clawhub install <skill-slug> --dir /path/to/skills

# 更新单个Skills
clawhub update <skill-slug>

# 更新所有Skills
clawhub update --all

# 同步（扫描+发布更新）
clawhub sync --all

# 列出已安装的Skills
clawhub list

# 卸载Skills
clawhub uninstall <skill-slug>
```text
**安装位置说明**：

```bash
# 默认安装到当前工作目录
clawhub install nano-banana-pro
# 安装到：./skills/nano-banana-pro/

# 如果不在工作目录，回退到配置的工作区
# 安装到：<workspace>/skills/nano-banana-pro/
```text
**ClawHub界面布局**：


![ClawHub技能市场 - 浏览和安装技能](https://upload.maynor1024.live/file/1770738350555_image-20260210234513022.png)

### 8.1.3 技能分类和搜索

**主要分类**：

**1. 文件管理类**
- 文件搜索
- 文件整理
- 批量处理
- 格式转换

**2. 知识管理类**
- 网页剪藏
- 笔记同步
- 文献管理
- 知识图谱

**3. 日程管理类**
- 日历同步
- 提醒设置
- 任务管理
- 时间追踪

**4. 自动化类**
- 定时任务
- 网站监控
- 数据采集
- 流程自动化

**5. 工具类**
- 截图工具
- 翻译助手
- 计算器
- 单位转换

**6. 娱乐休闲类**
- 音乐播放
- 天气查询
- 新闻阅读
- 游戏娱乐

**搜索技巧**：

按名称搜索

搜索：file-search

按功能搜索

搜索：文件搜索

按标签搜索

搜索：#文件管理 #效率工具

按作者搜索

搜索：@作者名

组合搜索

搜索：文件 #管理 @官方

### 8.1.4 技能评价体系

**评价维度**：

| 维度 | 说明 | 权重 |
|------|------|------|
| ⭐ 评分 | 用户评分（1-5星） | 30% |
| 📥 下载量 | 安装次数 | 20% |
| 🔄 更新频率 | 维护活跃度 | 20% |
| 📝 文档质量 | 说明完善度 | 15% |
| 🐛 Bug数量 | 稳定性 | 15% |

**评分标准**：

⭐⭐⭐⭐⭐ (5.0) – 完美

功能完善
文档详细
无明显Bug
持续更新

⭐⭐⭐⭐ (4.0-4.9) – 优秀

功能完整
文档清晰
偶尔小Bug
定期更新

⭐⭐⭐ (3.0-3.9) – 良好

基本功能可用
文档一般
有些Bug
更新较慢

⭐⭐ (2.0-2.9) – 一般

功能不完整
文档缺失
Bug较多
很少更新

⭐ (1.0-1.9) – 较差

功能有问题
无文档
Bug很多
不再维护 “`text 如何选择Skills：

✅ 推荐安装：
- 评分 ≥ 4.0
- 下载量 > 1000
- 最近3个月有更新
- 文档完善

⚠️ 谨慎安装：
- 评分 3.0-3.9
- 下载量 < 1000
- 更新不频繁
- 文档不全

❌ 不推荐：
- 评分 < 3.0
- 长期不更新
- 无文档
- Bug多
```text
### 8.1.5 Skills 安装和管理

**安装方式**：

**方式1：通过ClawHub安装**

打开ClawHub
搜索Skills
点击”安装”按钮
等待安装完成 text **方式2：通过命令行安装** bash安装单个Skillopenclaw skill install file-search

安装多个Skills

openclaw skill install file-search note-sync calendar-sync

从URL安装

openclaw skill install https://github.com/user/skill-name

**方式3：通过OpenClaw对话安装**

你：帮我安装file-search这个Skill

OpenClaw：好的，我来帮你安装！

正在安装 file-search…

下载中… ✅
解压中… ✅
配置中… ✅
测试中… ✅

安装成功！✅

Skill信息：

名称：File Search
版本：v1.2.0
作者：OpenClaw官方
功能：智能文件搜索

现在你可以使用文件搜索功能了！

**查看已安装Skills**：

```bash
# 列出所有已安装的Skills
openclaw skill list

# 输出示例：
已安装Skills（12个）：

文件管理类（3个）：
✅ file-search v1.2.0
✅ file-organizer v2.0.1
✅ batch-processor v1.5.0

知识管理类（4个）：
✅ web-clipper v1.8.0
✅ note-sync v2.1.0
✅ github-manager v1.3.0
✅ paper-reader v1.0.5

日程管理类（2个）：
✅ calendar-sync v3.0.0
✅ reminder v1.4.0

工具类（3个）：
✅ screenshot v2.2.0
✅ translator v1.6.0
✅ calculator v1.1.0
```text
**更新Skills**：

```bash
# 检查更新
openclaw skill update --check

# 更新所有Skills
openclaw skill update --all

# 更新指定Skill
openclaw skill update file-search

# 输出示例：
检查更新中...

发现3个可更新的Skills：
1. file-search: v1.2.0 → v1.3.0
2. note-sync: v2.1.0 → v2.2.0
3. calendar-sync: v3.0.0 → v3.1.0

是否更新？[Y/n]
```text
**卸载Skills**：

```bash
# 卸载单个Skill
openclaw skill uninstall file-search

# 卸载多个Skills
openclaw skill uninstall file-search note-sync

# 输出示例：
正在卸载 file-search...
- 停止服务... ✅
- 清理配置... ✅
- 删除文件... ✅

卸载成功！✅
```text
---

## 8.2 必装Skills推荐

### 8.2.1 文件管理类Skills

**1. file-search（智能文件搜索）**

⭐ 评分：5.0/5.0 📥 下载量：50,000+ 👤 作者：OpenClaw官方

功能：

基于内容的智能搜索
支持多种文件格式
快速索引和检索
模糊匹配

使用示例：你：搜索包含”发票”的PDF文件

OpenClaw：找到3个匹配文件：

2026年1月发票.pdf
跑步机购买发票.pdf
办公用品发票.pdf “`text 2. file-organizer（文件自动整理）

⭐ 评分：4.8/5.0
📥 下载量：35,000+
👤 作者：OpenClaw官方

功能：
- 智能分类文件
- 批量重命名
- 重复文件检测
- 自动归档

使用示例：
你：整理下载文件夹

OpenClaw：正在整理...
- 图片 → Pictures/Downloads/
- 文档 → Documents/Downloads/
- 视频 → Videos/Downloads/
- 其他 → Others/Downloads/

整理完成！共处理156个文件 ✅
```text
**3. batch-processor（批量文件处理）**

⭐ 评分：4.7/5.0 📥 下载量：28,000+ 👤 作者：社区开发者

功能：

批量格式转换
批量压缩
批量提取信息
批量重命名

使用示例：你：把这个文件夹里的所有PNG转成JPG

OpenClaw：正在转换…

image1.png → image1.jpg ✅
image2.png → image2.jpg ✅
image3.png → image3.jpg ✅ … 共转换25个文件 ✅ “`text8.2.2 知识管理类Skills

4. web-clipper（网页剪藏）

⭐ 评分：4.9/5.0
📥 下载量：45,000+
👤 作者：OpenClaw官方

功能：
- 网页内容抓取
- 智能摘要生成
- 多平台保存（备忘录/Notion/Obsidian）
- 标签管理

使用示例：
你：保存这篇文章到备忘录
https://example.com/article

OpenClaw：已保存！
标题：AI技术发展趋势
摘要：[自动生成的摘要]
标签：#AI #技术 #趋势
位置：备忘录 > AI学习 ✅
```text
**5. note-sync（笔记同步）**

⭐ 评分：4.8/5.0 📥 下载量：32,000+ 👤 作者：OpenClaw官方

功能：

多平台笔记同步
实时备份
版本控制
冲突解决

支持平台：

Mac备忘录
Notion
Obsidian
Evernote “`text 6. github-manager（GitHub项目管理）

⭐ 评分：4.6/5.0
📥 下载量：25,000+
👤 作者：社区开发者

功能：
- 项目信息分析
- README总结
- 代码结构理解
- Star/Fork追踪

使用示例：
你：分析这个GitHub项目
https://github.com/user/project

OpenClaw：分析完成！
项目：Awesome Project
Stars：15.3k
语言：TypeScript
核心功能：[详细分析]
推荐指数：⭐⭐⭐⭐⭐
```text
### 8.2.3 日程管理类Skills

**7. calendar-sync（日历同步）**

⭐ 评分：5.0/5.0 📥 下载量：60,000+ 👤 作者：OpenClaw官方

功能：

Mac日历集成
自动创建事件
智能提醒
跨设备同步

使用示例：你：明天下午3点，会议室A开会

OpenClaw：已创建日历事件！标题：会议时间：2026-02-12 15:00-16:00 地点：会议室A 提醒：提前15分钟 ✅

**8. reminder（智能提醒）**

⭐ 评分：4.7/5.0 📥 下载量：38,000+ 👤 作者：OpenClaw官方

功能：

多级提醒设置
智能提醒策略
位置提醒
重复提醒

使用示例：你：每天早上8点提醒我喝水

OpenClaw：已设置提醒！内容：该喝水了💧 时间：每天 08:00 方式：飞书消息 ✅

### 8.2.4 自动化类Skills

**9. scheduler（任务调度）**

⭐ 评分：4.9/5.0 📥 下载量：42,000+ 👤 作者：OpenClaw官方

功能：

定时任务设置
Cron表达式支持
任务依赖管理
错误重试

使用示例：你：每天早上8点推送AI日报

OpenClaw：已设置定时任务！任务：AI日报推送时间：每天 08:00 Cron：0 8 * * * 状态：已启用 ✅

**10. monitor（网站监控）**

⭐ 评分：4.6/5.0 📥 下载量：28,000+ 👤 作者：社区开发者

功能：

网站变化检测
价格监控
内容更新提醒
RSS订阅

使用示例：你：监控这个博客的更新 https://example-blog.com

OpenClaw：已设置监控！网站：Example Blog 频率：每天2次通知：飞书消息 ✅

### 8.2.5 工具类Skills

**11. screenshot（截图工具）**

⭐ 评分：4.8/5.0 📥 下载量：35,000+ 👤 作者：OpenClaw官方

功能：

全屏截图
窗口截图
区域截图
OCR识别

使用示例：你：截图当前屏幕

OpenClaw：已截图！ [发送截图] 是否需要OCR识别文字？

![截图技能演示 - 自动捕获屏幕内容](https://upload.maynor1024.live/file/1770176353570_image_35.jpg)

**12. translator（翻译助手）**

⭐ 评分：4.7/5.0 📥 下载量：30,000+ 👤 作者：社区开发者

功能：

多语言翻译
实时翻译
文档翻译
术语库管理

使用示例：你：把这段话翻译成英文 “人工智能正在改变世界”

OpenClaw：翻译结果： “Artificial Intelligence is changing the world”

### 8.2.6 Skills推荐总结

**必装Top 10**：

| 排名 | Skill | 分类 | 评分 | 推荐理由 |
|------|-------|------|------|----------|
| 1 | calendar-sync | 日程管理 | 5.0 | 日历集成必备 |
| 2 | file-search | 文件管理 | 5.0 | 文件搜索神器 |
| 3 | web-clipper | 知识管理 | 4.9 | 知识收集利器 |
| 4 | scheduler | 自动化 | 4.9 | 定时任务必备 |
| 5 | note-sync | 知识管理 | 4.8 | 笔记同步工具 |
| 6 | file-organizer | 文件管理 | 4.8 | 文件整理助手 |
| 7 | screenshot | 工具 | 4.8 | 截图OCR工具 |
| 8 | reminder | 日程管理 | 4.7 | 智能提醒系统 |
| 9 | batch-processor | 文件管理 | 4.7 | 批量处理工具 |
| 10 | translator | 工具 | 4.7 | 翻译助手 |

**安装建议**：

```bash
# 基础套装（必装）
openclaw skill install calendar-sync file-search web-clipper

# 进阶套装（推荐）
openclaw skill install scheduler note-sync file-organizer

# 完整套装（全能）
openclaw skill install calendar-sync file-search web-clipper \
  scheduler note-sync file-organizer screenshot reminder \
  batch-processor translator
```text
### 8.2.7 核心Skills详解（2026年必备）

> 💡 **新增内容**：基于1715+个技能生态，精选7大核心技能，每个都经过实战验证。

#### 1. McPorter——跨平台连接基石 🏗️

**核心作用**：
让OpenClaw支持MCP（Model Context Protocol）协议，无需编写胶水代码，直接连接成千上万个现成的MCP Server。

**支持平台**：
- PostgreSQL数据库
- GitHub
- Slack
- Notion
- 其他主流平台

**安装命令**：
```bash
npx clawhub@latest install mcporter
```text
**配置示例**：
```bash
# 配置MCP服务器（以连接本地文件为例）
openclaw mcp add --transport stdio local-files npx -y @modelcontextprotocol/server-filesystem /root/Documents
```text
**使用场景**：
- "读取Notion中的项目文档，整理成Markdown"
- "把GitHub上的最新代码提交记录同步到本地"

**真实效果**：某开发团队使用McPorter技能，将日常协作效率提升了3倍。

#### 2. Brave Search——实时信息检索 🔍

**核心作用**：
解决传统AI Agent"数据过时"的问题，让OpenClaw能进行实时全网搜索，获取最新的GitHub Issue、StackOverflow解答、行业资讯。

**安装命令**：
```bash
npx clawhub@latest install brave-search
```text
**使用场景**：
- **代码报错排查**："帮我排查这个Python报错的原因，找最新的解决方案"
- **竞品调研**："查一下某产品最新功能的实现方式，附代码片段"

**效果**：2分钟即可得到带参考链接的详细报告，告别"凭训练数据瞎猜"的时代。

#### 3. TranscriptAPI——视频知识提取 🎥

**核心作用**：
稳定抓取YouTube视频字幕，带精确时间戳，将视频中的知识转化为可编辑的文本。

**安装命令**：
```bash
npx clawhub@latest install transcript-api
```text
**使用场景**：
"提取这个2小时Next.js教程视频的核心代码逻辑，按章节整理成学习笔记"

**价值**：无需手动拉进度条，AI直接将知识"喂到嘴边"，学习效率提升3倍以上。

#### 4. File System Manager——本地文件处理 💾

**核心作用**：
赋予OpenClaw本地文件的读写、修改、重构权限，支持批量修改代码、修复语法错误、自动提交Git。

**安装命令**：
```bash
npx clawhub@latest install file-system-manager
```text
![1Password CLI集成 - 安全管理密码凭证](https://upload.maynor1024.live/file/1770778507814_image-20260211105458447.png)



**重要安全配置**：

```bash
# 配置授权目录（仅开放工作目录，避免全硬盘访问）
openclaw config set fs.allow-path /root/Projects
```text
**使用场景**：
- "帮我重构这个React组件，优化代码结构并修复ESLint报错"
- "将本地Markdown文件转为PDF，保存到指定目录"

**注意**：该技能是双刃剑，需严格控制访问目录，避免误操作。

#### 5. Headless Browser (Playwright)——浏览器自动化 🤖

**核心作用**：
模拟真实人类的浏览器操作，支持点击、输入、截图、表单提交，针对无API的老旧网站实现自动化操作。

**安装命令**：
```bash
npx clawhub@latest install playwright-headless
```text
**使用场景**：
- "每天早上8点自动登录公司抢票系统，帮我预约车票"
- "定时截图某政府网站的公告，有更新就保存并提醒"

**注意**：该功能过于强大，需合规使用，避免违反平台规则。

#### 6. Design-Doc-Mermaid——图表自动生成 📊

**核心作用**：
通过自然语言指令生成Mermaid代码，自动渲染架构图、时序图、流程图。

**安装命令**：
```bash
npx clawhub@latest install design-doc-mermaid
```text
**使用场景**：
"帮我画1个用户注册的时序图，包含前端、后端、数据库交互"

**效果**：AI直接生成Mermaid代码并渲染成图，告别用画图工具手动拖拽的时代。

#### 7. Google Workspace集成——办公自动化 📧

**核心作用**：
无缝连接Gmail、Google Calendar、Google Docs，实现邮件整理、日程同步、文档自动生成。

**安装命令**：
```bash
npx clawhub@latest install google-workspace
```text
**授权配置**：
```bash
# 授权Google账号（按终端提示完成浏览器认证）
openclaw auth google
```text
**使用场景**：
- "查一下我这周的Gmail邮件和Calendar日程，生成一份简洁的周报，发给老板"
- "根据会议纪要，自动创建Google Calendar日程，邀请参会人员"

#### 8. find-skills + ProactiveAgent——Skills双幻神 🌟🌟

**核心作用**：
- **find-skills**：智能发现Skills，OpenClaw遇到问题时自动寻找合适的Skills
- **ProactiveAgent**：主动预测需求，观察使用习惯后主动提出自动化建议

**安装命令**：
```bash
# 安装Skills双幻神
npx clawhub@latest install find-skills
npx clawhub@latest install proactive-agent
```text
**使用场景**：
- find-skills：当OpenClaw无法完成某个任务时，自动搜索并推荐合适的Skills
- ProactiveAgent：做了几次日报转HTML后，主动问"要不要我帮你自动化这个流程？"

**GitHub链接**：
- find-skills: https://github.com/vercel-labs/skills/tree/main/skills/find-skills
- ProactiveAgent: https://github.com/leomariga/ProactiveAgent

⚠️ **安全提示**：ProactiveAgent安装时可能显示VirusTotal警告（因包含外部API调用），这是正常的，可以安全使用。

**核心Skills 安装命令汇总**：
```bash
# 一键安装9大核心Skills（包含Skills双幻神）
npx clawhub@latest install mcporter brave-search transcript-api \
  file-system-manager playwright-headless design-doc-mermaid google-workspace \
  find-skills proactive-agent
```text
---

## 8.3 Skills 安装方法详解

> 💡 **三种安装方式**：ClawHub CLI（推荐）、对话式安装（最简单）、手动安装（高级用户）

### 8.3.1 方法一：ClawHub CLI一键安装（推荐）⭐

**特点**：
- ✅ 最简单、最快捷
- ✅ 自动处理依赖
- ✅ 支持版本管理

**安装命令**：
```bash
npx clawhub@latest install <技能名称>
```text
**实际示例**：
```bash
# 安装网页搜索技能
npx clawhub@latest install brave-search

# 安装多个技能
npx clawhub@latest install brave-search transcript-api file-system-manager
```text
**常用管理命令**：
```bash
# 查看已安装技能
npx clawhub@latest list

# 更新技能
npx clawhub@latest update <skill-slug>

# 卸载技能
npx clawhub@latest uninstall <skill-slug>

# 更新所有技能
npx clawhub@latest update --all
```text
### 8.3.2 方法二：对话式安装（最懒人方式）

**特点**：
- ✅ 无需命令行
- ✅ 适合新手
- ✅ AI自动配置

**使用方法**：

直接在聊天界面中输入：

请安装这个技能：https://github.com/openclaw/skills/tree/main/skills/steipete/brave-search

AI会自动帮你下载和配置，完全不需要手动操作！

**适用场景**：
- 不熟悉命令行的用户
- 快速测试某个技能
- 临时安装单个技能

### 8.3.3 方法三：手动安装（高级用户）

**特点**：
- ✅ 完全掌控
- ✅ 可自定义配置
- ✅ 适合开发调试

**安装步骤**：
```bash
# 1. 克隆技能仓库
git clone https://github.com/openclaw/skills

# 2. 复制到全局技能目录
cp -r skills/skills/<作者>/<技能名> ~/.openclaw/skills/

# 3. 重启OpenClaw
openclaw gateway restart
```text
---

## 8.4 实战应用案例

> 💡 **三大场景完整案例**：内容创作、团队协作、智能家居，都有真实数据支撑。

### 8.4.1 场景一：自动化内容创作流程 ✍️

**需求背景**：
自媒体博主每天需要发布3篇公众号文章，包括搜索资料、撰写内容、配图、排版，传统方式需要6小时/天。

**使用的Skills组合**：
1. `brave-search` - 搜索最新资讯
2. `deep-research` - 深度研究主题
3. `fal-ai` - 生成配图
4. `notion` - 保存草稿
5. `markdown-formatter` - 格式化文章

**效果对比**：

| 指标 | 传统方式 | 使用 OpenClaw Skills |
|------|---------|-------------------|
| ⏰ 时间消耗 | 6小时/天 | 2小时/天 |
| 📈 文章产量 | 3篇/天 | 5篇/天 |
| 💰 配图成本 | 300元/天 | 0元/天 |

**具体操作流程**：
1. **信息收集**：使用brave-search搜索当日热点话题
2. **深度研究**：通过deep-research对选定话题进行深入分析
3. **内容生成**：AI根据研究成果自动撰写文章草稿
4. **配图生成**：使用fal-ai生成原创配图，避免版权问题
5. **格式排版**：自动格式化为公众号要求的样式

### 8.4.2 场景二：开发团队协作自动化 💻

**需求背景**：
10人开发团队需要管理日常协作，包括代码审查、任务分配、进度跟踪等。

**使用的Skills组合**：
1. `github` - 代码仓库管理
2. `linear` - 任务分配
3. `slack` - 团队通知
4. `google-calendar` - 会议安排

**效果提升**：
- 📊 PR审查时间：从2天降到4小时
- 🎯 任务分配效率：提升80%
- 💬 沟通成本：减少50%
- 📅 会议安排：自动化100%

**安装命令**：
```bash
npx clawhub@latest install github linear-integration slack-bot google-workspace
```text
**自动化工作流**：
1. **自动代码审查**：每次PR提交自动进行基础代码检查
2. **任务自动分配**：根据团队成员工作量和专长智能分配任务
3. **进度自动同步**：每日自动生成项目进度报告并发送到Slack
4. **会议自动安排**：根据团队成员日历自动安排最佳会议时间

### 8.4.3 场景三：智能家居全自动化 🏠

**需求背景**：
根据天气、时间、位置自动控制家中所有设备，提升生活品质。

**使用的Skills组合**：
1. `home-assistant` - 智能家居控制
2. `weather-api` - 天气查询
3. `location-tracker` - 位置追踪
4. `automation-scheduler` - 自动化调度

**实现的智能场景**：
- 🌅 **早晨唤醒**：早上7点自动打开窗帘、启动咖啡机
- 🌧️ **天气适应**：下雨时自动关闭窗户
- 🚗 **离家模式**：离家10分钟自动关闭所有灯光和空调
- 🏠 **回家预热**：到家前5分钟自动打开空调和灯光

**安装命令**：
```bash
npx clawhub@latest install home-assistant weather-api location-tracker automation-scheduler
```text
---

## 8.5 安全使用指南

> ⚠️ **重要**：Skills虽然强大，但也存在安全风险。必须严格遵循安全原则。

### 8.5.1 核心安全原则

1. **隔离运行环境**：重要的OpenClaw实例建议运行在Docker或专用虚拟机中
2. **严控权限范围**：对高危Skill仅开放必要的工作目录/操作权限
3. **优先官方认证**：安装带"官方认证""高星标"的技能
4. **安装前检查代码**：查看技能代码确认无恶意逻辑

### 8.5.2 安全配置命令

**权限控制**：
```bash
# 查看Skill的核心代码，确认无恶意逻辑
clawhub view file-system-manager

# 限制OpenClaw的系统资源使用
docker update --cpus=1 --memory=2g openclaw-2026

# 备份OpenClaw 配置，防止恶意修改
docker cp openclaw-2026:/root/.openclaw /root/openclaw-backup
```text
**安全检查清单**：
- ✅ 查看技能的GitHub仓库
- ✅ 检查技能的依赖项
- ✅ 阅读技能的权限要求
- ✅ 使用skill-scanner扫描恶意代码
- ✅ 在测试环境中先试用

### 8.5.3 ClawHavoc供应链攻击警告

> ⚠️ **OpenClaw历史上最严重的安全事件** - 每个「养虾人」都必须了解

ClawHavoc供应链攻击是OpenClaw历史上影响最广的安全事件，所有用户都应该了解其严重性和防护措施。

#### 攻击时间线

| 日期 | 事件 |
|------|------|
| 2026年1月27日 | 首个恶意Skill出现在ClawHub上，伪装成专业工具 |
| 2026年1月28-30日 | 攻击者快速上传大量恶意Skill，利用ClawHub缺乏审查机制的漏洞 |
| 2026年1月31日 | 攻击全面爆发，多名用户报告异常行为 |
| 2026年2月1日 | Koi Security正式命名该攻击为「ClawHavoc」 |
| 2026年2月上旬 | 社区展开大规模审计和清理 |

#### 攻击规模

| 指标 | 数据 |
|------|------|
| 当时ClawHub技能总数 | 约2,857个 |
| 初步确认恶意Skills | 341个（约12%） |
| 后续扫描发现的恶意Skills | 800+（约20%） |
| 可追溯到同一协调行动的 | 335个 |
| 受影响设备 | 135,000+ |

> ⚠️ **注意**：ClawHub当时约20%的Skills被确认为恶意。这意味着如果你随机安装5个Skill，大概率至少有1个是恶意的。

#### 攻击手法

攻击者的手法相当精密，具有极强的欺骗性：

1. **伪装成专业工具**：上传看似专业的Skill，名称和描述都很正常（如「advanced-code-review」「smart-scheduler」）
2. **诱导安装恶意组件**：诱导用户安装后，Skill会建议安装一个「helper agent」来增强功能
3. **植入信息窃取木马**：实际植入的是 Atomic macOS Stealer（AMOS）信息窃取木马
4. **篡改持久记忆文件**：更危险的是，攻击专门针对OpenClaw的持久记忆文件（SOUL.md和MEMORY.md），篡改Agent的长期行为指令

**篡改SOUL.md意味着你的Agent被「洗脑」了**。它的核心行为准则被改写，可能在后续所有交互中执行恶意操作，而你完全不知情。

#### 防护措施

**1. 安装前审查源码**

永远不要盲目安装ClawHub上的Skill。去GitHub查看源码，确认SKILL.md中没有可疑的指令。特别注意任何要求额外安装「helper」或「agent」的内容。

**2. 使用SecureClaw扫描**

社区推出了社区开源安全工具SecureClaw，可以扫描已安装的Skills检查恶意内容。

```bash
# 安装SecureClaw
npm install -g secureclaw

# 扫描已安装的skills
secureclaw scan ~/.openclaw/skills/

虽然不能100%防护，但能拦住已知的攻击模式。

3. 优先使用精选列表

参考 awesome-openclaw-skills 项目（31.4K Stars）的精选列表，而不是直接在ClawHub上随意搜索。

精选列表已经过滤掉了大量垃圾和恶意Skill。

4. 定期检查SOUL.md和MEMORY.md

养成习惯，定期检查这两个文件有没有被异常修改。如果发现不认识的内容，立即回滚并排查所有已安装的Skill。

关键认知：OpenClaw的Skill本质上是受信任代码。一旦安装，它就拥有和你的OpenClaw实例相同的权限。没有沙箱隔离，没有权限分级。这和npm生态早期面临的问题一模一样，但后果可能更严重，因为OpenClaw可以访问你的邮件、日历、消息和文件系统。

8.5.4 故障排查

问题一：技能安装失败

# 网络超时问题：检查服务器网络连接
ping github.com

# 配置国内镜像源（如遇网络问题）
npm config set registry https://registry.npmmirror.com
```text
**问题二：技能加载失败**
```bash
# 查看技能加载状态
openclaw plugins list

# 重新加载技能
openclaw plugins load <skill-name>

# 更新所有技能
clawhub update --all
openclaw gateway restart
```text
**问题三：技能执行无响应**
```bash
# 查看技能执行日志
openclaw logs --skill <skill-name>

# 检查权限配置
openclaw config get fs.allow-path
```text
---

## 8.6 Skills开发指南

> 💡 **创建自定义Skills**：如果现有的1715+个技能无法满足你的特殊需求，可以创建自己的技能。

### 8.6.1 创建自定义Skills

**创建步骤**：
1. **创建技能文件夹**：在 `~/.openclaw/skills/` 中创建新文件夹
2. **编写描述文件**：创建 `SKILL.md` 描述文件
3. **添加脚本配置**：编写必要的脚本和配置文件
4. **测试技能功能**：在本地测试技能是否正常工作
5. **分享到社区**：将技能贡献给社区

**技能目录结构**：

my-custom-skill/ ├── SKILL.md # 技能描述文档 ├── config.json # 配置文件 ├── scripts/ # 执行脚本 │ └── main.js └── README.md # 使用说明

**项目文件结构示例**：

![自定义Skills项目结构 - 完整的开发示例](https://upload.maynor1024.live/file/1770813835155_image3.png)

你的项目现在看起来应该是这样的：

my-project/ ├─ src/ │ └─ test.py # 项目源码 ├─ .claude/ │ ├─ skills/ │ │ └─ hello-world/ │ │ ├─ SKILL.md # Skill 定义（YAML + Instructions，机器可执行） │ │ └─ README.md # Skill 说明（人类阅读，可选） │ └─ config.yml # Claude 项目级配置（可选） ├─ .gitignore └─ README.md # 项目整体说明

**Claude Code执行效果**：

接下来我们在终端执行以下命令启动 Claude Code：

```bash
claude
```text
输入任务：

帮我写1个计算用户折扣的函数

Claude 会扫描已安装的 Skills，发现你的请求涉及 "Python 代码编写"，匹配了 python-naming-standard。

![Claude Code执行效果 - Skills自动匹配和调用](https://upload.maynor1024.live/file/1770813836904_image4.png)

它会根据 SKILL.md 中的要求，生成如下代码：

```python
def _internal_get_discount(user_score):
    # 计算逻辑...
    return discount
```text
### 8.6.2 技能开发最佳实践

**设计原则**：
1. **单一职责**：每个技能只解决1个特定问题
2. **接口简单**：提供清晰简单的使用接口
3. **错误处理**：完善的错误处理和用户提示
4. **文档完整**：提供详细的使用文档和示例

**示例技能模板**：
```javascript
// 简单技能示例
module.exports = {
  name: "my-custom-skill",
  description: "这是我的自定义技能",
  version: "1.0.0",
  
  async execute(params, context) {
    try {
      // 技能核心逻辑
      const result = await doSomething(params);
      return { success: true, data: result };
    } catch (error) {
      return { success: false, error: error.message };
    }
  }
};
```text
---

## 8.7 自定义Skills开发（原8.3节）

### 8.3.1 Skills开发基础

**为什么要开发Skills**：

1. **满足个性化需求**
   - 官方Skills无法满足
   - 特定业务场景
   - 企业内部工具

2. **学习和成长**
   - 深入理解OpenClaw
   - 提升编程能力
   - 贡献开源社区

3. **商业价值**
   - 开发付费Skills
   - 提供定制服务
   - 建立个人品牌

**开发前准备**：

```bash
# 1. 安装开发工具
npm install -g openclaw

# 2. 创建开发环境
openclaw dev init

# 3. 学习文档
openclaw docs

# 4. 查看示例
openclaw examples
```text
### 8.3.2 Skills文件格式（AgentSkills兼容）

**基本格式**：

OpenClaw使用兼容AgentSkills的Skills文件夹。每个Skills是1个包含`SKILL.md`的目录。

**最小示例**：

```markdown
---
name: nano-banana-pro
description: Generate or edit images via Gemini 3 Pro Image
---

# Nano Banana Pro

这个Skills可以生成和编辑图片。

## 使用方法

发送：画一只可爱的猫
```text
**完整示例**：

```markdown
---
name: gemini
description: Use Gemini CLI for coding assistance and Google search lookups.
homepage: https://github.com/example/gemini-skill
user-invocable: true
disable-model-invocation: false
metadata: {
  "openclaw": {
    "emoji": "♊️",
    "requires": {
      "bins": ["gemini"],
      "env": ["GEMINI_API_KEY"]
    },
    "primaryEnv": "GEMINI_API_KEY",
    "install": [
      {
        "id": "brew",
        "kind": "brew",
        "formula": "gemini-cli",
        "bins": ["gemini"],
        "label": "Install Gemini CLI (brew)"
      }
    ]
  }
}
---

# Gemini Skills

使用Gemini CLI进行编程辅助和Google搜索。

## 功能

- 代码生成
- 问题解答
- 网络搜索

## 使用方法

发送：用Gemini搜索最新的AI新闻
```text
**Frontmatter字段说明**：

| 字段 | 必填 | 说明 |
|------|------|------|
| `name` | ✅ | Skills名称（唯一标识） |
| `description` | ✅ | Skills描述 |
| `homepage` | ❌ | 项目主页URL |
| `user-invocable` | ❌ | 是否作为斜杠命令暴露（默认true） |
| `disable-model-invocation` | ❌ | 是否从模型提示词中排除（默认false） |
| `command-dispatch` | ❌ | 命令调度模式（tool=直接调度到工具） |
| `command-tool` | ❌ | 要调用的工具名称 |
| `command-arg-mode` | ❌ | 参数模式（raw=原始字符串） |
| `metadata` | ❌ | 元数据（单行JSON对象） |

**注意事项**：

⚠️ 重要：

内嵌智能体的解析器仅支持单行frontmatter键
metadata必须是单行JSON对象
在说明中使用{baseDir}引用Skills文件夹路径 “`text8.3.3 Skills门控（加载时过滤）

什么是门控：

门控是指在加载时根据条件过滤Skills，只加载满足条件的Skills。

门控配置：

通过metadata.openclaw配置门控条件：

---
name: nano-banana-pro
description: Generate or edit images
metadata: {
  "openclaw": {
    "requires": {
      "bins": ["uv"],
      "env": ["GEMINI_API_KEY"],
      "config": ["browser.enabled"]
    },
    "primaryEnv": "GEMINI_API_KEY",
    "os": ["darwin", "linux"]
  }
}
---
```text
**门控字段说明**：

| 字段 | 说明 | 示例 |
|------|------|------|
| `always` | 始终包含（跳过其他门控） | `"always": true` |
| `os` | 限制操作系统 | `"os": ["darwin", "linux"]` |
| `requires.bins` | 必需的二进制文件（全部） | `"bins": ["uv", "python"]` |
| `requires.anyBins` | 必需的二进制文件（任一） | `"anyBins": ["npm", "yarn"]` |
| `requires.env` | 必需的环境变量 | `"env": ["API_KEY"]` |
| `requires.config` | 必需的配置项 | `"config": ["browser.enabled"]` |
| `primaryEnv` | 主要环境变量名 | `"primaryEnv": "GEMINI_API_KEY"` |

**门控示例**：

```markdown
# 示例1：仅macOS可用
metadata: {
  "openclaw": {
    "os": ["darwin"]
  }
}

# 示例2：需要特定工具
metadata: {
  "openclaw": {
    "requires": {
      "bins": ["ffmpeg", "imagemagick"]
    }
  }
}

# 示例3：需要API 密钥
metadata: {
  "openclaw": {
    "requires": {
      "env": ["OPENAI_API_KEY"]
    },
    "primaryEnv": "OPENAI_API_KEY"
  }
}

# 示例4：需要配置启用
metadata: {
  "openclaw": {
    "requires": {
      "config": ["features.experimental"]
    }
  }
}
```text
### 8.3.4 Skills 安装器配置

**什么是安装器**：

安装器定义了如何安装Skills所需的依赖（二进制文件、包等）。

**支持的安装器类型**：

1. **Homebrew**（macOS/Linux）
2. **Node包管理器**（npm/pnpm/yarn/bun）
3. **Go**
4. **UV**（Python）
5. **Download**（直接下载）

**安装器示例**：

```markdown
---
name: gemini
metadata: {
  "openclaw": {
    "install": [
      {
        "id": "brew",
        "kind": "brew",
        "formula": "gemini-cli",
        "bins": ["gemini"],
        "label": "Install Gemini CLI (brew)",
        "os": ["darwin", "linux"]
      },
      {
        "id": "npm",
        "kind": "node",
        "package": "gemini-cli",
        "bins": ["gemini"],
        "label": "Install Gemini CLI (npm)",
        "global": true
      }
    ]
  }
}
---
```text
**安装器字段说明**：

| 字段 | 说明 |
|------|------|
| `id` | 安装器唯一标识 |
| `kind` | 安装器类型（brew/node/go/uv/download） |
| `formula` | Homebrew formula名称 |
| `package` | npm包名称 |
| `bins` | 安装后的二进制文件列表 |
| `label` | 显示给用户的标签 |
| `os` | 支持的操作系统 |
| `global` | 是否全局安装（Node） |

**Download安装器**：

```markdown
metadata: {
  "openclaw": {
    "install": [
      {
        "id": "download-mac",
        "kind": "download",
        "url": "https://example.com/tool-mac.tar.gz",
        "archive": "tar.gz",
        "extract": true,
        "stripComponents": 1,
        "targetDir": "~/.openclaw/tools/my-tool",
        "bins": ["my-tool"],
        "label": "Download for macOS",
        "os": ["darwin"]
      }
    ]
  }
}
```text
**安装器选择逻辑**：

如果列出多个安装器，Gateway会选择首选选项：
- 优先选择brew（如果可用）
- 其次选择node
- 最后选择其他
如果所有安装器都是download类型：
- OpenClaw会列出每个条目
- 让用户选择适合的构件
Node安装遵循配置：
- skills.install.nodeManager（默认npm）
- 选项：npm/pnpm/yarn/bun “`text8.3.5 项目结构

标准Skills目录结构：

my-skill/
├── SKILL.md              # Skills定义（必需）
├── README.md             # 说明文档
├── tools/                # 工具脚本
│   ├── setup.sh         # 安装脚本
│   └── cleanup.sh       # 清理脚本
├── examples/             # 示例
│   └── example.md
└── assets/               # 资源文件
    └── icon.png
```text
**SKILL.md引用文件**：

在SKILL.md中可以使用`{baseDir}`引用Skills文件夹路径：

```markdown
---
name: my-skill
description: My custom skill
---

# My Skill

## 安装

运行安装脚本：
```bash
bash {baseDir}/tools/setup.sh
```text
## 示例

查看示例：{baseDir}/examples/example.md

本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容，请与我们联系，一经查实，本站将立刻删除。

THE END