VPN07

OpenClaw 2026 Skills命令完全指南:自定义技能从零写到自动执行

2026-02-19 阅读约14分钟 进阶教程 Skills开发

Skills 是 OpenClaw 的超级能力来源。没有 Skills,OpenClaw 只是个聊天机器人;有了 Skills,它能帮你发邮件、管日历、控制智能家居、自动运行代码……本文系统讲解所有 Skills 命令,并附完整的自写 Skill 教程。

一、Skills 是什么?为什么重要?

Skills 是 OpenClaw 的功能插件,本质上是一个包含三部分的文件包:

📋

说明文档(SKILL.md)

告诉 AI 这个 Skill 是做什么的、什么时候该用它、怎么调用

⚙️

执行脚本

实际执行操作的代码(Shell/Python/Node.js 均可)

🔑

配置文件

API Key、认证信息、参数默认值等(存在本地,不上传)

💡 Skills 的神奇之处

AI 读懂 Skill 的说明文档后,会自主决定什么时候调用。你只需要用自然语言说「帮我约个明天上午10点的会议」,AI 就会自动调用 Calendar Skill。

二、Skills 命令完整速查表

openclaw skills list 列出所有技能

显示所有已安装的 Skills,包括名称、状态(启用/禁用)、版本号、最后更新时间。

openclaw skills list # 列出全部
openclaw skills list --enabled # 只显示已启用
openclaw skills list --disabled # 只显示已禁用
openclaw skills install <name> 安装技能

从 ClawHub(官方技能市场)安装指定技能。

openclaw skills install gmail # 安装Gmail Skill
openclaw skills install calendar # 安装日历Skill
openclaw skills install github # 安装GitHub Skill
openclaw skills install spotify # 安装Spotify Skill
openclaw skills install hue # 安装飞利浦Hue灯控
openclaw skills install obsidian # 安装Obsidian笔记Skill
openclaw skills install --path <本地路径> 安装本地技能

安装你自己写的本地 Skill。

openclaw skills install --path ~/my-skills/weather-skill
openclaw skills remove <name> 删除技能

彻底删除 Skill 及其配置文件。注意:配置文件(如 API Key)也会被删除,卸载前请备份。

openclaw skills enable/disable <name> 启用/禁用技能

临时禁用某个 Skill 但不删除(方便测试和调试)。

openclaw skills disable gmail # 暂时禁用Gmail
openclaw skills enable gmail # 重新启用
openclaw skills update <name> 更新技能

更新指定 Skill 到最新版本。

openclaw skills update gmail # 更新Gmail Skill
openclaw skills update --all # 更新所有 Skills
openclaw skills info <name> 查看技能详情

查看某个 Skill 的详细信息:功能描述、作者、版本、依赖、配置项等。

openclaw skills validate <name> 验证技能

检查 Skill 文件格式是否正确,自己写 Skill 时必用,避免语法错误导致 AI 读取失败。

三、热门社区 Skills 推荐(50+可用)

📧 通讯类

  • gmail — 读写邮件、自动分类、回复
  • calendar — 创建/查询日历事件
  • slack — 发消息到 Slack 频道
  • twitter — 发推文、查看 Timeline

💻 开发类

  • github — 管理 Issues/PR、查看仓库
  • shell — 执行系统命令(谨慎使用)
  • cursor — 控制 Cursor IDE,写代码
  • sentry — 监控错误,自动创建修复PR

📝 生产力类

  • obsidian — 读写 Obsidian 笔记库
  • todoist — 管理待办事项
  • browser — 控制浏览器,填表单、抓数据
  • spotify — 控制音乐播放

🏠 智能家居类

  • hue — 飞利浦 Hue 灯光控制
  • whoop — 读取健康数据
  • homekit — 苹果 HomeKit 控制
  • winix — 空气净化器控制

四、动手写第一个自定义 Skill

