OpenClaw Skills 开发教程：从零创建自定义Agent技能

📅 2026-03-19 ⏱️ 阅读时间: 8分钟 🏷️ OpenClaw | Agent Skills | 开发教程

世界上有一种技能叫做OpenClaw Skill，它就像AI的超能力补给站——每次Agent需要新技能，只要丢给它一个SKILL.md，瞬间就能解锁新姿势。今天我们就来聊聊，如何亲手打造一个专属技能。

什么是 OpenClaw Skills？

OpenClaw Skills 是一种模块化的Agent技能系统。通过编写简单的Markdown文件，你可以让AI Agent获得特定领域的专业能力。就像给钢铁侠的战甲装上新模块——不需要改核心代码，只需要一个配置文件。

Skill 目录结构

一个标准的Skill包含以下结构：

~/.openclaw/skills/my-skill/
├── SKILL.md          # 技能定义文件（必须）
├── templates/        # 模板文件（可选）
│   └── example.txt
├── scripts/          # 辅助脚本（可选）
│   └── helper.sh
└── data/             # 数据文件（可选）
    └── knowledge.json

SKILL.md 核心配置

SKILL.md 是技能的灵魂，我们来拆解它的结构：

# SKILL.md - 我的自定义技能

## 触发条件
当用户提到以下关键词时激活此技能：
- 关键词1
- 关键词2
- 特定任务描述

## 技能说明
详细描述这个技能做什么，Agent会如何使用它。

## 执行步骤
1. 第一步：做什么
2. 第二步：怎么做
3. 第三步：输出什么

## 注意事项
- 重要提醒1
- 重要提醒2

## 示例
用户输入：xxx
预期输出：yyy

实战示例：创建SEO优化技能

让我们创建一个实用的SEO优化技能：

# SKILL.md - SEO Optimizer

## 触发条件
- SEO优化
- 关键词分析
- 搜索引擎优化
- 元标签优化

## 技能说明
帮助用户优化网页内容以提升搜索引擎排名。包含关键词研究、内容优化、技术SEO检查。

## 执行步骤
1. **分析目标关键词**：检查搜索量、竞争度
2. **审查页面内容**：标题、描述、H1-H6结构
3. **检查技术SEO**：页面速度、移动适配、结构化数据
4. **输出优化建议**：具体可执行的改进清单

## 输出格式
### SEO诊断报告
- 关键词评分：X/100
- 内容评分：X/100
- 技术评分：X/100

### 优化建议
1. [优先级高] 具体建议
2. [优先级中] 具体建议

## 参考资源
- Google SEO指南
- 关键词工具API

最佳实践

单一职责：每个Skill专注一个领域，不要贪多
清晰触发：触发条件要明确，避免冲突
步骤可执行：每个步骤都应该是Agent能理解的动作
包含示例：提供输入输出示例，帮助Agent理解预期
版本管理：用Git管理你的Skills，方便迭代

调试技巧

如果Skill没有按预期工作：

检查触发关键词是否匹配
确认SKILL.md格式正确（UTF-8编码）
查看Agent日志了解执行过程
简化步骤，逐步调试