创建 Skills
Skills 教会智能体如何以及何时使用工具。每个 Skill 是一个包含 SKILL.md 文件的目录,该文件具有 YAML frontmatter 和 markdown 指令。
有关如何加载和优先处理 Skills,请参阅 Skills。
创建你的第一个 Skill
Section titled “创建你的第一个 Skill”创建 Skill 目录
Skills 位于你的工作区中。创建一个新文件夹:
Terminal window mkdir -p ~/.openclaw/workspace/skills/hello-world编写 SKILL.md
在该目录内创建
SKILL.md。Frontmatter 定义元数据, 而 Markdown 主体包含给 Agent 的说明。---name: hello-worlddescription: A simple skill that says hello.---# Hello World SkillWhen the user asks for a greeting, use the `echo` tool to say"Hello from your custom skill!".技能
name请使用由小写字母、数字和连字符组成的连字符命名法 (hyphen-case)。 保持文件夹名称与 frontmatter 中的name一致。添加工具(可选)
您可以在 frontmatter 中定义自定义工具架构,或指示 Agent 使用现有的系统工具(如
exec或browser)。Skills 也可以 随其文档化的工具一起打包在插件中。加载 Skill
启动一个新的会话以便 OpenClaw 获取该 Skill:
Terminal window # From chat/new# Or restart the gatewayopenclaw gateway restart验证 Skill 已加载:
Terminal window openclaw skills list测试它
发送一条应触发该 Skill 的消息:
Terminal window openclaw agent --message "give me a greeting"或者直接与智能体聊天并请求问候。
Skill 元数据参考
Section titled “Skill 元数据参考”YAML frontmatter 支持以下字段:
| 字段 | 必填 | 描述 |
|---|---|---|
name | 是 | 使用小写字母、数字和连字符的唯一标识符 |
description | 是 | 向智能体显示的单行描述 |
metadata.openclaw.os | 否 | 操作系统筛选器 (["darwin"], ["linux"], 等) |
metadata.openclaw.requires.bins | 否 | PATH 上所需的二进制文件 |
metadata.openclaw.requires.config | 否 | 所需的配置键 |
- 保持简洁 — 指示模型做什么,而不是如何成为 AI
- 安全第一 — 如果您的技能使用了
exec,请确保提示词不允许来自不受信任输入的任意命令注入 - 本地测试 — 在分享之前使用
openclaw agent --message "..."进行测试 - 使用 ClawHub — 在 ClawHub 浏览和贡献技能
Skills 的位置
Section titled “Skills 的位置”| 位置 | 优先级 | 范围 |
|---|---|---|
\<workspace\>/skills/ | 最高 | 每个 Agent |
\<workspace\>/.agents/skills/ | 高 | 每个工作区 Agent |
~/.agents/skills/ | 中 | 共享 Agent 配置文件 |
~/.openclaw/skills/ | 中 | 共享(所有 Agents) |
| 内置(随 OpenClaw 附带) | 低 | 全局 |
skills.load.extraDirs | 最低 | 自定义共享文件夹 |