自写 Skill 比想象中简单。一个最小可用 Skill 只需要两个文件:

SKILL.md(核心:告诉AI怎么用)
# Weather Skill

## 功能
查询指定城市的实时天气信息。

## 何时使用
当用户询问天气、气温、是否需要带伞时使用。

## 使用方法
调用 weather.sh 脚本,传入城市名称参数。

## 示例
- "上海今天天气怎么样?" → 调用 weather.sh 上海
- "北京明天会下雨吗?" → 调用 weather.sh 北京

## 输出
返回温度、天气状况、风速、湿度信息。
weather.sh(执行脚本)
#!/bin/bash
CITY="$1"
curl -s "wttr.in/${CITY}?format=3&lang=zh"

安装并使用你的 Skill:

mkdir ~/my-skills/weather-skill
cd ~/my-skills/weather-skill
# 创建 SKILL.md 和 weather.sh
chmod +x weather.sh
openclaw skills install --path ~/my-skills/weather-skill
openclaw skills validate weather-skill # 验证格式
openclaw restart # 重启加载

五、Skills 常见问题解答

Q:安装了 Skill 但 AI 从来不自动调用它?

最常见原因:① 安装后没有 restart;② SKILL.md 中对「何时使用」描述不够清晰,AI 无法判断何时该用;③ Skill 被 disable 了。检查:openclaw skills list,确认状态为 enabled。

Q:如何让 AI 强制使用某个 Skill?

在对话中明确指定:「用天气 Skill 查一下上海今天的天气」。或者在 SKILL.md 中添加关键词触发词,提高 AI 识别精度。

Q:自己写的 Skill 能发布到社区吗?

可以!访问 ClawHub(openclaw.ai 官方 Skill 市场),按照提交指南提交 PR。建议先在本地测试充分,并在 SKILL.md 中写明安全注意事项。

Q:Skill 里能用 Python 脚本吗?

完全可以。Skills 对执行脚本语言没有限制,Shell/Python/Node.js/Ruby 都支持,只要系统有对应解释器。在 SKILL.md 中注明依赖(如 requirements: python3, requests)即可。

Q:Skills 安全吗?AI 会乱调用吗?

OpenClaw 与 VirusTotal 合作,社区 Skills 经过安全扫描。自写 Skill 建议审查执行脚本内容,避免引入不可信代码。可以用 openclaw config set skillConfirmation true 开启「执行前先问我」模式。

六、进阶:Skill + Heartbeat 实现定时自动化

OpenClaw 的 Heartbeat(心跳)功能让 AI 可以主动执行任务,而不是等你发消息。结合 Skill 可以实现强大的定时自动化。

示例:每天早上8点发天气简报

在 SKILL.md 中添加 Heartbeat 配置:

## Heartbeat 配置
schedule: "0 8 * * *" # 每天8点执行
action: 查询上海天气,发送晨报给用户

配置后执行 openclaw restart,之后每天早上8点 AI 会自动获取天气并主动发消息给你。

💡 更多 Heartbeat 定时任务创意

  • • 每天晚上总结今日邮件重点
  • • 每周一生成本周工作计划
  • • 每小时检查服务器状态,异常立即通知
  • • 每天监控竞争对手网站更新

六点五、找到更多 Skills 的途径

🌐 ClawHub(官方市场)

openclaw.ai 官方 Skill 市场,经过安全审核,所有 Skills 均与 VirusTotal 合作扫描。直接用命令安装:

openclaw skills install <name>

💬 Discord 社区

加入 OpenClaw 官方 Discord,有专门的 #skills-sharing 频道,用户互相分享自制 Skill,还有开发者实时答疑。

discord.gg/openclaw

🐙 GitHub

在 GitHub 搜索 openclaw-skill 可以找到大量个人开发者分享的 Skills,用 --path 参数安装本地克隆的仓库。

🤖 让 AI 自己写 Skill

