mini-openclaw/backend/skills/get_weather_open/SKILL.md

name, description, metadata

name	description	metadata
get_weather_open	使用 OpenWeather API 获取指定城市的实时天气信息	status archived

获取天气技能 (OpenWeather API 版本)

使用场景

当用户询问某个城市的天气情况时使用此技能。使用 OpenWeather API 替代 wttr.in，提供更稳定和详细的天气信息。

前提条件

1. 需要 OpenWeather API 密钥
2. 需要在环境变量中设置 OPENWEATHER_API_KEY

执行步骤

1. 从用户消息中提取城市名称

2. 使用 python_repl 工具编写 Python 代码调用 OpenWeather API：

   import os
   import requests
   import json
   
   # 从环境变量获取 API 密钥
   api_key = os.getenv("OPENWEATHER_API_KEY")
   city = "城市名"  # 从用户输入中提取
   
   if not api_key:
       print("错误：未设置 OPENWEATHER_API_KEY 环境变量")
   else:
       # 调用 OpenWeather API
       url = f"https://api.openweathermap.org/data/2.5/weather?q={city}&appid={api_key}&units=metric&lang=zh_cn"
       response = requests.get(url)
   
       if response.status_code == 200:
           data = response.json()
           # 提取天气信息
           weather = {
               "城市": data["name"],
               "国家": data["sys"]["country"],
               "温度": f"{data['main']['temp']}°C",
               "体感温度": f"{data['main']['feels_like']}°C",
               "天气状况": data["weather"][0]["description"],
               "湿度": f"{data['main']['humidity']}%",
               "气压": f"{data['main']['pressure']} hPa",
               "风速": f"{data['wind']['speed']} m/s",
               "风向": data["wind"].get("deg", "未知"),
               "能见度": f"{data.get('visibility', 0) / 1000} km" if data.get('visibility') else "未知"
           }
           print(json.dumps(weather, ensure_ascii=False, indent=2))
       else:
           print(f"错误：无法获取天气信息，状态码：{response.status_code}")
           print(f"错误信息：{response.text}")
   

3. 解析返回的 JSON 数据，提取关键信息

4. 用自然语言向用户汇报天气情况

示例

用户：「查询北京的天气」

执行流程：

1. 提取城市：北京 (Beijing)
2. 在 python_repl 中执行上述代码，将 city 替换为 "Beijing"
3. 解析返回的 JSON 结果
4. 回复：「北京当前天气：晴，温度 25°C，体感温度 26°C，湿度 40%，风速 3.5 m/s。」

备用方案

如果 OpenWeather API 不可用，可以回退到使用 fetch_url 访问 wttr.in：

import requests
try:
    # 尝试 OpenWeather API
    # ...
except Exception as e:
    # 回退到 wttr.in
    fallback_url = f"https://wttr.in/{city}?format=j1&lang=zh"
    fallback_response = requests.get(fallback_url)
    # 解析 wttr.in 数据

注意事项

1. API 密钥：必须先在环境变量中设置 OPENWEATHER_API_KEY
2. 城市格式：建议使用英文城市名，OpenWeather API 支持中文但英文更可靠
3. 单位系统：使用公制单位 (metric)
4. 语言：设置为中文 (lang=zh_cn)
5. 错误处理：妥善处理 API 调用失败的情况
6. 速率限制：OpenWeather 免费版有调用限制，注意不要频繁调用

环境变量设置

在 .env 文件中添加：

OPENWEATHER_API_KEY=your_api_key_here

获取 API 密钥

1. 访问 https://openweathermap.org/api
2. 注册账号
3. 在 Dashboard 中创建 API 密钥
4. 免费版每天有 60 次调用限制

数据字段说明

• main.temp: 当前温度 (摄氏度)
• main.feels_like: 体感温度
• weather[0].description: 天气描述
• main.humidity: 湿度百分比
• wind.speed: 风速 (米/秒)
• visibility: 能见度 (米)