Skip to main content

Documentation Index

Fetch the complete documentation index at: https://openclaw.zhcndoc.com/llms.txt

Use this file to discover all available pages before exploring further.

技能教会代理如何以及何时使用工具。每个技能都是一个目录， 其中包含一个带有 YAML frontmatter 和 markdown 指令的 SKILL.md 文件。 有关技能如何加载和优先级排序，请参阅 Skills。

​
创建你的第一个技能

1

创建技能目录

技能保存在你的工作区中。创建一个新文件夹：
mkdir -p ~/.openclaw/workspace/skills/hello-world
2

编写 SKILL.md

在该目录中创建 SKILL.md。frontmatter 定义元数据， markdown 正文包含给代理的指令。
---
name: hello-world
description: 一个简单的技能，会说你好。
---

# Hello World 技能

当用户请求问候时，使用 `echo` 工具说
“来自你的自定义技能的你好！”。
技能 name 使用小写字母、数字和连字符的连字符命名法。保持文件夹名称和 frontmatter 中的 name 一致。
3

添加工具（可选）

你可以在 frontmatter 中定义自定义工具模式，或者指示代理 使用现有的系统工具（如 exec 或 browser）。技能也可以 与它们所文档化的工具一起随插件发布。
4

加载技能

开启一个新会话，让 OpenClaw 载入该技能：
# 来自聊天
/new

# 或重启网关
openclaw gateway restart
验证技能是否已加载：
openclaw skills list
5

测试它

发送一条应该触发该技能的消息：
openclaw agent --message "给我一个问候"
或者直接与代理聊天并请求一个问候。

​
技能元数据参考

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 浏览并贡献技能

​
技能所在位置

位置优先级范围
\<workspace\>/skills/最高每个代理
\<workspace\>/.agents/skills/高每个工作区代理
~/.agents/skills/中共享代理配置文件
~/.openclaw/skills/中共享（所有代理）
Bundled (shipped with OpenClaw)低全局
skills.load.extraDirs最低自定义共享文件夹

​
相关内容