09 AI编程

AI辅助编程技能，帮助Claude学习如何创建和使用OpenClaw技能

AI编程技能

AI辅助编程技能，帮助Claude学习如何创建和使用OpenClaw技能。

技能描述

这是一个关于如何开发OpenClaw技能的完整指南。它解释了技能的结构、如何编写SKILL.md、如何创建工具脚本，以及如何在对话中"教"Claude使用这些技能。

使用场景

• 用户问："如何在OpenClaw中创建新技能？" → 提供完整指南
• 用户说："创建一个数据处理技能" → 按照指南创建技能结构
• 用户问："SKILL.md应该怎么写？" → 提供格式和示例
• 用户说："我写了一个技能，OpenClaw不会用" → 解释如何教学

技能结构

标准技能目录结构

text

skill-name/
├── SKILL.md              # 主文档（OpenClaw自动读取）
├── references/           # 参考文档（自动读取）
│   ├── topic1.md
│   └── topic2.md
└── tools/               # 工具脚本（需要教OpenClaw调用）
    └── script.py

OpenClaw如何学习

自动做的：

• ✅ 读取 SKILL.md
• ✅ 读取 references/*.md
• ✅ 理解功能说明
• ✅ 响应相关请求

需要你做的：

• ⚠️ 安装 Python 依赖
• ⚠️ 在对话中教它如何使用工具
• ⚠️ 提供清晰的工具脚本

创建技能的步骤

步骤1：创建技能目录

bash

mkdir -p ~/.openclaw/skills/my-skill/references

步骤2：编写SKILL.md

markdown

---
name: my-skill
description: 我的自定义技能
version: 1.0.0
---

# 我的技能

## 功能
- 功能1: 描述
- 功能2: 描述

## 使用方法
当我说"XXX"时，请调用YYY工具

步骤3：添加参考文档（可选）

bash

cat > ~/.openclaw/skills/my-skill/references/guide.md << 'EOF'
# 使用指南

详细的使用说明...
EOF

步骤4：在对话中"教"OpenClaw

text

用户: 我创建了一个新技能 my-skill，位置在 ~/.openclaw/skills/my-skill/

OpenClaw: 我看到这个技能了，它包含...

用户: 这个技能有一个工具在 tools/script.py，
当我说"执行XXX"时，请调用它。

OpenClaw: 明白了，我会记住这个规则。

用户: 执行XXX

OpenClaw: [自动调用工具]

SKILL.md编写规范

推荐格式

markdown

---
name: your-skill
description: 简短描述
version: 1.0.0
author: 你的名字
---

# 技能名称

## 功能概述
简要描述这个技能做什么

## 主要功能

### 功能1
- 说明
- 使用示例

### 功能2
- 说明
- 使用示例

## 使用方法

### 场景1: XXX
当用户说"XXX"时，我会：
1. 步骤1
2. 步骤2

## 工具脚本

### script1.py
位置: tools/script1.py
功能: 描述
调用方式: python tools/script1.py

## 限制
- 限制1
- 限制2

工具脚本最佳实践

基本结构

python

#!/usr/bin/env python3
"""
工具脚本名称
"""

def main():
    """主函数"""
    # 你的代码
    pass

if __name__ == "__main__":
    main()

关键点

• ✅ 清晰的函数命名
• ✅ 完整的注释
• ✅ 错误处理
• ✅ 命令行参数支持

故障排除

问题1：OpenClaw识别不到Skill

解决：

bash

# 确认位置
ls ~/.openclaw/skills/your-skill/SKILL.md

# 验证格式
head -5 ~/.openclaw/skills/your-skill/SKILL.md
# 应该看到 --- 开头的YAML

问题2：OpenClaw不会调用工具

解决：需要在对话中教它

• 告诉它工具位置
• 告诉它调用方式
• 告诉它触发条件

问题3：文档没有被索引

解决：确认文件在 references/ 目录

bash

ls ~/.openclaw/skills/your-skill/references/

最佳实践

✅ DO（推荐）

1. 清晰的命名

   • skill-name: 清楚表达功能
   • file names: 描述性命名

2. 完整的文档

   • SKILL.md: 完整功能说明
   • references/: 详细参考文档

3. 示例丰富

   • 代码示例
   • 对话示例
   • 使用场景

4. 错误处理

   • 工具脚本处理异常
   • 提供错误信息

❌ DON'T（避免）

1. 不要过度依赖自动化

   • OpenClaw需要你教它如何使用工具

2. 不要省略文档

   • 没有文档 = OpenClaw学不会

3. 不要硬编码路径

   • 使用相对路径或环境变量

注意事项

1. SKILL.md是关键：OpenClaw自动读取
2. 需要你教学：在对话中教它使用工具
3. 提供工具脚本：清晰的调用接口
4. 持续优化：根据使用反馈改进