⚔️ OpenClaw Skills 终极指南

🎯 Skills 到底是啥？

🍳 通俗比喻：技能包 = 厨房工具箱

🧩 Skills 的核心结构

每个 Skill 就是一个文件夹，里面最重要的文件是 SKILL.md。

# 技能目录结构
~/.openclaw/skills/
├── hello_world/          ← 一个技能
│   └── SKILL.md           ← 技能说明书
├── web_search/           ← 搜索技能
│   └── SKILL.md
├── feishu_doc/           ← 飞书技能
│   └── SKILL.md
└── ai_seo/              ← SEO技能
    └── SKILL.md

📄 SKILL.md 里面装了什么？

---
name: hello_world
description: 一个简单的打招呼技能
metadata:
  openclaw:
    emoji: "👋"
---

# Hello World 技能

当用户要求你打招呼时，使用 echo 工具说：
"你好！我是妙趣AI，很高兴认识你！"

记住要热情一点，毕竟伸手不打笑脸人嘛。

## 注意事项
- 第一次见面要热情
- 如果用户心情不好，说点俏皮话逗逗ta

拆解一下：

• name —— 技能名称，相当于 App 名字
• description —— 一句话介绍，相当于 App Store 简介
• metadata —— 技能配置：图标、环境要求、加载条件
• 下面的正文 —— 技能的使用说明和执行流程

⚙️ Skills 的高级玩法

1. 🔒 环境 gating（技能过滤器）

这是 OpenClaw 最骚的功能——技能会自己判断「现在能不能加载」。

---
name: gemini_skill
metadata:
  openclaw:
    requires:
      bins: ["gemini"]    # 必须安装了这个命令行工具
      os: ["darwin", "linux"]  # Windows 就别想了
      env: ["GEMINI_API_KEY"]  # 必须有 API Key
---

2. 🎯 激活条件（斜杠命令）

用户可以手动触发技能，就像在游戏里按快捷键：

---
name: image_gen
metadata:
  openclaw:
    user-invocable: true    # 允许用户手动调用
---

用户输入 /image_gen 就能激活这个技能。

3. 🔧 工具模式

有些技能可以直接调度到工具，跳过模型推理：

---
name: calculator
metadata:
  openclaw:
    command-dispatch: "tool"  # 直接调度到计算器工具
---

📍 Skills 从哪加载？

OpenClaw 从三个地方加载技能，优先级从高到低：

优先级规则：如果有同名的技能，优先级高的覆盖优先级低的。就像你永远只能用一把伞，不会同时用三把。

🛠️ 实战案例：创建一个「周报生成」Skill

mkdir -p ~/.openclaw/skills/weekly_report

---
name: weekly_report
description: 生成每周工作汇总报告
metadata:
  openclaw:
    emoji: "📊"
---

# 周报生成技能

当用户要求生成周报时，执行以下步骤：

## 执行流程
1. 读取 memory/ 目录下的本周记忆文件
2. 提取 关键工作内容（定时任务、执行结果）
3. 整理 成结构化周报格式
4. 输出 包含：任务完成情况、发现问题、下周计划

## 输出格式
- 标题：第N周工作周报（MM-DD 至 MM-DD）
- 完成事项：用 ✅/❌ 标记
- 问题分析：不超过3点
- 下周计划：3-5条

## 注意事项
- 如果没有本周记忆，提醒用户先积累素材
- 语气要专业但不失妙趣风格

openclaw agent --message "帮我生成本周周报"

🌐 ClawHub：技能市场

OpenClaw 有个官方技能市场叫 ClawHub（clawhub.com）：

• 🔍 搜索技能：找别人做好的 Skills
• 📦 一键安装：openclaw skills install <skill-name>
• 🔄 批量更新：openclaw skills update --all
• 🚀 发布技能：把做好的 Skill 分享给所有人

⚠️ 安全警告

📝 总结