前置准备

• 已安装并运行 OpenClaw。

  

• 知道你的技能目录位置，通常是 ~/.openclaw/workspace/skills/。

常见痛点：很多人因为安装版本不匹配导致 Gateway 无法启动，或者把技能文件放错目录导致程序找不到新技能。

Skill 标准结构

A typical Skill directory looks like this:

my-custom-skill/
├── scripts/ # 可选：Shell/Python/Node.js 执行脚本
│ └── run.sh
├── references/ # 可选：API 文档、详细参考，按需加载节省 Token
└── assets/ # 可选：静态资源

关键点：

• SKILL.md 是唯一必需文件。
• Avoid putting unrelated files in root folder – keeps skill lightweight.

编写主要文件 SKILL.md

This section defines skill's identity and trigger conditions:

---
再看name，hello-world # 技能名，小写 k‑b‑case。
与文件夹名一致
description: 当使用者需要打招呼或说hello时使用的简单演示技能
trigger: "打招呼|hello|hi|问好" # 触发词，AI 据此激活技能
从tools来看，# 声明本技能需要用到的程序工具
version:
.author:
说到config，API_KEY:
再看type，string
required: true
---
# Wear 天气查询技能
...

• Name: 必须唯一，仅含小写字母、数字、短横线。其实，
• Trigger:
• No trigger → 使用者必须显式调用；"*"" → 全局常驻；正则表达式亦可支持更复杂规则。

Coding Tips:

• - After Frontmatter,write clear step-by-step instructions just like a task list.
• - Keep outputs concise – avoid dumping raw JSON unless necessary.
• - Never execute arbitrary user input directly .