手把手教你写一个 OpenClaw Skill

mkdir -p ~/.openclaw/workspace/skills/my-weather
cd ~/.openclaw/workspace/skills/my-weather

my-weather/
├── SKILL.md          # 核心：AI 的指令说明书
├── scripts/          # 可选：脚本文件
│   └── weather.py
└── references/       # 可选：参考资料、API 文档

---
name: my-weather
description: 查询任意城市的实时天气和未来预报。当用户询问天气时使用。
---

# 天气查询 Skill

## 使用场景

当用户询问"天气怎么样"、"明天会下雨吗"、"XX城市气温"时激活本 Skill。

## 操作步骤

1. 识别用户询问的城市名称（默认：北京）
2. 调用 `exec` 工具运行：
   `python3 {baseDir}/scripts/weather.py --city <城市名>`
3. 将返回的 JSON 数据整理为自然语言回复

## 注意事项

- 城市名使用中文或英文均可
- 返回数据包含：当前气温、天气状况、未来 3 天预报

# scripts/weather.py
import argparse, requests, json

parser = argparse.ArgumentParser()
parser.add_argument("--city", default="北京")
args = parser.parse_args()

resp = requests.get(
    f"https://wttr.in/{args.city}?format=j1",
    timeout=10
).json()

current = resp["current_condition"][0]
print(json.dumps({
    "city": args.city,
    "temp_c": current["temp_C"],
    "desc": current["weatherDesc"][0]["value"],
}, ensure_ascii=False))

openclaw skills list          # 查看所有已加载的 Skill
openclaw skills list --eligible  # 只看当前可用的
openclaw skills info my-weather  # 查看某个 Skill 的详情

---
name: my-weather
description: 查询天气预报。
metadata: {"openclaw": {"requires": {"bins": ["python3"], "env": ["WEATHER_API_KEY"]}, "primaryEnv": "WEATHER_API_KEY"}}
---

{
  "skills": {
    "entries": {
      "my-weather": {
        "enabled": true,
        "apiKey": "your-api-key-here"
      }
    }
  }
}

# 搜索 Skill
clawhub search weather

# 安装 Skill
clawhub install my-weather

# 更新所有已安装的 Skill
clawhub update --all

# 把 Skill 目录放到 ~/.openclaw/workspace/skills/
cp -r my-weather ~/.openclaw/workspace/skills/

# 或放到用户级目录（所有 Agent 共享）
cp -r my-weather ~/.openclaw/skills/

# 克隆包含 Skill 的仓库
git clone https://github.com/yourname/my-skills ~/.openclaw/skills/my-skills-pack

# OpenClaw 会扫描其中每个包含 SKILL.md 的子目录

{
  "skills": {
    "load": {
      "extraDirs": [
        "~/my-projects/team-skills",
        "/shared/company-skills"
      ]
    }
  }
}

工作区 skills/ > ~/.openclaw/skills/ > 内置 Skills > extraDirs

写 SKILL.md → 放入目录 → OpenClaw 自动发现 → AI 对话中自动激活