OpenClaw Skill 开发教程从零开始创建并上架 ClawHub

摘要：ClawHub 已收录 13700+ 技能，你也可以贡献。跟着这篇教程，从零开发并上架自己的 OpenClaw Skill，门槛比想象中低。

🤔 用了小龙虾，想定制功能，怎么办？

很多人用了一段时间 OpenClaw，发现官方的 13000+ 技能里没有自己想要的功能。

比如：

每天早上提醒你"该喝水了"
自动备份某个重要文件夹
定时发送钉钉消息提醒同事

你想定制，但不知道怎么开发。

其实开发 Skill 的门槛比想象中低得多。

ClawHub 已收录 13700+ 技能，周活跃开发者 5000+。你也可以成为贡献者。

这篇教程带你从零开发一个 Skill，并上架 ClawHub。

📦 什么是 OpenClaw Skill？

Skill = 文件夹 + SKILL.md

每个 Skill 本质上是一个文件夹，核心文件是 SKILL.md——一个包含 YAML 元数据和 Markdown 指令的文件，用来"教会" AI 如何完成某类特定任务。

类比一下：

浏览器扩展 = Chrome Extension
手机应用 = App
OpenClaw 技能 = Skill

Skill vs MCP：一张表讲清区别

维度	MCP（Model Context Protocol）	Skill
层级	底层通信协议	高层应用抽象
类比	相当于 HTTP 协议	相当于 Web 应用
开发门槛	需理解协议规范、实现 Server	只需写 Markdown 文件
适合人群	专业开发者	普通用户也能上手

Skill 的门槛更低——你不需要写代码，只需要写 Markdown。

🏗️ OpenClaw Skill 的基本结构

一个最简单的 Skill，目录结构如下：

my-skill/├── SKILL.md          # 必需：技能定义文件├── scripts/          # 可选：自动化脚本│   ├── fetch_data.py│   └── process.sh└── references/       # 可选：参考文档    └── api-docs.md

核心文件：SKILL.md

---name: daily-reminderdescription: 每日提醒助手，在指定时间提醒用户喝水、吃药、交房租等tools:  - shell  - notify---# Daily Reminder## 触发条件用户说"提醒我..."或"每天提醒..."## 执行步骤1. 解析用户的提醒内容和时间2. 使用 shell 工具设置定时任务3. 使用 notify 工具发送提醒通知## 注意事项- 提醒时间格式：HH:MM（如 08:00）- 提醒内容要具体明确

关键字段说明：

字段	说明	要求
name	Skill 名称	使用 kebab-case（如 daily-reminder），全局唯一
description	功能描述	越具体越好，决定自动触发时机
tools	所需工具	最小权限原则，只声明必要的工具

💡 开发一个示例 OpenClaw Skill：每日提醒

场景说明

每天早上 8 点提醒你"该喝水了"，下午 6 点提醒"该吃药了"，每月 1 号提醒"该交房租了"。

步骤 1：创建目录和 SKILL.md

在你的 OpenClaw 工作区创建目录：

mkdir -p ~/.openclaw/skills/daily-reminder

步骤 2：理解每个字段的作用

name: daily-reminder

使用 kebab-case，全局唯一
这是别人安装你 Skill 时用的名称

description: 每日提醒助手...

越具体越好，AI 会根据描述判断何时触发这个 Skill
写得太笼统，AI 可能不知道什么时候用

tools: shell, notify

shell：执行命令行
notify：发送系统通知
最小权限原则：不要写不必要的工具

步骤 3：本地测试运行

# 进入 OpenClaw 工作区cd ~/.openclaw# 加载 Skillclaw skill load skills/daily-reminder# 测试对话claw chat "提醒我每天早上 8 点喝水"

常见坑：

问题	解决方案
Skill 加载失败	检查 SKILL.md 的 YAML 格式是否正确
AI 不触发 Skill	description 写得不够具体，AI 不知道何时用
name 冲突	换一个唯一的名称，加前缀如 `yourname-daily-reminder`

🚀 上架 ClawHub

前提条件

GitHub 账号
Skill 已本地测试通过

步骤 1：创建 GitHub 仓库并推送

# 创建仓库cd ~/.openclaw/skills/daily-remindergit initgit add SKILL.mdgit commit -m "Initial commit: daily-reminder skill"git branch -M maingit remote add origin https://github.com/你的用户名/daily-reminder.git

git push -u origin main

步骤 2：提交到 ClawHub

两种方式：

方式一：通过 ClawHub 网站提交

访问 https://clawhub.ai
登录 GitHub 账号
点击 "Submit Skill"
填写仓库地址：https://github.com/你的用户名/daily-reminder
等待审核

方式二：通过命令行提交

claw skill publish daily-reminder

审核周期和安全检查

项目	说明
审核周期	通常 1-3 天
安全检查	VirusTotal 扫描、代码审计
审核通过率	约 87%

审核要点：

SKILL.md 格式正确
不含恶意代码
tools 权限合理

上架后：别人如何安装你的 Skill

claw skill install daily-reminder

你的 Skill 就进入了 13700+ 技能池，任何人都能安装使用。

⚠️ OpenClaw Skill 安全注意事项

ClawHavoc 供应链攻击警示

2026 年初，ClawHub 发生过供应链攻击事件：恶意 Skill 窃取用户 API Key。

这给开发者和用户都敲响了警钟。

开发者的责任：

原则	说明
不植入恶意代码	绝不在 scripts/ 中加入窃取数据、远程执行的代码
最小权限原则	tools 只声明必要的，不要写 `shell` 如果你只需要 `notify`
开源透明	代码公开，让用户能审查

用户的防范：

建议	说明
查看源码	安装前阅读 SKILL.md，确认没有可疑操作
检查作者信誉	看作者的 GitHub 历史、社区评价
优先官方 Skill	官方审核更严格，风险更低

总结

从使用者到开发者，门槛比想象中低。

你只需要：

1️⃣ 写一个 SKILL.md 文件（Markdown 格式）2️⃣ 本地测试确认能跑3️⃣ 推送到 GitHub4️⃣ 提交 ClawHub 审核

先开发一个简单的，跑起来再迭代。

不需要写代码。不需要懂协议。只需要写清楚你要 AI 做什么。