---
name: hello-world          # 技能名，小寫kebab-case，與文件夾名一致
description: 當(dāng)用戶需要打招呼或說hello時(shí)使用的簡(jiǎn)單演示技能
trigger: "打招呼|hello|hi|問好"  # 觸發(fā)詞（關(guān)鍵詞或正則），AI據(jù)此激活技能
tools: [exec, browser]     # 聲明本技能需要用到的系統(tǒng)工具
version: 1.0.0
author: yourname
config:                    # 可選：需要的配置項(xiàng)（如API Key）
  API_KEY:
    type: string
    required: true
---

# Hello World 技能

## 何時(shí)使用
當(dāng)用戶請(qǐng)求問候、說“你好”、“hello”或需要測(cè)試連接時(shí)使用此技能。

## 執(zhí)行步驟
1. 使用 `echo` 工具（或 exec 運(yùn)行 `echo`）輸出："Hello from your custom skill! ??"
2. 如果是中文語境，額外輸出當(dāng)前日期。

## 輸入/輸出
- 輸入：無特定參數(shù)
- 輸出：一段友好的問候語字符串

## 注意事項(xiàng)
- 不要執(zhí)行任意用戶輸入的代碼，僅輸出固定問候。
- 保持輸出簡(jiǎn)潔。

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

---
name: weather
description: 查詢城市當(dāng)前天氣和未來預(yù)報(bào)，支持中文城市名自動(dòng)解析經(jīng)緯度
trigger: "天氣|氣溫|下雨|forecast|weather|查天氣"
tools: [exec]
version: 1.0.0
author: you
config:
  UNITS:
    type: string
    default: "metric"
    description: "metric(攝氏度) 或 imperial(華氏度)"
---
# Weather 天氣查詢技能
## 何時(shí)使用
當(dāng)用戶詢問某個(gè)城市的天氣、氣溫、是否下雨、未來幾天天氣時(shí)使用本技能。
## 執(zhí)行流程
1. **解析城市**
   - 如果用戶給出的是中文城市名（如“北京”），先使用 geocoding API 轉(zhuǎn)換為經(jīng)緯度。
   - 接口示例：
geocoding-api.open-meteo.com/v1/search?n…北京&count=1
2. **調(diào)用天氣 API**
- 使用 Open-Meteo（無需 API Key）
- 基礎(chǔ) URL：
api.open-meteo.com/v1/forecast
- 必須參數(shù)：
- latitude
- longitude
- current_weather=true
- hourly=temperature_2m,precipitation_probability
- timezone=auto
3. **運(yùn)行腳本**
- 調(diào)用本地腳本獲取天氣數(shù)據(jù)：
bash scripts/get_weather.sh "城市名"
- 示例：
bash scripts/get_weather.sh "Beijing"
bash scripts/get_weather.sh "東京"
4. **輸出規(guī)范**
- 使用自然語言總結(jié)，不要直接輸出 JSON
- 至少包含：
- 城市名
- 當(dāng)前氣溫
- 天氣狀況（晴 / 雨 / 陰等）
- 降水概率
- 風(fēng)速
- 示例輸出：
> 北京當(dāng)前氣溫 22°C，晴朗，降水概率 10%，風(fēng)速 12 km/h。
## 錯(cuò)誤處理
- 若城市無法解析：提示用戶檢查城市名稱拼寫
- 若 API 超時(shí)：提示“暫時(shí)無法獲取天氣數(shù)據(jù)，請(qǐng)稍后重試”
## 參考
- API 詳細(xì)字段說明見 `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} 當(dāng)前氣溫 ${TEMP}°C，${COND}，降水概率 ${RAIN}%，風(fēng)速 ${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

## 天氣預(yù)報(bào)
GET https://api.open-meteo.com/v1/forecast

常用參數(shù)：
- 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"