🏷️ 文章标签
#OpenClaw#技能系统#Skills#AI自动化#入门指南

🔗 相关链接： AI工具导航站 Vercel镜像 ClawHub技能市场

一、为什么需要技能系统？

先看一个对比：

没有技能时：

你说："帮我写一篇公众号文章"

AI回复："好的，以下是文章内容..."（一大段文字）

然后你还得手动复制粘贴到公众号后台。

有技能后：

你说："玉笔，写一篇公众号文章"

AI回复："文章已完成，已保存到wechat-writer目录"

HTML文件直接生成，打开就能用。

这就是技能系统的价值：让AI执行任务，而不是只会聊天。

二、什么是技能？

技能（Skill）是一个包含SKILL.md文件的目录，里面写着：

• 触发条件
  ：什么时候激活这个技能
• 执行步骤
  ：AI应该做什么
• 参考文档
  ：AI需要的知识库
• 脚本文件
  ：可选的自动化脚本

你可以把技能理解为给AI的一套操作手册。当用户的消息匹配触发条件时，AI会自动读取这个手册，按步骤执行。

三、技能从哪里来？

OpenClaw从三个位置加载技能：

如果同名技能存在于多个位置，工作区的会覆盖其他的。这让你可以定制内置技能而不影响原始版本。

四、创建第一个技能

我们来创建一个简单的技能：天气预报。

Step 1：创建目录

mkdir -p ~/.openclaw/workspace/skills/weather

Step 2：创建SKILL.md

在目录中创建SKILL.md文件：

---
name: weather
description: Get current weather and forecasts via wttr.in or Open-Meteo. Use when user asks about weather, temperature, or forecasts.
---

# Weather Skill

## When to Use
User asks about weather, temperature, or forecasts for any location.

## How to Execute
1. Use wttr.in API: `curl wttr.in/{location}?format=3`
2. Parse the response
3. Return weather info to user

## Example
User: "北京天气怎么样？"
Response: "北京今天晴，温度15°C"

Step 3：刷新技能

告诉AI"刷新技能"，或者重启Gateway。OpenClaw会自动发现新技能。

Step 4：测试

发送消息："上海天气怎么样？"

AI会自动识别weather技能，执行查询，返回结果。

五、技能元数据详解

SKILL.md的frontmatter支持多个字段：

门控配置（metadata.openclaw）

有些技能需要特定环境才能运行，可以用门控配置：

---
name: gemini
description: Use Gemini CLI for coding assistance
metadata: {"openclaw":{"requires":{"bins":["gemini"],"env":["GEMINI_API_KEY"]}}}
---

这个配置表示：

• 需要gemini命令在PATH中
• 需要GEMINI_API_KEY环境变量
• 如果条件不满足，技能不会被加载

💡 门控的作用：避免加载无法运行的技能，减少错误和token消耗。

六、技能的三个层次

根据复杂度，技能可以分为三个层次：

1. 轻量技能（仅SKILL.md）

只有一个SKILL.md文件，AI根据指令执行。适合简单任务。

示例：weather、日期查询、简单计算。

2. 中量技能（+参考文档）

SKILL.md + references/目录（存放知识库文档）。AI执行时读取参考文档。

示例：公众号文章创作（玉笔）、技术文档查询。

3. 重量技能（+脚本）

SKILL.md + references/ + scripts/。包含自动化脚本，AI可以调用。

示例：GitHub问题处理（gh-issues）、视频处理。

七、从ClawHub安装技能

不想自己写？ClawHub是OpenClaw的技能市场：

# 安装技能到工作区
clawhub install weather

# 更新所有已安装技能
clawhub update --all

浏览地址：https://clawhub.com

八、常见问题

技能不触发？

检查description是否准确。description是AI判断是否使用技能的主要依据。写清楚触发场景和关键词。

技能加载失败？

检查门控条件。如果技能定义了requires.bins或requires.env，确保条件满足。

多个技能冲突？

同名技能会被覆盖。如果你想保留多个版本，改名或放到不同目录。

九、安全注意事项

⚠️ 第三方技能视为不受信任代码
启用前请阅读SKILL.md内容，确认没有危险操作。
对于高风险工具（删除、发送消息等），建议在沙箱隔离环境运行。

十、总结

🎯 核心观点
技能系统让AI从"对话者"变成"执行者"。你不再需要手动复制AI的输出，而是让AI直接完成任务。
推荐路径：从ClawHub安装现成技能 → 理解结构 → 尝试修改 → 创建自己的技能。

🔗 相关链接： AI工具导航站 ClawHub技能市场

相关文章：

• OpenClaw向量记忆系统部署完整指南
• OpenClaw配置第二个飞书BOT踩坑指南
• SESSION-STATE.md使用指南（WAL协议）

—— 爱默如深 · OpenClaw技术系列 ——