跳转到主要内容

​
创建 Skills

Skills 会教智能体如何以及何时使用工具。每个 skill 都是一个目录， 其中包含一个带有 YAML frontmatter 和 Markdown 说明的 SKILL.md 文件。 关于 Skills 的加载和优先级，请参见Skills。

​
创建你的第一个 skill

1

创建 skill 目录

Skills 位于你的工作区中。创建一个新文件夹：
mkdir -p ~/.openclaw/workspace/skills/hello-world
2

编写 SKILL.md

在该目录中创建 SKILL.md。frontmatter 定义元数据， Markdown 正文则包含面向智能体的说明。
---
name: hello_world
description: A simple skill that says hello.
---

# Hello World Skill

When the user asks for a greeting, use the `echo` tool to say
"Hello from your custom skill!".
3

添加工具（可选）

你可以在 frontmatter 中定义自定义工具 schema，或指导智能体 使用现有系统工具（如 exec 或 browser）。Skills 也可以随插件一起发布， 与它们所说明的工具放在一起。
4

加载 skill

开启一个新会话，让 OpenClaw 读取该 skill：
# From chat
/new

# Or restart the gateway
openclaw gateway restart
验证 skill 已加载：
openclaw skills list
5

测试它

发送一条应触发该 skill 的消息：
openclaw agent --message "give me a greeting"
或者直接与智能体聊天，并请求一个问候语。

​
Skill 元数据参考

YAML frontmatter 支持以下字段：
字段必需说明
name是唯一标识符（snake_case）
description是向智能体展示的一行描述
metadata.openclaw.os否OS 过滤器（["darwin"]、["linux"] 等）
metadata.openclaw.requires.bins否PATH 上必须存在的二进制文件
metadata.openclaw.requires.config否必需的配置键

​
最佳实践

  • 保持简洁——指导模型做_什么_，而不是如何表现得像 AI
  • 安全优先——如果你的 skill 使用 exec，请确保提示词不会允许来自不可信输入的任意命令注入
  • 在本地测试——在分享前，使用 openclaw agent --message "..." 进行测试
  • 使用 ClawHub——在 ClawHub 浏览和贡献 Skills

​
Skills 的存放位置

位置优先级作用域
\<workspace\>/skills/最高每个智能体
\<workspace\>/.agents/skills/高每个工作区智能体
~/.agents/skills/中共享智能体配置文件
~/.openclaw/skills/中共享（所有智能体）
内置（随 OpenClaw 提供）低全局
skills.load.extraDirs最低自定义共享文件夹

​
相关内容