乐于分享
好东西不私藏

OpenClaw 技能系统:创建自定义技能

OpenClaw 技能系统:创建自定义技能

【原文】
 【一、什么是 OpenClaw 技能?】
 技能(Skill)是 OpenClaw 的核心扩展机制。一个技能本质上是一个 Markdown 文件,包含触发条件、运行逻辑和工具说明。配置好后,AI 助手在遇到匹配的任务时,会自动调用对应技能。
 【二、技能目录结构】
 ~/.openclaw/skills/
 ├── weather/          # 天气技能示例
 │   └── SKILL.md     # 技能定义文件
 ├── calculator/
 │   └── SKILL.md
 └── …
 每个技能一个文件夹,主文件必须是 SKILL.md。
 【三、SKILL.md 写作规范】
 markdown
 name: my-skill
 description: 技能描述,说明什么情况下使用
 技能名称
 【触发条件】
 描述何时调用此技能,例如:
 - “当用户询问天气时”
 - “当需要执行定时任务时”
 【使用方法】
 说明用户如何使用
 【内部逻辑】
 描述技能的执行逻辑和工具调用方式
 【四、完整示例:天气技能】
 markdown
 name: weather
 description: 获取天气预报。当用户询问天气、温度、是否下雨等情况时使用。
 天气查询技能
 【触发条件】
 用户询问以下内容时触发:
 - “今天天气怎么样”
 - “明天会下雨吗”
 - “北京温度”
 【使用方法】
 直接调用,无需额外参数
 【执行逻辑】
 1. 解析用户意图,提取地点
 2. 调用 wttr.in 或 Open-Meteo API
 3. 返回格式化天气信息
 【五、技能注册】
 将技能文件夹放入 ~/.openclaw/skills/ 后,在 config.yml 中注册:
 yaml
 skills:
   – name: weather
     path: ~/.openclaw/skills/weather
     enabled: true
 重启 Gateway 生效。
 【六、常用技能推荐】
 | 技能 | 用途 |
 |——|——|
 | weather | 天气预报 |
 | reminder | 定时提醒 |
 | web_search | 网络搜索 |
 | memory | 记忆管理 |
 | taskflow | 任务流编排 |
 【七、调试技巧】
 技能不生效?检查:
 1. description 是否描述清楚了触发场景
 2. 技能文件夹是否在正确目录
 3. config.yml 是否启用
 4. 重启 Gateway:openclaw gateway restart