OpenClaw技能(Skill)实践

引言：为什么需要技能开发？

在AI助手日益普及的今天，通用AI虽然强大，但往往缺乏针对特定场景的深度能力。OpenClaw通过技能（Skill）系统解决了这一痛点，让每个人都能为自己的AI助手定制专属能力。

无论你是开发者、产品经理还是普通用户，掌握技能开发都能让你的AI助手更懂你、更高效！

一、什么是OpenClaw Skill？

技能（Skill）是OpenClaw扩展AI助手能力的核心模块，它包含：

SKILL.md文件：为LLM提供指令和工具定义

可选资源：脚本、参考文档、模板资产

触发机制：基于自然语言描述自动匹配

核心价值：将通用AI转变为专业助手，具备特定领域的深度能力。

二、技能结构详解

一个标准的技能目录结构如下：

skill-name/                # 技能名称（小写字母、数字、连字符）├── SKILL.md               # 必需：技能定义文件│   ├── YAML frontmatter   # 元数据（名称、描述）│   └── Markdown指令        # 详细使用说明└── 可选资源/    ├── scripts/           # 可执行代码（Python/Bash等）    ├── references/        # 参考文档（按需加载）    └── assets/            # 模板、图标、字体等资源

SKILL.md文件示例：

---name: weatherdescription: 获取当前天气和预报（无需API密钥）。---# 天气查询技能## 快速开始使用wttr.in服务查询天气：```bashcurl -s "wttr.in/北京?format=3"# 输出：北京: ⛅️ +15°C

高级用法

紧凑格式：?format=%l:+%c+%t
今日预报：?1

单位转换：?m（公制）?u（美制）

三、5分钟创建你的第一个技能

步骤1：创建技能目录

## ****### ****```bashmkdir -p ~/.openclaw/workspace/skills/hello-worldcd ~/.openclaw/workspace/skills/hello-world

步骤2：编写SKILL.md文件

---name: hello_worlddescription: 简单的问候技能，当用户请求问候时使用。---# Hello World 技能## 使用场景当用户说"打个招呼"、"问好"或"hello"时，使用此技能。## 实现方式使用echo命令返回友好的问候语：```bashecho "👋 你好！我是你的OpenClaw助手，很高兴为你服务！"

扩展建议

可以添加更多个性化的问候语，或根据时间返回不同的问候。

步骤3：刷新技能列表

### ****```bashopenclaw skills refresh

步骤4：测试你的技能

openclaw agent --message "打个招呼"

恭喜！你的第一个技能已经创建完成！

四、技能开发最佳实践

1. 简洁性原则

只添加AI不知道的信息：避免重复通用知识

渐进式披露：核心指令在SKILL.md，细节在reference/

具体触发：在description中明确使用场景

2. 安全性考虑

# ✅ 安全示例description: 使用curl获取公开API数据时使用此技能。# ❌ 不安全示例  description: 执行任意bash命令时使用此技能。

3. 资源组织策略

资源类型适用场景示例scripts/重复执行的代码PDF处理脚本references/参考文档API文档、数据库schemaassets/输出资源模板文件、图标

五、实战案例：创建天气查询技能

完整技能结构

weather/├── SKILL.md├── scripts/│   └── get_weather.py└── references/    └── api_docs.md

SKILL.md内容

---name: weatherdescription: 查询全球城市天气和预报，支持多种格式输出。---# 天气查询技能## 核心功能1. **实时天气**：当前温度、湿度、风力2. **天气预报**：3天预报信息3. **多种格式**：简洁版、详细版、JSON格式## 快速开始```bash# 查询北京天气python scripts/get_weather.py --city 北京# 获取JSON格式数据python scripts/get_weather.py --city 上海 --format json

服务支持

wttr.in：主要服务，无需API密钥

Open-Meteo：备用服务，JSON格式

六、技能分发与分享

### **1. 本地使用**将技能放在工作区目录即可：~/.openclaw/workspace/skills/### **2. 打包分发**```bash# 使用skill-creator工具打包scripts/package_skill.py ./weather# 生成weather.skill文件

3. 发布到ClawHubClawHub 是OpenClaw的技能市场：# 浏览技能clawhub search "天气"# 安装技能clawhub install weather-pro# 发布技能clawhub publish ./weather.skill

七、调试与优化技巧

常用命令

# 查看所有技能openclaw skills list# 检查技能状态openclaw skills check# 查看技能详情openclaw skills info weather# 测试技能响应openclaw skills test hello_world "打个招呼"

调试流程

检查技能加载：openclaw skills list --eligible
验证工具依赖：确保所需命令可用
测试触发条件：使用不同描述测试匹配
优化指令清晰度：简化复杂步骤

八、进阶开发技巧

1. 条件指令

# 根据用户选择加载不同资源如果用户需要**基础功能**，参考[快速开始](#快速开始)。如果用户需要**高级功能**，请阅读[references/advanced.md](references/advanced.md)。

2. 工具集成

# 在frontmatter中定义工具权限allowed-tools:   - Bash(weather:*)  - Python(scripts/*)

3. 元数据增强

metadata:   clawdbot:    emoji: "🌤️"    requires:      bins: ["curl", "python3"]    category: "工具类"

九、常见问题解答

Q1：技能不生效怎么办？

A：检查以下事项：

SKILL.md文件格式是否正确

技能目录位置是否正确

是否运行了openclaw skills refresh

描述是否足够具体

Q2：如何让技能更智能？

A：

提供更多使用场景示例

添加错误处理指导

包含常见问题解决方案

提供扩展建议

Q3：技能可以调用外部API吗？

A：可以！通过scripts/目录下的脚本调用外部API，并在SKILL.md中提供详细说明。

十、总结与展望

OpenClaw技能开发系统为AI助手个性化提供了强大工具。通过技能开发，你可以：

提升效率：自动化重复任务

扩展能力：添加专业领域知识

个性化定制：打造专属助手

社区共享：贡献优秀技能

未来趋势：

更多预制技能模板

可视化技能编辑器

技能市场生态完善

跨平台技能共享

行动起来！

今日任务：

创建你的第一个OpenClaw技能

选择一个简单需求（如时间查询、单位转换）

按照教程创建技能目录

编写SKILL.md文件

测试并优化

分享你的成果：

在评论区分享你的技能创意

加入OpenClaw社区交流经验

将优秀技能发布到ClawHub