给小龙虾OpenClaw创建一个Skill

在 OpenClaw 中创建一个 Skill 非常简单。你只需要准备一个包含核心 SKILL.md 文件的文件夹，然后用通俗的 Markdown 语言写下你的指令即可，甚至不需要编程基础。下面是一个快速上手的指南。

📂 第一步：准备目录与核心文件

每个 Skill 都是一个独立的文件夹，建议创建在 ~/.openclaw/workspace/skills/ 目录下，这是优先级最高的位置，便于测试。

一个标准的 Skill 目录结构如下：

“`text

your-skill-name/

├── SKILL.md (核心文件，必须包含)

├── scripts/ (可选，存放可执行脚本)

├── references/ (可选，存放参考文档)

└── assets/ (可选，存放静态资源)

“`

根据功能需求，scripts, references, assets 这几个文件夹是可选的。你可以在该目录下创建名为 my-first-skill 的文件夹作为测试。

📄 第二步：编写 SKILL.md 文件

这是 Skill 的核心，由元数据 (YAML) 和指令内容 (Markdown) 两部分组成。

1. YAML 元数据

位于文件顶部，用 — 包裹，用于声明技能的基本信息。

“`yaml

—

name: my-first-skill

description: 这是一个简单的技能，用于演示和测试。

—

“`

其中，name 和 description 字段是必填的。name 应使用小写字母、数字和连字符，description 需提供清晰且有意义的功能描述。此外，你还可以在 metadata.openclaw 下声明运行环境（os）、所需二进制文件（bins）等，按照官方网站标准编写即可。

2. 核心正文 (Markdown)

这部分是给 AI 看的“说明书”，用自然语言告诉它何时以及如何使用该 Skill。建议至少包含：

· 技能描述：简单说明功能。

· 触发条件：明确哪些用户指令会激活此技能。

· 工作流程：详细说明执行步骤。

· 工具及示例：列出需要调用的内置工具（如 echo, bash）或自定义脚本，并提供示例。

· 配置指引：如果需要用户配置API密钥等，需要清晰说明。

✅ 第三步：安装、测试与分享

将包含 SKILL.md 的整个文件夹放入正确的目录后，依据该技能的官网开发指引，即可进行加载和测试：

1. 刷新技能：重启会话（在聊天中输入 /new）或重启服务（openclaw gateway restart）。

2. 验证与测试：运行 openclaw skills list 查看技能是否已加载。然后通过聊天或命令 openclaw agent –message “give me a greeting” 进行测试。

3. 分享到 ClawHub：在技能目录下运行 npx clawhub@latest publish，准备分享。

💡 开发最佳实践

· 设计理念：技能应像说明书一样令 AI “知道做什么”，从简入手。

· 安全考量：如需使用 bash 等执行命令的工具，请务必处理非信任输入，避免命令注入风险。

· AI 辅助开发：你可以通过向 AI 清晰描述目标与流程，让 OpenClaw 自己帮你编写 SKILL.md 文件。参考官方指南有助于优化指令。

🛠️ 故障排查

如果技能未被加载或运行异常，请按以下步骤检查：

· 加载问题：确保 SKILL.md 的 YAML 格式正确且在目录顶层，并已重启服务或开始新会话。

· 执行问题：与AI核对并优化 SKILL.md 中的触发条件和指令逻辑。

· 环境问题：检查环境变量配置，确保依赖（如scripts/下的脚本）已正确安装和授权。

注：以上内容由DeepSeek提供