# OpenClaw 技能开发入门指南

# OpenClaw 技能开发入门指南## 前言OpenClaw 是一个强大的个人 AI 助手平台而技能Skills是其核心扩展机制。通过开发自定义技能你可以让 OpenClaw 适应你的特定需求从简单的命令扩展到复杂的自动化工作流。本文将带你从零开始了解 OpenClaw 技能开发的基础知识并创建你的第一个自定义技能。## 什么是 OpenClaw 技能OpenClaw 技能是一个独立的模块包含1. **SKILL.md**技能的元数据和使用说明2. **可选资源**- scripts/可执行脚本- references/参考文档- assets/静态资源文件技能的核心是 **SKILL.md** 文件它定义了- 技能名称和描述- 触发条件- 使用方法和工作流程## 技能开发环境准备### 1. 安装 OpenClaw如果你还没有安装 OpenClaw请先安装bashnpm install -g openclaw### 2. 创建工作空间OpenClaw 使用工作空间目录来存储技能和配置bashmkdir my-openclaw-skillscd my-openclaw-skills### 3. 了解技能目录结构一个典型的技能目录结构如下my-skill/├── SKILL.md # 技能定义文件必需├── scripts/ # 可执行脚本可选│ └── my-script.py├── references/ # 参考文档可选│ └── api-docs.md└── assets/ # 静态资源可选└── template.txt## 创建你的第一个技能### 步骤 1创建技能目录创建一个名为 hello-world 的技能bashmkdir hello-worldcd hello-world### 步骤 2编写 SKILL.md 文件创建 SKILL.md 文件内容如下markdown---name: hello-worlddescription: A simple hello world skill that greets the user. Use when user says hello, hi, or greets.---# Hello World Skill这是一个简单的问候技能用于向用户问好。## 使用场景- 用户说 hello、hi 或 你好- 需要一个简单的问候响应## 工作流程1. 检测用户输入是否包含问候词2. 返回友好的问候消息## 示例对话用户: Hello!AI: Hello! How can I help you today?用户: Hi thereAI: Hi! Nice to see you!### 步骤 3测试技能将技能目录放在 OpenClaw 的技能搜索路径中然后测试bash# 将技能复制到 OpenClaw 技能目录cp -r hello-world ~/.openclaw/skills/# 或者在工作空间中测试openclaw skills list## 技能开发进阶### 1. 添加脚本资源创建一个简单的 Python 脚本bashmkdir scripts创建 scripts/greet.pypython#!/usr/bin/env python3import sysdef greet(nameWorld):return fHello, {name}!if __name__ __main__:if len(sys.argv) 1:name sys.argv[1]else:name Worldprint(greet(name))更新 SKILL.md 引用脚本markdown## 使用脚本可以使用 scripts/greet.py 来生成问候语bashpython scripts/greet.py OpenClaw### 2. 添加参考文档创建 references/usage.mdmarkdown# 使用指南## 基本用法1. 说出问候词hello, hi, 你好2. AI 会返回友好的回应## 高级功能- 支持自定义名称问候- 可以扩展为多语言支持在 SKILL.md 中引用markdown## 详细用法详见 [使用指南](references/usage.md)### 3. 添加静态资源创建 assets/template.txt欢迎使用 OpenClaw今天是 {date}祝你有美好的一天## 技能触发机制OpenClaw 使用以下方式触发技能1. **关键词匹配**SKILL.md 中的描述包含触发词2. **语义匹配**基于用户输入的语义理解3. **显式调用**用户直接指定技能名称### 触发词优化在 SKILL.md 的描述中包含多种触发方式markdowndescription: A simple hello world skill that greets the user. Use when user says hello, hi, hey, greetings, good morning, good afternoon, or any welcoming phrase.## 技能开发最佳实践### 1. 保持简洁- SKILL.md 应该简洁明了- 避免冗长的说明- 使用清晰的标题和列表### 2. 提供示例- 包含使用示例- 提供对话示例- 展示不同场景### 3. 错误处理- 考虑边界情况- 提供错误提示- 记录调试信息### 4. 文档完整- 说明使用场景- 提供配置选项- 列出依赖要求## 实际案例天气查询技能让我们创建一个更实用的技能 - 天气查询### SKILL.mdmarkdown---name: weather-querydescription: Get current weather and forecasts for any location. Use when user asks about weather, temperature, or forecasts.---# 天气查询技能获取指定位置的当前天气和预报。## 使用场景- 北京的天气怎么样- 今天会下雨吗- 上海的温度是多少## 工作流程1. 提取位置信息2. 查询天气数据3. 返回天气信息## 依赖- 需要网络连接- 使用 wttr.in API无需密钥## 示例用户: 北京的天气AI: 北京晴25°C微风### 脚本实现创建 scripts/get_weather.pypython#!/usr/bin/env python3import requestsimport sysdef get_weather(location):url fhttps://wttr.in/{location}?format%l:%c%t%wtry:response requests.get(url, timeout10)return response.text.strip()except Exception as e:return f无法获取 {location} 的天气信息: {str(e)}if __name__ __main__:location sys.argv[1] if len(sys.argv) 1 else Beijingprint(get_weather(location))## 调试技能### 1. 检查技能是否被识别bashopenclaw skills list### 2. 查看技能触发日志bashopenclaw logs --follow### 3. 测试技能触发在对话中尝试触发词用户: Hello!## 技能发布与分享### 1. 打包技能bash# 创建技能包tar -czf hello-world.skill hello-world/### 2. 分享技能- 上传到 GitHub- 分享到 OpenClaw 社区- 添加到技能仓库### 3. 安装他人技能bash# 从 GitHub 安装openclaw skills install https://github.com/user/hello-world-skill## 常见问题### Q: 技能不触发怎么办A: 检查 SKILL.md 中的描述是否包含触发词确保技能目录在搜索路径中。### Q: 如何调试技能A: 使用 openclaw logs --follow 查看实时日志。### Q: 技能可以访问网络吗A: 可以但需要在脚本中实现网络请求并注意安全性。## 总结通过本文你已经了解了 OpenClaw 技能开发的基础知识1. **技能结构**SKILL.md 可选资源2. **开发流程**创建目录 → 编写定义 → 添加资源 → 测试调试3. **最佳实践**简洁、示例、完整文档现在你可以开始创建自己的 OpenClaw 技能了从简单的问候技能开始逐步扩展到更复杂的功能。## 下一步- 阅读 OpenClaw 官方文档- 探索现有技能的实现- 加入 OpenClaw 社区交流- 创建更多实用技能---**作者**: OpenClaw 用户**版本**: 1.0**更新时间**: 2026-03-13## 附录技能开发模板### 基础模板markdown---name: skill-namedescription: Short description of what the skill does. Use when user says X, Y, or Z.---# Skill NameDetailed description of the skill.## 使用场景- 场景 1- 场景 2## 工作流程1. 步骤 12. 步骤 2## 示例用户: Example inputAI: Example response### 脚本模板python#!/usr/bin/env python3Skill Script Templateimport sysdef main(args):Main function# Your code herepassif __name__ __main__:main(sys.argv[1:])---**恭喜** 你现在已经掌握了 OpenClaw 技能开发的基础知识。开始创建你的第一个技能吧