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.com
2.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 restart
openclaw 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 吧！
