OpenClaw 实战：5分钟搞懂 AI 应用的运行环境与 Skill 标准

——"OpenClaw 是舞台，Skill 是节目。一个管全场，一个管干活。"

一、OpenClaw 是什么？

一句话： OpenClaw 是一个运行在你本地电脑（或服务器）上的 AI 网关，把各种聊天软件和 AI 助手连接起来。

想象这个场景：

• 你在微信/Telegram/飞书上发一条消息
• 消息通过 OpenClaw 传给 AI 助手
• AI 处理完，返回结果给你

整个过程，你的 AI 助手一直在运行，随时待命。

核心能力

二、Skill 是什么？

一句话： Skill 是 OpenClaw 里的"应用程序"。

类比理解：

你打开手机能装各种 App，OpenClaw 里就能装各种 Skill。

三、Skill 长什么样？

一个 Skill 就是一个文件夹，里面装着它需要的所有东西：

my-skill/
├── SKILL.md          ← 唯一必须文件（说明书）
├── scripts/          ← 可执行脚本（.py/.sh）
├── references/       ← 参考文档（需要时加载）
└── assets/          ← 资源文件（图片/模板）

3.1 SKILL.md——核心说明书

每个 Skill 必须有一个 SKILL.md，分两部分：

YAML 头信息（必需）：

---
name: my-skill
description: 这个技能做什么用，什么时候该用它
---

Markdown 正文： 怎么用这个 Skill，有哪些坑要避免。

description 是关键——AI 通过它判断什么时候该用这个 Skill。

3.2 scripts/——自动化脚本

放那些需要稳定执行的代码。比如：

• rotate_pdf.py —— 旋转 PDF
• fetch_data.py —— 定时抓数据

脚本的好处：不用每次都让 AI 现写，直接调用，省心省力。

3.3 references/——参考文档

放那些"需要时再查"的文档：

• API 文档
• 业务规则
• 模板说明

AI 平时只看 SKILL.md，需要的时候才加载这些文件，节省注意力。

3.4 assets/——静态资源

放 Skill 要输出的东西：

• Logo 图片
• HTML 模板
• 字体文件

这些不用读进脑子，直接拿来用。

四、Skill 的标准流程

4.1 创建流程

1️⃣ 理解需求——这个 Skill 要解决什么问题？
2️⃣ 规划内容——需要几个脚本、几份文档？
3️⃣ 初始化——运行 init_skill.py 生成模板
4️⃣ 编写内容——填 SKILL.md，加脚本和文档
5️⃣ 打包发布——运行 package_skill.py 生成 .skill 文件

4.2 命名规范

• 全小写，用中划线
• 少于 64 字符
• 动词优先，说明动作：fetch-weather、send-email

4.3 打包规则

最后一步用 package_skill.py 打包，生成 .skill 文件（本质是 zip 包）。

重要： 不允许软链接，打包直接报错。

五、为什么这样设计？

你可能在想：搞这么复杂干嘛？

原因：

1. 上下文有限 —— AI 能看的字数有限。SKILL.md 精简，只放最核心的；详细文档放 references，用时再查。

2. 复用大于重复 —— 脚本写一次，用一百次。不用每次让 AI 重新发明轮子。

3. 分离关注点 —— 说明书是说明书，代码是代码，资源是资源。各自做好自己的事。

六、实战例子

举两个真实 Skill 感受一下：

天气 Skill

weather/
├── SKILL.md           # "查天气预报时用这个"
└── (纯读取，无脚本)

PDF 处理 Skill

pdf-editor/
├── SKILL.md              # "处理 PDF 时用这个"
├── scripts/
│   └── rotate_pdf.py     # 旋转 PDF 的稳定脚本
└── references/
    └── api.md            # 详细 API 文档

七、快速上手命令

总结

下一课，手把手带你从零构建一个真正能跑的 Skill。

有问题直接问。 🖊️