直接告诉 OpenClaw:「帮我写一个查询股票价格的 Skill」,AI 会自动生成代码并安装,这是 OpenClaw 最神奇的功能之一。

七、Skills进阶问答:从会用到精通

Q:Skills之间可以互相调用吗?

可以。在 SKILL.md 中描述「本 Skill 需要配合 XXX Skill 使用」,AI 会在必要时串联调用多个 Skills。例如「天气Skill」和「日历Skill」配合,实现「根据天气自动决定是否提醒带伞」。

Q:Skill 能访问互联网吗?

完全可以。Skill 执行脚本可以用 curl、requests 等任意方式访问外部 API 和网站。建议在 SKILL.md 的依赖说明中注明:network: required,提醒用户此 Skill 需要网络连接。

Q:如何调试 Skill 执行错误?

① 用 openclaw debug 模式运行,会输出 Skill 执行的详细日志;② 单独手动执行 Skill 脚本确认可以运行:bash ~/skills/my-skill/run.sh;③ 用 openclaw skills validate my-skill 检查格式。

Q:Skill 里如何安全存储 API Key?

将 API Key 存放在 Skill 目录下的 .env 文件中,在执行脚本里通过环境变量读取($GMAIL_API_KEY)。OpenClaw 会自动加载 Skill 目录下的 .env 文件,Key 不会暴露在 SKILL.md 或日志中。

Q:Skills 执行失败时,AI 会告诉用户原因吗?

会。OpenClaw 会捕获 Skill 的 stderr 输出并传给 AI,AI 会根据错误信息给用户一个人性化的解释,并可能尝试重新执行或建议修复方案。你也可以在 SKILL.md 中定义「错误代码」和对应的友好提示。

Q:如何让 Skill 只有我能使用,而不是所有人?

在 OpenClaw 配置中设置用户白名单:openclaw config set allowedUsers "你的Telegram用户名"。也可以在单个 Skill 的配置文件中设置 restricted: true,只有管理员才能触发。

2026年最值得安装的10个 Skills

1
gmail读写邮件是最高频需求,配置完后从微信随时处理邮件
2
browser让AI自动爬取数据、填写表单,解放双手
3
calendar语音创建日历事件,「明天下午3点开会」一句话搞定
4
github开发者必装,Issues/PR管理,异常自动修复
5
obsidian知识库管理,在Telegram里直接搜索和更新笔记
6
todoist任务管理,自然语言添加待办,AI自动分类优先级
7
spotify用自然语言控制音乐,「放点爵士乐」立即执行
8
hue智能灯光控制,根据时间/天气自动调节
9
whoop健康数据整合,AI根据身体状态给出工作建议
10
sentry监控代码错误,自动分析原因并开PR修复

安装命令:openclaw skills install gmail(替换 gmail 为上方任意技能名)

八、Skills命令速查表

命令 说明
openclaw skills list列出所有已安装技能
openclaw skills install <name>从ClawHub安装技能
openclaw skills install --path <path>安装本地自定义技能
openclaw skills remove <name>删除技能
openclaw skills enable <name>启用已禁用的技能
openclaw skills disable <name>临时禁用技能
openclaw skills update <name>更新技能到最新版
openclaw skills update --all更新所有技能
openclaw skills info <name>查看技能详情
openclaw skills validate <name>验证技能文件格式

相关文章推荐

Skills安装与执行的必备条件
VPN07 — Skills无缝运行的网络保障

安装社区 Skills 需要访问 ClawHub;Gmail/GitHub 等 Skills 执行时需要访问海外服务器;Heartbeat 任务全天候运行,对网络稳定性要求极高。VPN07 提供 1000Mbps 千兆带宽、运营十年的稳定连接,是 OpenClaw Skills 正常运行的最佳网络保障。

¥9/月
超低月费
1000Mbps
千兆带宽
70+国
全球节点
30天
无理由退款
月费¥9 · 运营十年
免费试用 VPN07