从零开始编写你的第一个 OpenClaw Skill：让 AI 助手学会新技能

前言

如果你正在使用 OpenClaw（那只红色小龙虾 ），你可能会发现它默认就能做很多事情：聊天、执行命令、操作浏览器...但有些特定的、重复性的任务，每次都要输入一长串指令，是不是有点累？

这时候，Skill 就派上用场了。

什么是 Skill？

Skill 是 OpenClaw 的「技能包」，你可以把它理解为给 AI 助手写的一份「操作手册」。当你在 OpenClaw 中安装了一个 Skill，就相当于给小龙虾穿上了一件专业的工作服，让它变成了某个领域的专家。

Skill 能做什么？

1. 封装复杂流程 - 把多步骤操作打包成一条指令
2. 集成专业工具 - 比如操作特定格式的文件、调用特定 API
3. 注入领域知识 - 公司内部规范、数据库结构、业务逻辑
4. 提供可复用资源 - 脚本、模板、参考文档

一个简单的例子

假设你经常需要处理 PDF 文件：旋转页面、提取文字、合并文档...每次都要写不同的代码。但如果安装了 pdf-editor Skill，只需要一句话，OpenClaw 就会自动调用 Skill 中的脚本完成任务。

Skill 的核心结构

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

• SKILL.md - 必需：技能定义文件
• scripts/ - 可选：可执行脚本
• references/ - 可选：参考文档
• assets/ - 可选：资源文件（模板、图标等）

SKILL.md 是核心

每个 Skill 必须有一个 SKILL.md 文件，它由两部分组成：

1. YAML Frontmatter（元数据）

重要：description 是 OpenClaw 判断何时使用这个 Skill 的关键，所以要写清楚这个技能做什么和什么情况下应该触发。

2. Markdown 正文（操作指南）

正文部分是给 AI 看的「操作手册」，告诉它如何使用这个技能完成任务。

实战：编写你的第一个 Skill

让我们创建一个简单的「每日问候」Skill，它会根据时间给出不同的问候语。

步骤 1：创建目录结构

mkdir -p daily-greeting

步骤 2：编写 SKILL.md

创建 daily-greeting/SKILL.md 文件，包含 YAML frontmatter 定义 name 和 description，以及 Markdown 格式的操作指南。

步骤 3：打包 Skill

使用 OpenClaw 的打包脚本打包后会生成 .skill 文件，这是一个 zip 格式的压缩包。

步骤 4：安装到 OpenClaw

将 .skill 文件放到 OpenClaw 的 skills 目录下，重启 OpenClaw 即可生效。

Skill 设计最佳实践

1. 保持简洁

Context window 是宝贵的公共资源。Skill 不应该包含 AI 已经知道的内容，只添加它不知道的信息。

2. Description 要写好

description 是 Skill 被触发的关键。要包含：做什么和何时触发。

3. 使用渐进式披露

对于复杂的 Skill，不要把所有内容都塞进 SKILL.md，使用 references/ 目录分层组织。

4. 脚本要测试

scripts/ 目录下的脚本必须经过实际运行测试，确保没有 bug。

发布你的 Skill

写好 Skill 后，你可以：

1. 自用 - 放到自己的 OpenClaw skills 目录
2. 分享给团队 - 作为团队内部工具分发
3. 开源发布 - 发布到 ClawHub 社区

总结

Skill 是 OpenClaw 的核心扩展机制，掌握 Skill 编写，就等于掌握了让 AI 助手无限进化的能力。

核心要点：

1. SKILL.md 是必需的，包含 name 和 description
2. description 决定了 Skill 何时被触发，要写好
3. 保持简洁，只添加必要的内容
4. 脚本要测试，确保可运行
5. 复杂 Skill 使用 references/ 分层组织

现在就去试试吧！给你的小龙虾装上新技能

如果你觉得这篇文章有帮助，欢迎点赞收藏，也欢迎在评论区分享你创作的 Skill！

本文基于 OpenClaw 官方 Skill 规范编写，更多详情请参考 OpenClaw 文档