openclawapp 中文文档 下载 App

技能系统入门:SKILL.md 怎么教助手干活

技能(Skills)是 OpenClaw 教助手「怎么干、什么时候干」的机制。本质朴素到令人意外:一个装着 SKILL.md 的文件夹。

SKILL.md 长什么样

---
name: image-lab
description: 通过提供商支持的图像工作流生成或编辑图像
---

当用户要求生成图像时,使用 image_generate 工具……

frontmatter 至少要 name 和 description;正文就是写给模型看的操作指引。支持可选字段控制斜杠命令、平台过滤、依赖检查(要求某二进制在 PATH 里、某环境变量存在才生效)等门控条件。

加载优先级(高到低)

优先级来源路径
1工作区技能<workspace>/skills
2项目智能体技能<workspace>/.agents/skills
3个人智能体技能~/.agents/skills
4托管本地技能~/.openclaw/skills
5内置技能随安装包提供
6额外目录与插件skills.load.extraDirs

同名技能高优先级生效——想覆盖内置技能,把同名副本放进工作区即可,不用动安装目录。

按智能体控制可见性

位置(优先级)和可见性(谁能用)是两回事。允许列表写在 agents 配置里:默认不限制;某个智能体可以设成空列表(一个技能都不给)或指定清单(最终集合,不与默认合并)。注意这只是「可见性」控制,不是安全边界——真正的隔离靠沙箱。

Skill Workshop:改动要过审

助手发现某段工作可复用时,不是直接改技能文件,而是往 Skill Workshop 提交提案,你审查批准后才生效:

openclaw skills workshop list
openclaw skills workshop inspect <proposal-id>
openclaw skills workshop apply <proposal-id>

插件也会带技能

官方插件可以随附自己的 Skills(比如浏览器插件附带多步浏览器控制技能),安装插件即加载,优先级与额外目录同级。

现成的技能去哪找?下一篇:ClawHub 技能市场。