2026年,OpenClaw 的真正强大之处,早已不只是使用现成插件,而是人人都能零代码写出自己的 Skill,让 AI 完全按照你的工作流执行任务。
很多刚接触 OpenClaw 的用户都有这样的困惑:为什么别人的“小龙虾”既能联网搜索、自动整理文件,还能定时推送日报,而自己的却“又呆又笨”?答案很简单——你没给它装“手脚”。

在 OpenClaw 的世界里,Skill 就是 AI 的“手脚”。没有 Skills,它只是一个能聊天的“大脑”;装上 Skills,它才能真正动手干活。
本文将从零开始,全面讲解 OpenClaw Skills 的两种核心操作:安装现有 Skill 和 注册/新增自定义 Skill。无论你是普通用户还是开发者,都能找到适合自己的方法。

一、核心认知:Skill 到底是什么?
在动手之前,先搞清楚一个根本问题:Skill ≠ 插件。
很多人把 Skill 理解为传统意义上的“插件”或“扩展包”,但 OpenClaw 的设计哲学完全不同:
插件:后台运行的服务,有独立代码逻辑,需要编译安装
Skill:给 AI 看的执行说明书,会写 Markdown 就能开发
一个 Skill 本质上就是一个包含 SKILL.md 文件的文件夹。SKILL.md 用 YAML 格式定义元数据,用 Markdown 格式写执行流程。AI 读到这份说明书,就知道“当用户说 X 时,我应该按步骤做 Y”。
Skill 的核心价值:一次教学,终身复用。将你的工作流程、行业经验、团队规范固化成一个 Skill,从此再也不用重复解释。

二、方法一:安装现有 Skill(ClawHub 注册中心)
如果你不想从零开发,只想给 OpenClaw 添加现成功能,ClawHub 是最佳选择。
2.1 什么是 ClawHub?
ClawHub 是 OpenClaw 的公共 Skills 注册中心,相当于 Skill 的“应用商店”。它是一个免费服务,所有 Skills 都是公开的,支持搜索、安装、更新、发布。
截至 2026 年 3 月,ClawHub 已汇聚数千个 Skill,覆盖编码、DevOps、搜索、AI、生产力等各大领域。
2.2 安装 ClawHub CLI
首先需要安装 ClawHub 命令行工具:
# 全局安装 ClawHub(二选一)npm i -g clawhub# 或pnpm add -g clawhub# 验证安装clawhub --version
npm config set registry https://registry.npmmirror.com2.3 搜索和安装 Skill
方式一:自然语言搜索
# 搜索关键词clawhub search "calendar"clawhub search "github"
# 安装指定 Skillclawhub install <skill名称># 安装特定版本clawhub install <skill名称> --version 1.2.0# 批量安装clawhub install skill1 skill2 skill3
方式三:通过对话安装(最便捷)
进入 OpenClaw 的对话界面,直接发送:
“从技能商店安装 daily-brief”
OpenClaw 会自动完成搜索、下载、安装全流程。
2.4 管理已安装的 Skill
# 查看已安装列表clawhub list# 更新单个 Skillclawhub update <skill名称># 更新所有 Skillclawhub update --all# 卸载 Skillclawhub uninstall <skill名称># 禁用/启用 Skillopenclaw skills disable <skill名称>openclaw skills enable <skill名称>
2.5 配置 Skill 的 API Key
很多 Skill 需要配置 API Key 才能正常工作(如联网搜索、邮件服务)。配置方法:
编辑配置文件 ~/.openclaw/config.json:
{"skills": {"customEntries": {"tavily": {"apiKey": "你的Tavily-API-Key"},"gmail": {"clientId": "xxx","clientSecret": "xxx"}}}}
openclaw gateway restart
三、方法二:注册/新增自定义 Skill
这是 OpenClaw 最强大的能力——让 AI 按照你的专属工作流执行任务。好消息是:会写 Markdown 就能开发,10 分钟上手。
3.1 Skill 的标准结构
一个完整的 Skill 文件夹结构如下:
my-skill/├── SKILL.md # 必需:技能定义文件├── references/ # 可选:详细文档│ └── REFERENCE.md├── assets/ # 可选:模板、图片等资源│ └── template.json└── scripts/ # 可选:可执行脚本(实验性)└── run.sh
最小可用结构:只需要 SKILL.md 一个文件。
3.2 Skill 的存放位置
Skill 必须放在 OpenClaw 工作区的 skills/ 目录下才能被识别:
默认路径:
~/.openclaw/workspace/skills/工作区路径:
<你的工作区>/skills/
放入后无需注册、无需配置,重启网关即可自动识别。
3.3 SKILL.md 的标准写法
一个完整的 SKILL.md 由三部分组成:
第一部分:YAML Frontmatter(元数据)
---name: daily-briefdescription: >每日早报,上海天气 + V2EX 热帖。Use when: 用户说“今日简报”,或定时触发。NOT for: 专业气象预报、长内容新闻。---
关键点:NOT for 很重要,可以防止 AI 在不合适的场景错误触发。
第二部分:触发条件
## When to Run- 每天 8:00 AM(通过 cron 触发)- 用户说“今日简报”“今天热点”- 需要快速了解今日热点时
第三部分:执行流程(核心)
步骤写得越具体,AI 执行得越准。写命令,不写意图。
## Workflow1. 获取上海天气:curl "https://wttr.in/Shanghai?format=3"2. 获取 V2EX 热门前 5 条:curl https://www.v2ex.com/api/topics/hot.json3. 按指定格式整理4. 推送给用户
第四部分:输出格式
## Output Format📅 {日期}🌤 天气:{天气结果}🔥 V2EX 热帖:1. {标题}({节点})2. {标题}({节点})
3.4 完整示例:daily-brief Skill
步骤 1:创建目录和文件
mkdir -p ~/.openclaw/workspace/skills/daily-brieftouch ~/.openclaw/workspace/skills/daily-brief/SKILL.md
步骤 2:编写 SKILL.md
---name: daily-briefdescription: >每日早报,上海天气 + V2EX 热帖。Use when: 用户说“今日简报”,或早上 8 点定时触发。NOT for: 专业气象预报、深度新闻分析。---# Daily Brief Skill## When to Run- 每天 8:00 AM- 用户说“今日简报”## Workflow1. 执行命令获取天气:curl "https://wttr.in/Shanghai?format=3"2. 拉取 V2EX 热门:curl https://www.v2ex.com/api/topics/hot.json3. 提取前 5 条标题与节点4. 按指定格式输出## Output Format📅 今日简报🌤 天气:{天气结果}🔥 V2EX 热帖:1. {标题}({节点})2. {标题}({节点})3. {标题}({节点})4. {标题}({节点})5. {标题}({节点})
openclaw gateway restartopenclaw chat --prompt "使用 daily-brief 生成今日简报"四、进阶:TypeScript 技能开发(适合开发者)
如果你的需求涉及复杂逻辑、API 调用或数据库操作,SKILL.md 可能不够用。这时需要开发 TypeScript 技能。
4.1 TypeScript Skill 的标准结构
my-ts-skill/├── src/│ └── index.ts # 核心执行逻辑├── package.json # 依赖配置├── tsconfig.json # TypeScript 配置├── skill.yaml # 技能清单└── config.schema.json # 配置结构定义
4.2 skill.yaml 清单示例
name: github-integrationversion: 1.0.0description: GitHub 仓库操作技能triggers:- pattern: "list my repos"type: exact- pattern: "create issue in {repo}"type: patternpermissions:- network- filesystemruntime: nodejs20
4.3 核心执行逻辑示例
// src/index.tsimport { Skill, SkillContext, SkillResult } from '@openclaw/skill-sdk';export default class GitHubSkill implements Skill {name = 'github';description = 'GitHub 仓库操作';async execute(context: SkillContext): Promise<SkillResult> {const { userMessage, config } = context;if (userMessage.content.includes('list repos')) {const repos = await this.listRepositories(config.githubToken);return { message: repos, actions: [] };}return { message: '我能帮你列出仓库、创建 Issue 等', actions: [] };}private async listRepositories(token: string): Promise<string> {const response = await fetch('https://api.github.com/user/repos', {headers: { Authorization: `token ${token}` }});const repos = await response.json();return repos.slice(0, 5).map(r => r.name).join('\n');}}
4.4 构建与测试
# 安装依赖npm install# 构建npm run build# 测试npm test# 打包发布npm run package

五、发布 Skill 到 ClawHub(可选)
如果你开发了一个好用的 Skill,想分享给社区,可以通过 ClawHub 发布。
5.1 登录认证
# 浏览器登录clawhub login# 或使用 Tokenclawhub login --token <你的token>
5.2 发布 Skill
# 发布单个 Skillclawhub publish ./my-skill \--slug my-skill \--name "My Skill" \--version 1.0.0 \--tags latest# 发布时指定变更日志clawhub publish ./my-skill \--version 1.0.1 \--changelog "修复了 XXX bug"
5.3 同步多个 Skill
# 扫描并发布所有新增/更新的 Skillclawhub sync --all
发布后,其他用户就可以通过 clawhub install my-skill 安装你的作品了。
六、避坑指南与最佳实践
6.1 常见问题
openclaw gateway restart | ||
clawhub | npm i -g clawhub | |
SKILL.md(大写) |
6.2 安全建议
工信部于 2026 年 3 月发布预警提示:OpenClaw 在默认配置下存在安全风险。 建议:
避免安装来源不明的第三方技能,优先使用官方或知名开发者发布的 Skill
敏感操作增加人工确认,避免 AI 误操作造成损失
定期更新 Skill:
clawhub update --all获取安全修复启用审计日志,及时发现异常行为
七、总结:两种路径的选择指南
一句话总结:OpenClaw 的 Skill 系统,让“给 AI 装手脚”变得前所未有的简单。会写 Markdown,就能让它按你的方式干活。
现在,快去给你的“小龙虾”装上第一个 Skill 吧!

夜雨聆风