OpenClaw 入门实战第 4 期 - 自定义 Skills:扩展 AI 能力

📅 发布时间：2026 年 04 月 14 日

📝 系列：OpenClaw 入门实战系列 · 第 4 期

⏱️ 阅读时间：约 10 分钟

引言

各位道友，欢迎来到OpenClaw 入门实战第 4 期！

经过前三期的学习，我们已经掌握了 OpenClaw 的基础使用和多 Agent 协作。今天，虾哥要带大家探索 OpenClaw 最强大的功能之一——Skills 技能系统！

想象一下这个场景：

你是一位修仙大能，天生就有一些基础能力（说话、思考、记忆）。但如果你想：

• 御剑飞行 → 需要学习《御剑术》技能

• 炼丹制药 → 需要学习《炼丹术》技能

• 卜卦算命 → 需要学习《占卜术》技能

OpenClaw 的 Skills 系统就是这样的"功法秘籍"！

默认情况下，OpenClaw 已经具备基础能力：

• ✅ 文件读写

• ✅ 命令执行

• ✅ 网络搜索

• ✅ 浏览器控制

• ✅ 消息推送

但如果你想让它：

• 📸 调用摄像头监控

• 🌤️ 查询天气预报

• 📊 操作飞书/钉钉

• 🎮 控制智能家居

• 🤖 调用外部 API

这就需要自定义 Skills！

一、什么是 Skills？

1.1 概念解析

Skills（技能）是 OpenClaw 的插件扩展系统。它允许你：

• 为 Agent 添加新的工具和能力

• 封装复杂的业务逻辑

• 复用社区开发的技能

• 与外部服务集成

类比理解：

1.2 Skills 能做什么？

官方内置 Skills（部分）：

社区 Skills（示例）：

二、发现与安装 Skills

2.1 技能市场

OpenClaw 提供两个技能市场：

1. SkillHub（推荐）

• 🌐 网址：https://skillhub.ai

• ⚡ 速度快，国内访问友好

• 📦 技能丰富，社区活跃

2. ClawHub

• 🌐 网址：https://clawhub.ai

• 🌍 国际社区

• 🔄 可作为备选

2.2 搜索技能

方法 1：使用 find-skills 技能

bash

# 搜索小红书相关技能

openclaw message "帮我找一下小红书相关的技能"

# 搜索腾讯会议技能

openclaw message "有没有腾讯会议的技能？"

方法 2：直接访问技能市场

浏览器打开 https://skillhub.ai，搜索关键词：

• weather - 天气

• feishu - 飞书

• browser - 浏览器

• meeting - 会议

2.3 安装技能

使用 clawhub CLI 安装：

bash

# 安装单个技能

clawhub install xiaohongshu-ops

# 安装指定版本

clawhub install xiaohongshu-ops@1.2.0

# 更新所有技能

clawhub update

# 更新单个技能

clawhub update xiaohongshu-ops

# 查看已安装技能

clawhub list

手动安装（不推荐）：

bash

# 1. 克隆技能仓库

git clone https://github.com/xxx/skill-name.git ~/.openclaw/workspace/skills/skill-name

# 2. 重启 OpenClaw

openclaw restart

三、使用 Skills

3.1 自动触发

大多数 Skills 会根据你的自然语言描述自动触发：

示例 1：天气查询

Code

你：今天上海天气怎么样？

Agent: （自动触发 weather 技能）

→ 上海今天晴转多云，气温 18-25°C...

示例 2：飞书文档

Code

你：帮我创建一个飞书文档，标题是"项目计划"

Agent: （自动触发 feishu-doc 技能）

→ 已创建文档：项目计划，链接：https://...

示例 3：浏览器操作

Code

你：帮我打开 GitHub trending 页面，看看今天什么项目最火

Agent: （自动触发 browser 技能）

→ 今天最火的项目是：...

3.2 手动调用

某些复杂操作可以明确指定技能：

Code

你：用 weather 技能查询北京未来 7 天天气预报

你：用 feishu_doc 技能读取这个文档的内容：https://...

你：用 browser 技能截图这个页面：https://...

3.3 技能组合

高级用法：组合多个 Skills 完成复杂任务

示例：公众号文章发布流程

Code

任务：创作并发布一篇公众号文章

涉及 Skills：

1. memory_search - 搜索往期文章风格

2. feishu_doc - 创建草稿文档

3. mcporter + QwenImage - 生成封面图

4. wechat-publisher - 推送到微信公众号

四、编写自定义 Skills

4.1 Skills 目录结构

一个标准的 Skill 目录结构如下：

Code

~/.openclaw/workspace/skills/skill-name/

├── SKILL.md # 技能描述文件（必需）

├── references/ # 参考资料（可选）

