2026年4月2日 19:30分,来腾讯会议(限30人)了解如何用Openclaw构建企业AI生产力
免费POC, 零成本试错
AI知识库

53AI知识库

学习大模型的前沿技术与行业应用场景


我要投稿

OpenClaw 技能注册与新增完全指南:从“会说话”到“会干活”

发布日期:2026-03-28 05:28:15 浏览次数: 1611
作者:虎sir的AI技术博客

微信搜一搜,关注“虎sir的AI技术博客”

推荐语

让你的AI助手从"会说话"升级到"会干活"!OpenClaw技能系统详解,零代码打造专属工作流。

核心内容:
1. OpenClaw技能的本质与设计哲学解析
2. 从ClawHub注册中心安装现成技能的完整指南
3. 自定义技能开发入门:用Markdown编写AI执行说明书

杨芳贤
53AI创始人/腾讯云(TVP)最具价值专家

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. {标题}({节点})
步骤 3:重启生效
openclaw gateway restart
步骤 4:测试使用
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: pattern
permissions:  - network  - filesystem
runtime: nodejs20

4.3 核心执行逻辑示例

// src/index.tsimport { SkillSkillContextSkillResult } from '@openclaw/skill-sdk';
export default class GitHubSkill implements Skill {  name = 'github';  description = 'GitHub 仓库操作';
  async execute(contextSkillContext): 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(tokenstring): Promise<string> {    const response = await fetch('https://api.github.com/user/repos', {      headers: { Authorization`token ${token}` }    });    const repos = await response.json();    return repos.slice(05).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 常见问题

问题
原因
解决方案
Skill 安装后不生效
未重启网关
openclaw gateway restart
clawhub
 命令找不到
未正确安装或 PATH 问题
重新执行 npm i -g clawhub
Skill 找不到 API Key
未在 config.json 中配置
按 2.5 节添加配置
SKILL.md 不被识别
文件名大小写错误
必须是 SKILL.md(大写)

6.2 安全建议

工信部于 2026 年 3 月发布预警提示:OpenClaw 在默认配置下存在安全风险。 建议:

  1. 避免安装来源不明的第三方技能,优先使用官方或知名开发者发布的 Skill

  2. 敏感操作增加人工确认,避免 AI 误操作造成损失

  3. 定期更新 Skillclawhub update --all 获取安全修复

  4. 启用审计日志,及时发现异常行为

七、总结:两种路径的选择指南

你的需求
推荐路径
理由
快速添加现成功能
安装现有 Skill
一键安装,无需开发
有固定工作流想固化
开发 SKILL.md Skill
会写 Markdown 就行,10 分钟搞定
需要复杂逻辑/API 调用
开发 TypeScript Skill
完整编程能力,灵活可控
想分享给社区
发布到 ClawHub
开源共享,积累影响力

一句话总结:OpenClaw 的 Skill 系统,让“给 AI 装手脚”变得前所未有的简单。会写 Markdown,就能让它按你的方式干活。

现在,快去给你的“小龙虾”装上第一个 Skill 吧!




53AI,企业落地大模型首选服务商

产品:场景落地咨询+大模型应用平台+行业解决方案

承诺:免费POC验证,效果达标后再合作。零风险落地应用大模型,已交付160+中大型企业

联系我们

售前咨询
186 6662 7370
预约演示
185 8882 0121

微信扫码

添加专属顾问

回到顶部

加载中...

扫码咨询