ARTICLE · 979542
openclaw里创建新的技能
在OpenClaw 中创建新技能非常简单,核心就是创建一个包含SKILL.md文件的目录。以下是完整步骤:
第一步:创建技能目录
命令如下:
mkdir -p ~/.openclaw/workspace/skills/xxskill
技能目录优先级:
工作区skills/ > ~/.openclaw/skills/ > 内置技能。
放在~/.openclaw/skills/下所有Agent 都能用。
第二步:编写 SKILL.md
这是唯一必需的文件,格式为 YAML frontmatter + Markdown,即如下图所示的架构:

Frontmatter 常用字段:
字段 | 必填 | 说明 |
name | 是 | 技能唯一标识,小写字母/数字/连字符 |
description | 是 | 技能描述,AI 靠这个判断是否调用 |
tools | 否 | 声明需要使用的工具,如web_search |
user-invocable | 否 | 是否作为/skill-name斜杠命令暴露,默认true |
第三步:(可选)添加执行脚本
完整示例:图片压缩技能
---
name: image-compressor
description: 使用 ImageMagick 批量压缩图片
tools:
- bash
---
# 图片压缩技能
当用户要求压缩图片时:
1. 确认输入目录和输出质量参数(默认 80%)
2. 使用 `magick` 命令批量处理:`magick input.jpg -quality 80 output.jpg`
3. 报告压缩前后的文件大小对比
EOF
2.重新启动openclaw刷新列表
执行下述命令:
openclaw gateway restart
openclaw将会重新启动gateway,启动后查询skill:
openclaw skills list
此时你将会看到技能已经被列出来了:

这个时候可能openclaw的UI还是不能识别,此时你可以直接在对话中告诉技能和所在的目录,它就可以找到这个技能了。以下是运行结果:

