---

name: qweather-china description: "基于中国气象局数据的完整天气服务，通过和风天气API提供实时天气、天气预报、生活指数、空气质量等全方位天气信息。专为中国用户优化，数据更准确，功能更全面。" homepage: https://dev.qweather.com/ metadata: { "openclaw": { "emoji": "🇨🇳", "requires": { "bins": ["python3", "curl"] } } }

QWeather China Skill

基于中国气象局数据的完整天气服务Skill，提供准确、本地化的天气信息。

功能特点

✅ 核心功能

1. 实时天气 - 实时温度、体感温度、风力风向、相对湿度、大气压强、降水量、能见度、露点温度、云量等
2. 天气预报 - 3天/7天/10天/15天/30天预报，包含白天夜间天气
3. 生活指数 - 穿衣、洗车、运动、紫外线、感冒、钓鱼、旅游等30+种生活指数
4. 空气质量 - 实时AQI、主要污染物浓度、空气质量预报
5. 天气预警 - 官方天气预警信息，包括台风、暴雨、暴雪等
6. 天文数据 - 日出日落、月升月落、月相、潮汐等
7. 格点天气 - 任意经纬度的精细化天气数据
8. 历史天气 - 过去30天的历史天气数据

✅ 数据优势

• 数据源: 中国气象局官方数据 + 国际权威数据源
• 覆盖范围: 中国3000+市县区 + 海外20万个城市
• 准确性: 针对中国气候特点优化，数据实时更新
• 完整性: 从实时天气到长期预报的全方位天气服务
• 权威性: 和风天气是中国气象局战略合作伙伴

✅ 用户体验（增强版）

• 自然语言理解: 支持多种表达方式，自动识别用户意图
• 智能地点解析: 支持城市名、拼音、简写、经纬度等多种格式
• 默认地点功能: 可设置默认查询地点，简化用户操作
• 详细错误提示: 配置错误时提供明确的解决指导
• 上下文感知: 根据天气数据提供个性化建议
• 多城市支持: 支持全国主要城市及国际城市
• 缓存优化: 智能缓存减少API调用，提高响应速度

配置要求

必需配置

1. 和风天气API认证

   • 项目ID (sub): 从和风天气开发者平台获取
   • 凭据ID (kid): 从和风天气API密钥管理获取
   • API Host: 从和风天气开发控制台获取（设置 → 开发者信息）
   • 私钥文件: 下载的私钥文件路径

2. Python依赖

   • pyjwt>=2.0.0
   • cryptography>=3.0
   • requests>=2.25

配置方法

1. 通过ClawHub安装：安装时会提示输入配置参数
2. 手动配置：设置环境变量：

   export QWEATHER_SUB="your_project_id"
   export QWEATHER_KID="your_credential_id"
   export QWEATHER_API_HOST="your_api_host"
   export QWEATHER_PRIVATE_KEY_PATH="/path/to/private_key.pem"
   

3. 详细配置指南见 CONFIGURATION.md

使用方法

基本查询

# 查询北京实时天气
python qweather.py now --city beijing

# 查询3天预报
python qweather.py forecast --city beijing --days 3

# 查询生活指数
python qweather.py indices --city beijing

# 查询空气质量
python qweather.py air --city shanghai

# 完整天气报告
python qweather.py full --city guangzhou

OpenClaw集成

在OpenClaw中直接使用自然语言查询：

用户: 北京天气怎么样？
助手: 🌤️ 北京当前天气...

用户: 上海未来3天预报
助手: 📅 上海未来3天预报...

用户: 广州生活指数
助手: 📊 广州今日生活指数...

用户: 杭州空气质量
助手: 🌫️ 杭州空气质量...

用户: 深圳需要带伞吗？
助手: 🌂 深圳建议带雨伞...

用户: 成都穿什么？
助手: 👕 成都穿衣建议...

支持的自然语言查询（增强版）

实时天气查询

• [城市]天气怎么样？ - 完整天气信息
• [城市]现在气温多少？ - 当前温度查询
• [城市]湿度怎么样？ - 湿度查询
• [城市]风力大吗？ - 风力查询
• [城市]有雨吗？ - 降水查询
• [城市]热吗？/冷吗？ - 体感温度

天气预报

• [城市]明天天气 - 明天预报
• [城市]后天温度 - 后天温度
• [城市]未来3天预报 - 多日预报
• [城市]周末天气 - 周末预报
• [城市]未来几天天气 - 默认3天预报

