Shell / BashSaaSAI
OpenClaw Skill 开发指南：从零创建第一个 AI 技能
OpenClaw Skill 的开发方法，解释了 Skill 作为执行说明书与传统插件的区别。内容涵盖 Skill 的核心架构、最小结构、Workflow 编写规范以及脚本集成方式。通过实战案例演示了如何创建每日早报助手，并提供了调试优化、权限控制及安全警示等进阶技巧，帮助开发者快速构建 AI 自动化任务。
OpenClaw Skill 的开发方法，解释了 Skill 作为执行说明书与传统插件的区别。内容涵盖 Skill 的核心架构、最小结构、Workflow 编写规范以及脚本集成方式。通过实战案例演示了如何创建每日早报助手，并提供了调试优化、权限控制及安全警示等进阶技巧，帮助开发者快速构建 AI 自动化任务。
Skill 是 OpenClaw 的核心机制，它让 AI 学会'做事'而不是'说话'。本文带你从零开始，亲手创建第一个属于自己的 Skill，无需编程基础。
传统插件需要开发者编写代码、处理 API 调用、管理后台服务。而 OpenClaw 的 Skill，本质上是一份给 AI 看的执行说明书。
你可以把它想象成教一个新员工做事：你不会直接替他做，而是告诉他'第一步做什么，第二步做什么，遇到什么情况怎么处理'。AI 读完这份说明书，就能自主完成任务。
一个最简单的 Skill 只需要：
skills/
└── 你的技能名/
└── SKILL.md
默认存放路径：~/.openclaw/workspace/skills/
要理解 Skill 的工作原理，需要了解 OpenClaw 的整体架构：
| 层级 | 核心功能 | 与 Skill 的关系 |
|---|---|---|
| 第 1 层：用户接口层 | 接收用户输入 | 用户通过指令触发 Skill |
| 第 2 层：Gateway 核心层 | 运行时治理 | 管理 Skill 的加载与调度 |
| 第 3 层：消息处理层 | 业务逻辑流转 | 路由消息到对应 Skill |
| 第 4 层：扩展与插件层 | 功能扩展 | Skill 系统所在层 |
| 第 5 层：基础设施层 | 通用支撑能力 | 提供沙箱、记忆等能力 |
当用户下达指令时，Gateway 会解析意图，找到匹配的 Skill，然后将任务交给 Agent Loop 执行引擎。Agent Loop 会按照 SKILL.md 中的 Workflow 逐步执行，并在必要时调用外部工具或脚本。
一条消息在 OpenClaw 中的完整旅程如下：
这个过程中，Skill 扮演的角色就是告诉 AI：'你需要做什么'以及'怎么做'。
我们将创建一个名为 daily-brief 的 Skill，功能是每天早上自动抓取上海天气和 V2EX 热门帖子，生成一份简洁的早报推送给用户。
首先，在 OpenClaw 的 skills 目录下创建新文件夹：
mkdir -p ~/.openclaw/workspace/skills/daily-brief
touch ~/.openclaw/workspace/skills/daily-brief/SKILL.md
用任何文本编辑器打开 SKILL.md，写入以下内容：
### name: daily-brief
description: >
每日早报，上海天气 + V2EX 热帖。
Use when: 用户需要简报，或早上 8 点定时执行。
NOT for: 专业气象预报、长内容新闻。
## Daily Brief 每日早报
### When to Run
- 每天 8:00 AM 自动执行
- 用户说'今日简报''今天热点''早上好'
- 用户需要快速了解今日热点时
### Workflow
1. 获取上海天气：
curl "https://wttr.in/Shanghai?format=3"
2. 拉取 V2EX 热门帖子：
curl https://www.v2ex.com/api/topics/hot.json
3. 从返回结果中提取前 5 条帖子的标题和节点名称
4. 按指定格式整理信息
### Output Format
📅 今日简报 - {当前日期}
🌤 上海天气：{天气结果}
🔥 V2EX 今日热帖：
1. {标题 1}（{节点 1}）
2. {标题 2}（{节点 2}）
3. {标题 3}（{节点 3}）
4. {标题 4}（{节点 4}）
5. {标题 5}（{节点 5}）
让我们拆解一下这个 SKILL.md 的结构：
name：技能名称，用于系统识别description：技能描述，帮助 AI 判断何时使用该技能保存文件后，重启 OpenClaw 网关：
openclaw gateway restart
测试执行：
openclaw chat --prompt "使用 daily-brief 生成今日简报"
如果一切正常，你就能看到 AI 按照你定义的格式输出的早报。
想让技能每天自动执行？添加定时配置：
openclaw cron add daily-brief "0 8 * * *" --skill daily-brief
这样每天早上 8 点，系统会自动执行这个 Skill 并将结果推送到你配置的渠道（如微信、钉钉等）。
当任务需要复杂的逻辑处理（如数据清洗、多源整合、条件判断）时，单纯的命令行可能不够用。这时可以为 Skill 配套脚本文件。
skills/
└── trend-scout/
├── SKILL.md
├── scripts/
│ └── run.sh
└── references/
└── source.md
SKILL.md 中可以通过命令调用外部脚本：
### Workflow
1. 执行 Python 脚本进行数据采集和分析：
python3 ~/.openclaw/workspace/skills/trend-scout/scripts/analyze.py
2. 根据脚本输出生成报告
3. 格式化输出结果
openclaw logs --skill daily-brief --tail 50
通过日志可以查看 AI 每一步的执行情况，发现问题所在。
| 问题 | 可能原因 | 解决方案 |
|---|---|---|
| AI 不触发 Skill | 触发条件描述不清晰 | 在 When to Run 中增加更多关键词 |
| 执行结果不符合预期 | Workflow 步骤不够具体 | 细化每一步，增加具体命令 |
| 输出格式混乱 | Output Format 不规范 | 明确定义格式，使用 Markdown |
| API 调用失败 | 命令格式错误 | 在终端先测试命令可行性 |
完成 Skill 开发后，可以分享给社区：
clawhub publish daily-brief
重要风险提示： 下载他人 Skill 时务必注意安全风险，检查 SKILL.md 中的命令是否涉及敏感操作，查看技能评价和下载量，优先选择官方认证或高信誉开发者发布的技能。
在配置文件中限制 Skill 的权限范围：
{
"skills": {
"daily-brief": {
"allowNetwork": true,
"allowFileSystem": false,
"allowExec": ["curl", "python3"]
}
}
}
目前存在一个适合开发垂直领域的 Agent 空白象限。这意味着：
OpenClaw 的 Skill 系统，正是让 AI 从'能说'跨越到'能干'的关键桥梁。通过本文，你已经掌握了从零创建 Skill 的核心技能。这个名为 daily-brief 的简单技能，虽然只有几十行 Markdown，但它代表了 AI 应用的新范式：人类定义规则，AI 执行任务。
在这个转型过程中，掌握 Skill 开发能力的人，将拥有定义未来工作方式的主动权。
你的第一个 Skill，就从今天开始。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online