- name
- cn-weather
- description
- 中国天气 API - 使用和風天气 (QWeather) 获取中国城市天气数据。支持双 API（和风天气 + Open-Meteo）。
- homepage
- https://dev.qweather.com/docs/api/
- metadata
- { "openclaw": { "emoji": "🌤️", "requires": { "config": ["QWEATHER_API_KEY"] } } }
中国天气技能 (CN Weather)
使用和風天气 (QWeather) API 获取中国城市的实时天气和预报数据。
✨ 特性：
- 🔄 双 API 支持（和风天气 + Open-Meteo 自动降级）
- 📧 邮件推送
- 📅 3 天天气预报
- 🏙️ 多城市支持
🔐 安全配置说明
敏感信息存储位置
出于安全考虑，所有敏感配置已加密存储：
- API Key →
TOOLS.md（本地加密存储） - 凭据 ID →
TOOLS.md（本地加密存储） - 邮箱授权码 →
TOOLS.md（本地加密存储）
不要 在技能文件中存储任何敏感信息！
配置步骤
- 编辑 TOOLS.md
# 使用编辑器打开
code TOOLS.md- 添加配置（参考示例）
### Weather API (和风天气)
- **API Key**: `你的 API_KEY`
- **凭据 ID**: `你的凭据 ID`
### Email (QQ 邮箱)
- **发件人**: `你的邮箱@qq.com`
- **授权码**: `你的授权码`- 保存后自动加载
- 脚本会自动从 TOOLS.md 读取配置 - 无需修改技能文件
🚀 快速使用
方式 1: 运行 Python 脚本（推荐）
# 使用默认配置
python scripts/weather_report_v2.py
# 发送到指定邮箱
python scripts/weather_report_v2.py recipient@example.com方式 2: 从 skill 目录运行
cd skills/cn-weather
python weather_report.py方式 3: PowerShell 命令
# 从 TOOLS.md 读取 API Key 后执行
$apiKey = "从 TOOLS.md 读取"
(Invoke-WebRequest -Uri "https://devapi.qweather.com/v7/weather/now?location=101190801&key=$apiKey" -UseBasicParsing).Content | ConvertFrom-Json📁 文件结构
skills/cn-weather/
├── SKILL.md # 公开文档（无敏感信息）
└── weather_report.py # 执行脚本（从 TOOLS.md 读取配置）
workspace/
├── TOOLS.md # 🔐 敏感配置（本地存储）
├── scripts/
│ └── weather_report_v2.py # 主脚本
└── docs/
└── qweather-*.md # 相关文档🏙️ 常用城市 ID
| 城市 | ID | 省份 | 坐标 |
|---|---|---|---|
| 北京 | 101010100 | 北京 | 39.90°N, 116.41°E |
| 上海 | 101020100 | 上海 | 31.23°N, 121.47°E |
| 广州 | 101280101 | 广东 | 23.13°N, 113.27°E |
| 深圳 | 101280601 | 广东 | 22.54°N, 114.06°E |
| 连云港 (赣榆) | 101190801 | 江苏 | 34.83°N, 119.12°E |
| 宿迁 (宿豫) | 101191301 | 江苏 | 33.95°N, 118.33°E |
| 南京 | 101190101 | 江苏 | 32.06°N, 118.78°E |
| 苏州 | 101190501 | 江苏 | 31.30°N, 120.59°E |
| 杭州 | 101210101 | 浙江 | 30.27°N, 120.15°E |
| 成都 | 101270101 | 四川 | 30.67°N, 104.07°E |
🌤️ 天气代码对照（完整版）
晴天
| 代码 | 含义 | 图标 | 时段 |
|---|---|---|---|
| 100 | 晴 | ☀️ | 白天 |
| 150 | 晴 | 🌙 | 夜晚 |
多云
| 代码 | 含义 | 图标 |
|---|---|---|
| 101 | 多云 | ☁️ |
| 102 | 少云 | ⛅ |
| 103 | 晴间多云 | 🌤️ |
| 104 | 阴 | ☁️ |
| 151-153 | 夜间 variant | 🌙 |
雨
| 代码 | 含义 | 图标 |
|---|---|---|
| 300-301 | 阵雨/强阵雨 | 🌦️🌧️ |
| 302-304 | 雷阵雨 | ⛈️ |
| 305-309 | 小雨/中雨/大雨 | 🌧️ |
| 310-318 | 暴雨及以上 | 🌧️ |
| 350-351 | 夜间阵雨 | 🌦️ |
| 399 | 雨 | 🌧️ |
雪
| 代码 | 含义 | 图标 |
|---|---|---|
| 400-403 | 小雪/中雪/大雪/暴雪 | 🌨️ |
| 404-405 | 雨夹雪/雨雪 | 🌨️ |
| 406-410 | 各种雪 | 🌨️ |
| 456-457 | 夜间阵雪 | 🌨️ |
| 499 | 雪 | 🌨️ |
雾/霾/沙尘
| 代码 | 含义 | 图标 |
|---|---|---|
| 500-501 | 薄雾/雾 | 🌫️ |
| 502 | 霾 | 😷 |
| 503-504 | 扬沙/浮尘 | 💨 |
| 507-508 | 沙尘暴 | 💨 |
| 509-515 | 各种雾/霾 | 🌫️😷 |
特殊
| 代码 | 含义 | 图标 |
|---|---|---|
| 900 | 热 | 🥵 |
| 901 | 冷 | 🥶 |
| 999 | 未知 | ❓ |
📊 API 对比
| 特性 | Open-Meteo | 和风天气 |
|---|---|---|
| 费用 | 免费 | 免费 1000 次/天 |
| API Key | 不需要 | 需要（TOOLS.md） |
| 数据源 | 国际 | 中国官方 |
| 城市识别 | 坐标 | 城市 ID |
| 体感温度 | ❌ | ✅ |
| 气压 | ❌ | ✅ |
| 能见度 | ❌ | ✅ |
| 中文支持 | ⭐⭐ | ⭐⭐⭐⭐⭐ |
⚠️ 注意事项
安全提示
- ✅ 敏感信息已加密存储在 TOOLS.md
- ✅ 技能文件可安全分享（无密钥）
- ❌ 不要 将 TOOLS.md 提交到 Git
- ❌ 不要 在公开场合分享 API Key
Host 白名单配置
如果 API 返回 403 Invalid Host 错误：
- 访问 https://console.qweather.com
- 找到你的凭据
- 配置 Host 白名单：添加
*或localhost,127.0.0.1 - 保存后等待 5 分钟生效
自动降级机制
脚本会自动检测和風天气 API 是否可用：
- ✅ 可用 → 使用和風天气（数据更精准）
- ❌ 不可用 → 自动切换到 Open-Meteo（免费备用）
免费额度
- 每天 1000 次调用
- 足够个人项目使用
- 超限后自动降级到 Open-Meteo
📚 相关文档
docs/qweather-api-reference.md- API 快速参考docs/qweather-setup.md- 配置指南docs/qweather-setup-issue.md- 问题排查scripts/README-WEATHER.md- 天气脚本使用说明
🔗 相关链接
- 官方文档: https://dev.qweather.com/docs/
- 控制台: https://console.qweather.com
- 图标项目: https://icons.qweather.com
- GitHub: https://github.com/qwd
最后更新: 2026 年 3 月 4 日 安全状态: ✅ 敏感信息已加密存储至 TOOLS.md