生活建议

• [城市]需要带伞吗？ - 雨伞建议
• [城市]穿什么衣服？ - 穿衣建议
• [城市]适合跑步吗？ - 户外活动建议
• [城市]洗车合适吗？ - 洗车建议

空气质量

• [城市]空气质量 - 完整空气质量
• [城市]AQI多少？ - AQI指数查询
• [城市]有雾霾吗？ - 污染查询

生活指数

• [城市]生活指数 - 多种生活指数
• [城市]紫外线指数 - 紫外线防护
• [城市]感冒指数 - 感冒预防

帮助功能

• 天气帮助 - 显示完整帮助信息
• 怎么查天气 - 使用指南

支持的城市

覆盖全球范围：

• 中国: 3000+市县区，包括所有地级市、县级市、县、区
• 海外: 20万个城市，覆盖全球主要城市

常用城市示例：

• 北京 (beijing) - 代码: 101010100
• 上海 (shanghai) - 代码: 101020100
• 广州 (guangzhou) - 代码: 101280101
• 深圳 (shenzhen) - 代码: 101280601
• 纽约 (newyork) - 代码: USNY0996
• 伦敦 (london) - 代码: GBLO0483
• 东京 (tokyo) - 代码: JAXX0085

查询方式：

1. 使用城市拼音（如 beijing）
2. 使用城市代码（如 101010100）
3. 使用经纬度坐标
4. 使用城市中文名称（如 北京）

完整城市代码参考：https://dev.qweather.com/docs/resource/location-list/

API端点（基于和风天气V7 API）

天气数据

• /v7/weather/now - 实时天气（3000+中国城市，20万海外城市）
• /v7/weather/3d - 3天预报
• /v7/weather/7d - 7天预报
• /v7/weather/10d - 10天预报
• /v7/weather/15d - 15天预报
• /v7/weather/24h - 逐小时预报
• /v7/weather/30d - 30天预报
• /v7/weather/warning - 天气预警

生活指数

• /v7/indices/1d - 今日生活指数（30+种指数）
• /v7/indices/3d - 3天生活指数

环境数据

• /v7/air/now - 实时空气质量
• /v7/air/5d - 5天空气质量预报

天文数据

• /v7/astronomy/sun - 日出日落
• /v7/astronomy/moon - 月升月落、月相

格点天气

• /v7/grid-weather/now - 格点实时天气
• /v7/grid-weather/3d - 格点3天预报
• /v7/grid-weather/24h - 格点逐小时预报

历史数据

• /v7/historical/weather - 历史天气（过去30天）

城市代码

常用城市代码：

• 北京: 101010100
• 上海: 101020100
• 广州: 101280101
• 深圳: 101280601
• 杭州: 101210101

完整城市代码参考：https://dev.qweather.com/docs/resource/location-list/

错误处理

常见错误

• 400: 请求参数错误
• 401: 认证失败
• 403: 权限不足
• 404: 城市不存在
• 429: 请求频率超限
• 500: 服务器错误

降级策略

1. 缓存上次成功的数据
2. 使用备用数据源（Open-Meteo）
3. 返回友好的错误提示

性能优化

缓存策略

• 实时数据: 10分钟缓存
• 预报数据: 1小时缓存
• 生活指数: 3小时缓存
• 空气质量: 30分钟缓存

请求优化

• 批量请求减少API调用
• 智能重试机制
• 连接池复用

更新日志

详细更新日志请查看 CHANGELOG.md

v1.0.0 (2026-03-14) - 发布版本

• 完整和风天气V7 API集成
• 全球城市覆盖（中国3000+市县区 + 海外20万个城市）
• 全方位天气服务（实时、预报、指数、空气质量、预警等）
• 环境变量配置，无硬编码敏感信息
• 详细的配置指南和安装向导

贡献指南

1. Fork本仓库
2. 创建功能分支
3. 提交更改
4. 创建Pull Request

许可证

基于和风天气API服务条款，仅供个人和非商业使用。

技术支持

• 和风天气官方文档: https://dev.qweather.com/docs/
• API参考文档: https://dev.qweather.com/docs/api/
• 位置列表文档: https://dev.qweather.com/docs/resource/location-list/
• 常见问题: https://dev.qweather.com/help/
• 控制台支持: https://console.qweather.com/support
• 问题反馈: 通过GitHub Issues或ClawHub