Skip to content

OpenClaw Skills 完整手册:安装、使用、自制三步走

2026年4月17日

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-generateAI 生成视频按需
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 就不只是"能聊天",而是"真能干活"了。

不要孤军奋战啦!

加入微信群一起学习交流 AI

与大神一起使用 OpenClaw、Hermes、Claude Code、Seedance 2.0、GPT-Image-2 等

微信公众号

扫码关注微信公众号
私信 "加群",将自动获取微信群二维码

探索 AI 世界,掌握智能未来