Appearance
OpenClaw Skills 完整手册:安装、使用、自制三步走
OpenClaw 装好了,然后呢?AI 平时聊天挺能扯,但一到要它帮你干点正事——发个公众号、查个日历、生成个视频——它就蒙圈了。问题出在哪?AI 本身不会干活,它得有工具。Skill 就是给 AI 装上工具的方式。这篇手册三步走:怎么装、怎么用、怎么写,看完就能上手。
OpenClaw GitHub 已经 310k+ Star,是一款免费开源的 AI 助手,运行在你自己的电脑上。支持 WhatsApp、Telegram、Discord 等 30+ 平台,可接入 Claude、GPT、通义千问、DeepSeek、豆包等模型。
但很多人装完后发现:就只是个聊天工具?
不是的。OpenClaw 的核心价值不是"能聊",而是"能干活"——帮你管日历、发公众号、生成视频、搜全网资料。这些能力来自 Skills。把 Skill 理解为 AI 的"技能包"——装上什么,它就会什么。
这篇手册,带你三步走完。
第一步:怎么装?(3 种方式)
方式 1:内置功能(装完就有)
OpenClaw 自带一些基础功能,装完就能用。
查看已安装的 Skills:
bash
/skills list内置 Skills 覆盖基础场景:文件管理、网页浏览、基础搜索等。
方式 2:官方扩展包(最常用)
这是最常用的方式。OpenClaw 官方和社区出了很多现成的 Skill,一条命令装上就能用。
飞书相关 Skill:
bash
openclaw skills install feishu-calendar # 日历管理
openclaw skills install feishu-doc # 读写飞书文档
openclaw skills install feishu-bitable # 操作多维表格⚠️ 注意:飞书相关的 Skill 命名统一以 feishu- 开头,不是 lark-,别装错了。
搜索增强:
bash
openclaw skills install multi-search-engine装好后,AI 能帮你搜 Google、百度、必应等 17 个平台了。
常用 Skill 清单:
| Skill | 能干啥 | 建议 |
|---|---|---|
| feishu-calendar | 管日历、约会议 | ✅ 必装 |
| feishu-doc | 读写飞书文档 | ✅ 必装 |
| feishu-bitable | 操作多维表格 | ✅ 必装 |
| wechat-publish-pro | 发公众号文章 | ✅ 有号必装 |
| multi-search-engine | 全网搜索(17 个平台) | ✅ 建议装 |
| ai-video-generate | AI 生成视频 | 按需 |
| xiaohongshu-all-in-one | 小红书全套 | 按需 |
方式 3:自己开发(适合有想法的人)
如果你有编程基础,或者有特殊需求,可以自己写一个 Skill。第三节会专门讲这个。
💡 ClawHub 技能市场:社区已有 3000+ Skills,经过 65+ 项安全规则扫描。先去搜一搜,也许你要的已经有人做好了。
第二步:怎么用?(4 个真实场景)
直接说人话就行。AI 会自动理解你的需求,调用对应的 Skill 帮你干活。
场景 1:帮你管日历、约会议
以前你要这么做: 打开日历 App → 一个个看谁有空 → 手动创建会议 → 一个个发邀请
现在你只要说:
帮我看看明天下午 2 点到 4 点,张三和李四有没有空
OpenClaw 自动查完告诉你结果。
然后你说:
好的,创建一个明天下午 3 点的会议,时长 1 小时,主题是项目评审,邀请张三和李四
OpenClaw 自动创建好,发邀请。全程你只说了两句话。
💡 原理:调用的就是 feishu-calendar Skill,通过飞书开放 API 实现日程查询和创建。
场景 2:帮你发公众号文章
以前你要这么做: 打开公众号后台 → 复制文章 → 调整格式 → 上传封面 → 点发布
现在你只要说:
帮我把这篇文章发布到公众号草稿箱
OpenClaw 自动帮你转换格式、处理封面图、一键发到草稿箱。你只需要登录后台点"发布"就行了。
💡 原理:调用的 Skill 是 wechat-publish-pro,通过微信公众号 API 接口实现文章推送。
场景 3:帮你生成视频
以前你要这么做: 找剪辑师 → 写脚本 → 拍摄 → 剪辑 → 等好几天
现在你只要说:
帮我生成一个 5 秒的产品介绍视频,画面是一只咖啡杯在桌上
OpenClaw 自动调用 AI 视频生成工具,生成完返回链接或保存路径。
💡 原理:调用的 Skill 是 ai-video-generate,支持三个平台:快手可灵(首选)、字节 Seedance、字节即梦。会自动选择可用的平台。
场景 4:帮你搜全网内容
以前你要这么做: 打开百度 → 输入关键词 → 一个个点开看 → 手动整理
现在你只要说:
帮我搜一下最近关于 AI 副业的主流观点,整理成清单
OpenClaw 自动搜完、整理好,给你一份结构化清单。
💡 原理:调用的是 multi-search-engine Skill,支持 17 个搜索引擎,包含 Google(国际)、百度(国内)两大体系。
第三步:怎么写?(手把手教你自制 Skill)
这一节给想自己开发 Skill 的朋友看。完全基于真实代码,不来虚的。
3.1 Skill 的目录结构
一个 Skill 本质上就是一个文件夹,里面放这几类文件:
my-skill/
├── SKILL.md # 核心配置文件(必须)
├── scripts/ # 实际执行的脚本
├── references/ # 参考文档(按需加载)
└── assets/ # 静态资源文件| 目录 | 作用 | 加载方式 |
|---|---|---|
| SKILL.md | 配置触发条件 + 使用说明 | 激活时自动加载 |
| scripts/ | Shell / Python 等可执行脚本 | 直接运行,不加载上下文 |
| references/ | API 文档、配置说明等 | 按需加载,不占上下文 |
| assets/ | 模板、图片等资源 | 复制使用,不加载 |
3.2 SKILL.md 怎么写?
SKILL.md 是整个 Skill 的核心,包含两部分:
① YAML frontmatter(必须):
yaml
---
name: skill名称
description: |
这个 Skill 做什么
触发条件(写得越详细,触发越精准)
---② Markdown 使用说明:
markdown
# Skill 名称
## 功能说明
## 使用方法一个真实的触发条件写法:
yaml
---
name: wechat-publish-pro
description: |
微信公众号文章发布工具。
触发条件:
- 用户说"发布到公众号"
- 用户说"发到微信"
- 用户说"帮我发布文章"
- 用户说"把文章发到草稿箱"
- 用户说"推送订阅号"
- 用户说"发文"
---💡 设计原则:description 是触发机制的核心,决定了 AI 在什么情况下会调用这个 Skill。建议包含:
- 触发关键词同义词("发布"、"推送"、"发文")
- 行业术语("订阅号"、"草稿箱")
- 用户常用表达("帮我"、"把文章")
3.3 实际干活的部分:scripts/
SKILL.md 是说明书,真正执行任务的是 scripts/ 里的脚本。
可以放:
- Shell 脚本(.sh)
- Python 脚本(.py)
- 任意可执行程序
示例结构(video-generate Skill):
scripts/
├── generate.sh # 核心生成脚本
└── query.sh # 查询任务状态generate.sh 的核心逻辑:
bash
#!/bin/bash
# 根据环境变量自动选择可用平台
if [[ -n "$KLING_API_KEY" ]]; then
platform="kling"
response=$(kling_text_to_video "$prompt" "$duration")
elif [[ -n "$SEEDANCE_API_KEY" ]]; then
platform="seedance"
response=$(seedance_text_to_video "$prompt" "$duration")
elif [[ -n "$JIMENG_API_KEY" ]]; then
platform="jimeng"
response=$(jimeng_text_to_video "$prompt" "$duration")
else
echo "错误:未配置任何视频生成平台的 API Key"
exit 1
fi
echo "视频生成完成:$response"💡 安全建议:
- 用环境变量管理 API Key,不要硬编码在脚本里
- 脚本应该有最小权限原则,不直接操作敏感目录
- 输入参数要做校验,防止注入攻击
3.4 references/ 放什么?
放那些"用到时再查"的文档,比如:
- 各平台 API 接口文档
- 配置参数说明
- 详细的使用指南
好处:SKILL.md 保持精简(不超过 500 行),详细内容放 references/,AI 需要时再加载,不浪费上下文。
示例(video-generate 的 references/):
references/
└── config.md # 可灵、即梦、Seedance 的 API 端点、请求参数、认证方式3.5 从零写一个 Skill(完整流程)
第一步:创建目录结构
bash
mkdir -p my-skill/{scripts,references,assets}第二步:写 SKILL.md
yaml
---
name: my-first-skill
description: |
这是我的第一个 Skill。
触发条件:
- 用户说"测试一下"
- 用户说"帮我做XX"
- 用户说"执行测试"
---markdown
# My First Skill
## 功能说明
这是一个演示用的 Skill,用于测试 Skill 基本结构。
## 使用方法
直接对话中提到"测试一下"即可触发。
## 输出
脚本会返回执行结果。第三步:写一个可执行脚本
bash
# scripts/run.sh
#!/bin/bash
echo "Hello,我跑起来了!"
echo "当前时间:$(date)"
echo "参数:$@"第四步:测试
bash
chmod +x scripts/run.sh
./scripts/run.sh 测试参数看到 "Hello,我跑起来了!" 就说明成功了。
第五步:安装到 OpenClaw
bash
openclaw skills install ./my-skill常见问题
Q: Skill 装多了会卡吗?
不会。Skills 是按需加载的,装 100 个也不影响日常使用。只有触发时才加载对应的 Skill。
Q: Skill 可以跨 Agent 用吗?
可以。支持 agentskills.io 标准的 Agent 都能用同一个 Skill。比如 Hermes Agent 和 OpenClaw 可以共享 Skills。
Q: 如何调试 Skill?
bash
# 查看 Skill 是否被识别
openclaw skills list
# 手动触发 Skill 测试
openclaw skills run my-skill "测试参数"Q: Skill 更新后要重新安装吗?
需要。社区 Skill 更新后:
bash
openclaw skills update skill-name自制 Skill 直接替换文件夹内容即可,不需要重新安装。
三步走完:怎么装、怎么用、怎么写。你的 OpenClaw 就不只是"能聊天",而是"真能干活"了。