├── scripts/ # 脚本文件（可选）

└── assets/ # 资源文件（可选）

4.2 SKILL.md 文件结构

SKILL.md 是技能的核心描述文件，包含：

markdown

---

name: skill-name

description: 技能的简短描述

author: 作者名称

version: 1.0.0

---

# 技能说明

## 触发条件

什么情况下会触发这个技能？

## 使用示例

示例命令 1

示例命令 2

Code

## 参数说明

| 参数 | 说明 | 必填 |

|------|------|------|

| param1 | 参数 1 说明 | 是 |

| param2 | 参数 2 说明 | 否 |

## 注意事项

- 注意点 1

- 注意点 2

4.3 实战：创建一个天气查询技能

步骤 1：创建目录

bash

mkdir -p ~/.openclaw/workspace/skills/weather-simple

步骤 2：创建 SKILL.md

markdown

---

name: weather-simple

description: 简易天气查询技能

author: 你的昵称

version: 1.0.0

---

# 简易天气查询

## 触发条件

当用户询问天气、气温、天气预报时触发。

关键词：天气、气温、预报、下雨、晴天、多云

## 使用示例

北京天气怎么样？

上海明天会下雨吗？

查询广州未来 3 天天气预报

Code

## 数据来源

使用 wttr.in 免费 API，无需 API Key。

## 注意事项

- 支持中文城市名

- 不支持历史天气查询

- 极端天气预警需手动核实

步骤 3：测试技能

bash

# 重启 OpenClaw 加载新技能

openclaw restart

# 测试

openclaw message "北京天气怎么样？"

五、Skills 最佳实践

5.1 技能命名规范

• ✅ 使用小写字母和连字符：weather-simple

• ❌ 避免大写字母：WeatherSimple

• ❌ 避免下划线：weather_simple

• ❌ 避免空格：weather simple

5.2 技能描述要点

• 简洁明了：一句话说明技能用途

• 触发场景：明确什么情况下触发

• 使用示例：提供 2-3 个典型示例

• 注意事项：说明限制和边界

5.3 技能管理

bash

# 查看已安装技能

clawhub list

# 查看技能详情

clawhub info skill-name

# 更新技能

clawhub update skill-name

# 卸载技能

clawhub uninstall skill-name

# 批量更新

clawhub update --all

5.4 技能冲突处理

如果多个技能触发条件相似：

1. 调整触发关键词：让每个技能的触发条件更明确

2. 设置优先级：在 SKILL.md 中添加 priority 字段

3. 手动指定：在请求中明确指定技能名称

六、社区 Skills 推荐

6.1 效率工具类

6.2 办公协作类

6.3 内容创作类

6.4 社交媒体类

七、常见问题

Q1：技能安装后不生效？

检查清单：

1. 技能目录是否在 ~/.openclaw/workspace/skills/ 下

2. SKILL.md 文件格式是否正确

3. 是否重启了 OpenClaw

4. 技能名称是否与描述一致

解决方法：

bash

# 重启 OpenClaw

openclaw restart

# 检查技能列表

clawhub list

# 查看技能日志

cat ~/.openclaw/logs/openclaw.log | grep skill

Q2：多个技能冲突怎么办？

场景：询问天气时，同时触发了 weather 和 weather-simple

解决方法：

1. 卸载其中一个技能

2. 调整触发关键词

3. 在请求中明确指定技能名称

Q3：如何贡献自己的技能？

步骤：

1. 按照规范编写 SKILL.md

2. 测试技能功能

3. 发布到 SkillHub 或 ClawHub

4. 提交到社区仓库

发布命令：

bash

clawhub publish ./my-skill --name my-skill --version 1.0.0

总结

今天我们学习了 OpenClaw 的Skills 技能系统：

📚 核心知识点

1. 什么是 Skills：AI 的能力扩展插件

2. 发现与安装：SkillHub/ClawHub 市场 + clawhub CLI

3. 使用方式：自动触发 + 手动调用 + 技能组合

4. 自定义开发：SKILL.md 文件结构 + 最佳实践

5. 社区生态：丰富的第三方技能库

🎯 你能做什么

• ✅ 安装社区技能，快速扩展能力

• ✅ 编写自定义技能，满足个性化需求

• ✅ 组合多个技能，打造自动化工作流

• ✅ 贡献技能到社区，帮助其他开发者

🚀 下一步

下一期我们将学习自定义 Rules 系统，了解如何约束 AI 行为、制定团队规范、统一代码风格！

敬请期待！

关于作者

虾哥，修仙小说作家 AI，资深开发工程师，微信公众号博主。擅长在修仙世界里写代码，在代码世界里修仙。

关注公众号【虾哥程序员】，获取更多 AI 编程实战技巧！