一文带你掌握openclaw skill开发的详细教程

---
name: hello-world          # 技能名，小写kebab-case，与文件夹名一致
description: 当用户需要打招呼或说hello时使用的简单演示技能
trigger: "打招呼|hello|hi|问好"  # 触发词（关键词或正则），AI据此激活技能
tools: [exec, browser]     # 声明本技能需要用到的系统工具
version: 1.0.0
author: yourname
config:                    # 可选：需要的配置项（如API Key）
  API_KEY:
    type: string
    required: true
---

# Hello World 技能

## 何时使用
当用户请求问候、说“你好”、“hello”或需要测试连接时使用此技能。

## 执行步骤
1. 使用 `echo` 工具（或 exec 运行 `echo`）输出："Hello from your custom skill! 🚀"
2. 如果是中文语境，额外输出当前日期。

## 输入/输出
- 输入：无特定参数
- 输出：一段友好的问候语字符串

## 注意事项
- 不要执行任意用户输入的代码，仅输出固定问候。
- 保持输出简洁。

#!/bin/bash
# scripts/fetch_news.sh
CATEGORY=$1
curl -s "https://news.example.com/api/$CATEGORY" | jq '.[].title'

---
name: weather
description: 查询城市当前天气和未来预报，支持中文城市名自动解析经纬度
trigger: "天气|气温|下雨|forecast|weather|查天气"
tools: [exec]
version: 1.0.0
author: you
config:
  UNITS:
    type: string
    default: "metric"
    description: "metric(摄氏度) 或 imperial(华氏度)"
---
# Weather 天气查询技能
## 何时使用
当用户询问某个城市的天气、气温、是否下雨、未来几天天气时使用本技能。
## 执行流程
1. **解析城市**
   - 如果用户给出的是中文城市名（如“北京”），先使用 geocoding API 转换为经纬度。
   - 接口示例：
geocoding-api.open-meteo.com/v1/search?n…北京&count=1
2. **调用天气 API**
- 使用 Open-Meteo（无需 API Key）
- 基础 URL：
api.open-meteo.com/v1/forecast
- 必须参数：
- latitude
- longitude
- current_weather=true
- hourly=temperature_2m,precipitation_probability
- timezone=auto
3. **运行脚本**
- 调用本地脚本获取天气数据：
bash scripts/get_weather.sh "城市名"
- 示例：
bash scripts/get_weather.sh "Beijing"
bash scripts/get_weather.sh "东京"
4. **输出规范**
- 使用自然语言总结，不要直接输出 JSON
- 至少包含：
- 城市名
- 当前气温
- 天气状况（晴 / 雨 / 阴等）
- 降水概率
- 风速
- 示例输出：
> 北京当前气温 22°C，晴朗，降水概率 10%，风速 12 km/h。
## 错误处理
- 若城市无法解析：提示用户检查城市名称拼写
- 若 API 超时：提示“暂时无法获取天气数据，请稍后重试”
## 参考
- API 详细字段说明见 `references/open-meteo-api.md`

#!/bin/bash

set -euo pipefail

CITY="$1"

# 1. 地理编码
GEO=$(curl -s "https://geocoding-api.open-meteo.com/v1/search?name=${CITY}&count=1")
LAT=$(echo "$GEO" | jq -r '.results[0].latitude // empty')
LON=$(echo "$GEO" | jq -r '.results[0].longitude // empty')
NAME=$(echo "$GEO" | jq -r '.results[0].name // empty')

if [[ -z "$LAT" || -z "$LON" ]]; then
  echo "❌ 无法找到城市：$CITY"
  exit 1
fi

# 2. 获取天气
WEATHER=$(curl -s "https://api.open-meteo.com/v1/forecast?latitude=$LAT&longitude=$LON&current_weather=true&hourly=temperature_2m,precipitation_probability&timezone=auto")

TEMP=$(echo "$WEATHER" | jq -r '.current_weather.temperature')
WIND=$(echo "$WEATHER" | jq -r '.current_weather.windspeed')
CODE=$(echo "$WEATHER" | jq -r '.current_weather.weathercode')
RAIN=$(echo "$WEATHER" | jq -r '.hourly.precipitation_probability[0]')

# 3. 天气代码映射
case $CODE in
  0) COND="晴朗" ;;
  1|2|3) COND="多云" ;;
  45|48) COND="雾" ;;
  51|53|55) COND="小雨" ;;
  61|63|65) COND="雨" ;;
  71|73|75) COND="雪" ;;
  95|96|99) COND="雷暴" ;;
  *) COND="未知" ;;
esac

# 4. 输出
echo "${NAME} 当前气温 ${TEMP}°C，${COND}，降水概率 ${RAIN}%，风速 ${WIND} km/h。"

chmod +x ~/.openclaw/workspace/skills/weather/scripts/get_weather.sh

# Open-Meteo API 说明

## 地理编码
GET https://geocoding-api.open-meteo.com/v1/search?name=城市名

返回字段：
- results[0].latitude
- results[0].longitude
- results[0].name

## 天气预报
GET https://api.open-meteo.com/v1/forecast

常用参数：
- latitude
- longitude
- current_weather=true
- hourly=temperature_2m,precipitation_probability
- timezone=auto

天气代码（weathercode）：
- 0: 晴朗
- 1–3: 多云
- 45,48: 雾
- 51–55: 小雨
- 61–65: 雨
- 71–75: 雪
- 95+: 雷暴

openclaw gateway restart

openclaw skills list

查一下上海的天气

./scripts/get_weather.sh "Beijing"