# OpenClaw 入门：如何自建一个 Skill


## 一、Skill 是什么

把它当成 AI 的插件就行。每个 Skill 让 AI 多会一件事：查天气、发邮件、读文件，都是这么来的。

你可以把 Skill 理解成浏览器扩展——浏览器本身只是个上网工具，装上广告拦截插件就多了过滤广告的能力，装上翻译插件就多了翻译网页的能力。OpenClaw 也是一样，裸装的时候它只会聊天，但每装一个 Skill，它就多一项技能。

OpenClaw 官方维护了一个 Skill 市场（ClawHub），里面有上万个社区贡献的 Skill，涵盖文件处理、数据分析、网页操作、消息推送等各种场景。大部分常见需求都能在市场上找到现成的 Skill 直接用，不需要自己从零开发。

![Skill 就是 AI 的插件](https://developer.qcloudimg.com/http-save/yehe-6838934/b3bffdd80a3a3774a81fe105a2a4ecf2.jpg)


## 二、自建一个 Skill 有多难

最简单的情况，你只需要写一个文件。

没错，一个 Markdown 文件，连代码都不用写。

这不是夸张。OpenClaw 的 Skill 本质上就是一份"规则说明书"，你用自然语言写清楚"AI 在什么情况下该做什么"，OpenClaw 就能理解并执行。不需要学编程语言，不需要懂框架，会写文档就行。

当然，如果你想让 Skill 调用外部 API 或者执行复杂逻辑，可以加入 TypeScript 脚本。但大部分日常需求，纯 Markdown 就能搞定。

![只需要一个 Markdown 文件](https://developer.qcloudimg.com/http-save/yehe-6838934/1f84c7d4ae156564e9f015f3af3df76a.jpg)


## 三、三步搞定

- 建一个文件夹：`skills/你的Skill名/`
- 在里面放一个 `SKILL.md` 文件
- 重启 OpenClaw，开个新对话

第一步创建文件夹时，路径要对。OpenClaw 会在工作目录下的 `skills/` 目录中扫描子文件夹。不确定工作目录在哪，可以运行 `openclaw config file` 查看。

第二步写 `SKILL.md`，文件名必须是全大写，不能写成 `skill.md` 或 `Skill.md`，否则识别不到。

第三步重启让 OpenClaw 重新扫描。新版支持热加载，运行 `openclaw skills reload` 即可生效，不用重启 Gateway。

![三步搞定自建 Skill](https://developer.qcloudimg.com/http-save/yehe-6838934/bea6cf1293a4f0d757a2a622e843ca9a.jpg)


## 四、来个简单例子

假设你希望 AI 每次回完话都带一句鼓励，建这个就行：

```
skills/cheer-me-up/SKILL.md
```

内容如下：

```
# Cheer Me Up

## 描述
每次用户完成一个任务后，给予一句简短的鼓励。

## 规则
- 鼓励的话要简短，不超过一句话
- 语气要真诚，不要过度夸张
- 可以适当使用emoji

## 示例
用户：我写完了今天的代码
AI：搞定！今天的你也超棒 🔥
```

保存后重启 OpenClaw，新对话里 AI 就会自动照这个规则来。"描述"字段告诉 AI 这个 Skill 干什么用，"规则"字段约束行为，"示例"给 AI 参考模板。三个字段配合，AI 就能理解你的意图。

你可以试试改"示例"里的内容看回复风格的变化。比如把鼓励语改成"又是努力的一天，辛苦了"，语气就会变得更温和。


## 五、几个要注意的地方

文件名必须是 `SKILL.md`（全大写），不然 OpenClaw 认不出来。这是最常见的问题，新手十有八九会踩这个坑。

- 文件夹名建议小写英文加短横线，比如 `my-skill`，避免使用中文或空格
- 改了 Skill 要重启 OpenClaw 才生效（新版支持 `openclaw skills reload` 热加载）
- 一个 Skill 文件夹里只能有一个 `SKILL.md`，放多个会报错
- 要是没生效，先检查文件名和路径对不对，再看终端有没有报错日志

另外，`SKILL.md` 里的内容不要太长。超过 2000 字的话，每次对话都会消耗额外 Token，影响响应速度。把规则写得精炼一点，AI 反而更容易理解。


## 六、不满足于纯描述？再走一步

当你不想只写 Markdown 规则，可以试试：

- 加 `tools.json`，让 Skill 调外部工具（比如调天气 API、查数据库）
- 加 `prompts/` 目录，管理多套提示词模板（不同场景用不同模板）
- 加 `handler.ts`，用 TypeScript 写事件处理逻辑（适合需要复杂判断的场景）
- 发布到 Skill 市场，让别人也能用你的 Skill

`tools.json` 的作用是告诉 OpenClaw 这个 Skill 需要调用哪些外部工具。比如你写了一个"查快递"的 Skill，可以在 `tools.json` 里定义一个 `query_express` 工具，指向快递查询 API。

`handler.ts` 适合更高级的场景，比如在每次新会话时自动加载用户的待办事项。这部分在后面讲 Hooks 的章节会详细介绍。

搞定，你的第一个 Skill 就做好了。


把它当成 AI 的插件就行。每个 Skill 让 AI 多会一件事：查天气、发邮件、读文件，都是这么来的。

OpenClaw 入门：如何自建一个 Skill

数据分析主任

人工智能

开发工具

低代码

OpenClaw Skill是AI的功能插件，通过Markdown文件即可自定义AI行为，无需编程基础。自建Skill只需三步：创建文件夹、编写SKILL.md规则文件、重启生效。支持纯文本描述或结合TypeScript实现复杂功能，可发布到ClawHub市场共享。适合实现自动回复、API调用等场景，让AI快速获得新能力。

数据分析

文件处理

代码解释

TypeScript

数据库

OpenClaw

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

OpenClaw Skill是AI的功能插件，通过Markdown文件即可自定义AI行为，无需编程基础。自建Skill只需三步：创建文件夹、编写SKILL.md规则文件、重启生效。支持纯文本描述或结合TypeScript实现复杂功能，可发布到ClawHub市场共享。适合实现自动回复、API调用等场景，让AI快速获得新能...

OpenClaw 入门：如何自建一个 Skill-腾讯云开发者社区-腾讯云

OpenClaw 入门：如何自建一个 Skill

OpenClaw 入门：如何自建一个 Skill

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