这一篇只做一件事：让你在 10 分钟内写出第一个可加载、可验证的 OpenClaw Skill。我们严格按官方 Creating Skills 走最小路径，不上复杂脚本，不上外部 API，先把「能被发现」这个核心闭环跑通。
本章完成标准
你完成后应该能做到：在本地创建 hello-world Skill，OpenClaw 能识别它，并在测试消息中按你的说明触发响应。
开始前准备（30 秒自检）
- 你已经完成安装，并能打开 Dashboard。
- 你当前环境能执行
openclaw命令。 - 你会用一个文本编辑器创建和保存
.md文件。
openclaw --version如果上面命令能返回版本号，就可以继续。
步骤一：创建 Skill 目录
官方最小要求是「一个目录 + 一个 SKILL.md」。先在 workspace 技能目录里创建你的第一个 Skill 文件夹：
mkdir -p ~/.openclaw/workspace/skills/hello-world
cd ~/.openclaw/workspace/skills/hello-world如果你是 Windows 用户，请在 WSL2 的 Ubuntu 终端执行，不要在原生 CMD/PowerShell 里做这一步。
步骤二：写入最小版 SKILL.md
在 hello-world 目录里新建 SKILL.md，粘贴下面内容：
---
name: hello_world
description: 用于返回简短问候的最小示例 Skill
---
# Hello World Skill
适用场景：
- 用户只需要一句简短问候
- 用于验证自定义 Skill 是否已加载
执行规则：
- 返回一句简洁问候
- 不要输出冗长解释
这一步先不要加脚本、不要加 API，先保证结构正确。
步骤三：让 OpenClaw 重新加载 Skill
官方建议是刷新 skills 或重启 gateway。对新手最稳的方式是：
- 先在 Dashboard 新开一个会话。
- 如果还是没生效，再执行网关重启。
openclaw gateway restart大多数「我明明改了却没生效」都出在会话仍在使用旧快照。
步骤四：发送一条明确测试消息
在 Dashboard 新会话里发送：
请使用 hello_world 这个 Skill，给我一句测试问候。你也可以用 CLI 测试：
openclaw agent --message "Please use hello_world skill and return one short greeting."步骤五：确认是否真的成功
成功不是看文案好不好，而是看下面三点：
- 会话里有按你规则输出的简短问候。
- 没有出现
SKILL.md解析报错。 - 重开会话后仍可重复触发。
需要看运行日志时可用：
openclaw logs --follow5 个最常见错误
- 目录放错：没有放到 workspace 的 skills 目录。
- 文件名写错：必须是
SKILL.md（全大写）。 - frontmatter 语法错：
---分隔线或冒号格式写坏。 description太空：模型无法判断何时使用。- 没刷新会话：内容改了，但会话仍在用旧版本。
你下一步该做什么
- 继续完善文档结构：看 SKILL.md 写作规范。
- 开始接脚本和资源：看 目录结构与资源管理。
- 让 Skill 能调用能力：看 调用 Tools / 外部 API。