2026年OpenClaw 用了一周，才明白 Skill 才是关键！

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

当大家把OpenClaw吹上天，而你好不容易把 OpenClaw 跑起来了，却发现它只会聊天时，你是不是装了个假龙虾。

其实，OpenClaw 的核心价值不在于对话，而在于它能替你做事——发邮件、爬网页、写代码、调 API。而真正让这一切成为可能的，就是 Skill。

没有装Skill的龙虾，就像是一台没有装App的手机，比如你现在要OpenClaw总结这篇文章，他肯定做不到，因为他不知道怎么去绕过微信的robots协议。

除非你告诉它怎样才能获取到这篇文章的内容，才能给你总结。而这个操作方法就是一个Skill。

Skill是什么？

一句话概括Skill：Skill就是写给 Agent（Openclaw）看的操作手册。

本质上，Skill 就是一个文件夹里放一个 SKILL.md 文件，用自然语言告诉 Agent：在什么情况下用这个技能、该怎么一步步完成任务、遇到边界情况应该怎么处理。Skill 的文件结构：一个文件夹，一个核心文件

创建一个 Skill，只需要在指定目录新建一个文件夹，并在其中放入 SKILL.md。标准目录结构如下：

skill-name/ ├── SKILL.md          # 必须，Skill 的定义文件 ├── README.md         # 推荐，面向人类读者的文档 ├── references/       # 可选，会被按需加载进上下文的参考资料 ├── examples/         # 可选，示例文件 ├── scripts/          # 可选，Python/Bash 等可执行脚本 └── assets/           # 可选，模板、图标等静态资源

SKILL.md 是唯一的硬性要求。其他文件都是锦上添花——references 文件夹里的内容可以在 Skill 触发后按需加载到上下文，scripts 文件夹存放那些需要确定性执行、不希望 Agent 每次重写的代码片段。SKILL.md 解剖：Frontmatter 是触发器，正文是操作手册Frontmatter：只写 name 和 description

SKILL.md Frontmatter 的格式如下：

name: weekly-report description: 当用户需要生成周报、整理本周工作记录、汇总 PR 和 Issue 时使用。

OpenClaw 只读取 name 和 description 来决定是否触发这个 Skill。这两个字段直接决定了 Agent 能不能找到你的 Skill。

description 的写法：触发条件，而非功能介绍

description 是整个 Skill 最关键的字段，但也是最容易写错的地方。很多开发者习惯把它写成功能说明，这是错误的。

正确的写法是描述触发条件，也就是在什么情况下该用这个 Skill：

差：描述了工作流程

description: 读取日志并生成周报，包含 PR 汇总和 Markdown 输出

好：描述了使用场景

description: 当用户需要生成周报、整理本周工作记录、汇总 PR 和 Issue 时使用Skill

正文：给凌晨三点值班的工程师写操作清单

触发 Skill 之后，Agent 才会读取正文。正文是 Markdown 格式，用来提供逐步执行的操作指南。好的 Skill 正文有一个形象的比喻：把它当成你要交给一个疲惫的值班工程师的检查清单——简明、确定、无歧义。

以一个周报生成 Skill 为例，合格的正文应该这样写：

# 周报生成

工作流

1. 读取配置路径下最近 7 天的日志文件 2. 使用 git log --since=7.days --merges 列出合并的 PR 3. 用配置的 CLI 工具列出已关闭的 Issue 4. 生成包含以下三节的 Markdown 报告： - 本周完成工作 - 当前阻塞项 - 下周计划

停止条件

- 如果日志路径不存在，输出错误提示并停止，不要继续推测 - 报告长度控制在 500 字以内

不要冗长的功能介绍，Agent 需要的是确定的步骤、明确的停止条件和清晰的输出格式。

Skill 的加载机制与优先级

OpenClaw 从三个位置加载 Skill，优先级从高到低依次为：工作区目录（/skills）、用户目录（~/.openclaw/skills）、以及 OpenClaw 自带的内置 Skill。

实战：从零写一个 GitHub 日报 Skill

下面是一个完整的示例，展示如何从零创建一个每天汇总 GitHub 动态的 Skill：

第一步：创建目录和文件

mkdir -p /.openclaw/skills/github-daily-digest cd /.openclaw/skills/github-daily-digest

touch SKILL.md第二步：写 SKILL.md

name: github-daily-digest description: 当用户需要查看今日 GitHub 动态、了解关注仓库的更新、   汇总 Star 增长和新 Issue 时使用。 metadata: { "openclaw": { "emoji": "🐙",   "requires": { "bins": ["gh"], "env": ["GITHUB_TOKEN"] } } }

 GitHub 日报生成

步骤

1. 使用 gh api 获取今日关注仓库的推送记录 2. 列出过去 24 小时内新增的 Star 超过 50 的仓库 3. 收集今日新开的 Issue（标签含 bug 或 feature） 4. 按仓库整理，输出简洁的 Markdown 日报

输出格式

每条记录包含：仓库名、变更类型、摘要（不超过 50 字）

限制

- 如果 GITHUB_TOKEN 不存在，提示用户配置后停止 - 单次最多汇总 20 条记录，超出部分注明「更多请访问 GitHub」第三步：验证并测试 openclaw skill validate github-daily-digest

预期输出：

✅ Frontmatter valid ✅ Description present ✅ Required env: GITHUB_TOKEN

写完之后，下一次打开新会话，直接发消息「帮我看一下今天 GitHub 有什么动态」，Agent 就会自动匹配并执行这个 Skill。

发布到 ClawHub：让社区用上你的 Skill

写好 Skill 之后，如果觉得对更多人有用，可以发布到 ClawHub——OpenClaw 的官方 Skill 市场，目前已有超过 5,700 个社区贡献的 Skill。

发布流程非常简单：

发布到 ClawHub

clawhub publish github-daily-digest

安全注意事项：Skill 是陌生人的代码

作为 Skill 的使用者，把每一个来自社区的 Skill 当成需要 Code Review 的代码来对待。

安装前看一眼 SKILL.md 的内容、核查创作者的 GitHub 主页和 ClawHub 评分，是最基本的安全习惯。

写在最后

从一个 Skill 开始，把你每周重复三次以上的工作流整理成 SKILL.md。当你的 OpenClaw 跑起来的第一天能帮你做这件事，你就真正理解了为什么OpenClaw能火起来了。