💡 本章目标：深入理解Skills本质，学会使用ClawHub技能市场，掌握必装Skills推荐，学习自定义Skills开发和管理技巧。
⚠️ 重要提示：没有Skills的OpenClaw只是1个聊天机器人，有了Skills才能真正成为你的AI助手！
📊 Skills 生态概览：OpenClaw 拥有庞大的 Skills 生态系统，包括内置49个、官方93个、社区1715+个，总计1800+个可用 Skills。详细分类和说明请参考 Skills 生态说明。
8.0 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核心结构示意图**：
**Frontmatter字段说明**：
| 字段 | 必需 | 说明 |
|------|------|------|
| name | ✅ | Skill 名称，最长 64 字符，只能使用小写字母、数字和 `-`，且不能以 `-` 开头或结尾 |
| description | ✅ | 功能与使用场景说明，最长 1024 字符，不能为空 |
| license | ❌ | 许可证名称或指向随 Skill 附带的许可证文件 |
| compatibility | ❌ | 环境与依赖说明（产品、系统包、网络权限等），最长 500 字符 |
| metadata | ❌ | 自定义键值对，用于扩展元数据（如作者、版本号） |
| allowed-tools | ❌ | 允许使用的工具列表（空格分隔，实验性功能） |
**完整Skills结构**（包含资源文件）：
如果你需要一些参考资料、参考实例、执行脚本，可以使用更复杂的 Skill 目录结构：
my-skill/ ├── SKILL.md # 必需：指令 + 元数据 ├── scripts/ # 可选：可执行代码 ├── references/ # 可选：文档资料 └── assets/ # 可选：模板、资源
---
## 🎯 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.com），类似于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.com
# 方式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界面布局**：
### 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安装单个Skill
openclaw 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个文件 ✅
```text
8.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识别文字？
**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
**重要安全配置**：
```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 故障排查
**问题一：技能安装失败**
```bash
# 网络超时问题：检查服务器网络连接
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 # 使用说明
**项目文件结构示例**：
你的项目现在看起来应该是这样的：
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。
它会根据 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-cli
# 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文件夹路径
```text
8.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
```text
8.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
由于内容较长，让我先提交当前进度，然后继续完成剩余章节。