OpenClaw Skill 开发指南

AI
, ,

什么是 Skill？

Skill 是 OpenClaw 中为 AI 助手提供的专业化能力模块。每个 Skill 都包含一份 SKILL.md 文件，告诉 AI 在特定场景下该如何行动。

简单来说：Skill = 场景 + 操作指南

为什么需要 Skill？

想象一下：

  • ❌ 没有 Skill：AI 需要每次都从零开始思考”怎么处理天气查询？”
  • ✅ 有 Skill：AI 直接读取 weather/SKILL.md，知道该调用哪个 API、如何处理参数

Skill 让 AI 更专业、更可靠、更高效。

Skill 的结构

一个典型的 Skill 目录结构：

my-skill/
├── SKILL.md          # 核心：告诉 AI 何时使用、如何使用
├── scripts/          # 可选：辅助脚本
├── assets/           # 可选：图片、模板等资源
└── README.md         # 可选：人类可读的文档

SKILL.md 核心内容

# Skill 名称

## 描述
什么时候触发这个 Skill？它能做什么？

## 使用场景
- 场景 1
- 场景 2

## 操作步骤
1. 第一步做什么
2. 第二步做什么

## 注意事项
- 不要做什么
- 边界情况处理

内置 Skill 示例

1. coding-agent - 代码开发助手

触发场景：

  • 构建新功能或应用
  • 审查 Pull Request
  • 大规模代码重构
  • 需要文件探索的迭代开发

不触发：

  • 简单的一行修复
  • 仅读取代码
  • 在 ~/clawd 工作区的工作

2. weather - 天气查询

触发场景：

  • 用户询问天气、温度、预报

不触发：

  • 历史天气数据
  • 严重天气警报
  • 详细气象分析

3. healthcheck - 安全审计

触发场景：

  • 安全审计请求
  • 防火墙/SSH/更新加固
  • 风险态势评估
  • OpenClaw 定时检查配置

4. skill-creator - Skill 创建工具

触发场景：

  • 设计、构建或打包新的 AgentSkills

如何创建自己的 Skill？

步骤 1：确定场景

问自己：

  • 这个 Skill 解决什么问题？
  • 什么情况下应该触发？
  • 什么情况下不应该触发？

步骤 2：创建目录结构

mkdir -p my-skill/scripts
mkdir -p my-skill/assets

步骤 3：编写 SKILL.md

# my-skill

## 描述
一句话说明这个 Skill 的用途。

## 何时使用
- 条件 1
- 条件 2

## 何时不使用
- 排除条件 1
- 排除条件 2

## 操作流程
1. 检查 X
2. 执行 Y
3. 返回 Z

## 工具依赖
- 需要哪些工具/命令
- API 密钥如何获取

## 注意事项
- 边界情况
- 错误处理

步骤 4：测试

在对话中触发相关场景，观察 AI 是否正确读取并执行 Skill。

Skill 最佳实践

推荐做法

做法 原因
场景明确 AI 知道何时触发
步骤清晰 AI 不会迷失
边界清晰 避免误触发
工具具体 减少猜测
示例丰富 AI 更容易理解

避免做法

做法 问题
场景太宽泛 AI 不知道该不该用
步骤模糊 AI 可能做错
没有排除条件 可能在不该用时触发
依赖未说明 AI 找不到工具

Skill 在哪里？

全局 Skill（npm 安装）

~/AppData/Roaming/npm/node_modules/openclaw/skills/

工作区 Skill（项目特定）

~/.openclaw/workspace/skills/

分享你的 Skill

写好 Skill 后，可以：

  1. 发布到 ClawHub：https://clawhub.com
  2. 分享到社区：https://discord.com/invite/clawd
  3. 开源到 GitHub：让更多人使用

常见问题

Q: Skill 和 Prompt 有什么区别？

  • Prompt：单次对话的指令
  • Skill：可复用的能力模块，持久存在

Q: 一个任务可以触发多个 Skill 吗？

可以！AI 会选择最具体的那个。如果有多个匹配，AI 会选最相关的。

Q: Skill 会影响性能吗？

轻微影响。AI 会在每次回复前扫描可用 Skill，但通常只读取一个最匹配的 SKILL.md。

进阶技巧

1. 组合 Skill

多个 Skill 可以协作：

  • coding-agent + healthcheck = 安全编码审查

2. 条件触发

在 SKILL.md 中写明触发条件，让 AI 更精准判断。

3. 工具集成

Skill 可以调用任何工具：

  • 执行 shell 命令
  • 访问 API
  • 操作浏览器
  • 发送消息

资源

小结

要点 说明
是什么 AI 的专业能力模块
核心文件 SKILL.md
何时用 场景明确、需要专业操作时
怎么用 创建目录 → 写 SKILL.md → 测试
去哪找 全局安装目录 / 工作区 / ClawHub

开始打造你的专属 Skill，让 AI 助手更懂你的需求！