国内应用接入
和风天气 MCP 接入:实时天气、预报与空气质量
连接和风天气后,机器人可以查询城市实时天气、3 天或 7 天预报和空气质量,适合每日早报、出行提醒和定时推送。
和风天气接入需要注意什么?
和风天气现在给每个开发者账号分配专属 API Host(形如 xxxx.qweatherapi.com)。旧的公共域名会在校验密钥之前就直接拒绝请求,所以连接时必须同时填写您自己的 Host 和 Key,缺一不可。
连接走和风天气官方 HTTP 接口,由 OpenClaw Launch 服务端代为调用:Host 与 Key 一起加密保存在服务端,机器人只拿到解析后的天气结果。免费开发版每天有固定调用额度,日常提醒类用法通常够用。
接入后可以做什么?
- 实时天气:按城市查询当前温度、天气现象、风向风力和湿度。
- 天气预报:查询未来天气,默认 3 天,也可以指定 7 天;只支持这两个区间。
- 空气质量:查询城市 AQI、PM2.5 和主要污染物。
- 定时早报:配合定时任务,让机器人每天固定时间把天气推送到您的聊天平台。
如何获取 API Host 与 API Key?
需要两个字段:项目专属 API Host 和 API Key,都在和风天气控制台里。
- 注册并创建项目 — 登录 console.qweather.com,创建一个项目(免费开发版无需认证即可使用)。
- 复制专属 Host — 在项目详情中找到形如 xxxx.qweatherapi.com 的专属 API Host。
- 创建 API Key — 在同一项目下创建 Key 并复制。
- 连接并测试 — 在国内应用列表选择和风天气,填入 Host 与 Key,然后问机器人一个城市的当前天气确认连通。
连接后可以直接这样问
- “明天北京会下雨吗?”
- “给我看看未来 7 天上海的天气”
- “广州现在的空气质量怎么样?”
使用前必须知道的限制
免费开发版每天有固定调用额度(约 1000 次),超出后由和风天气直接返回错误。城市名会先经过官方地理查询解析,同名城市可能需要更精确的写法。旧的公共 API 域名已不可用,必须使用您账号的专属 Host。
天气数据用于日常参考,涉及出行安全、施工作业或应急决策时请以气象部门发布的预警为准。
托管连接还是自己搭工具?
| 方案 | 适合谁 | 您需要负责什么 |
|---|---|---|
| OpenClaw Launch 托管 | 希望尽快让机器人持续在线并连接和风天气的用户 | 提供必要授权、确认敏感操作并管理自己的应用账户 |
| 自行部署 | 已有服务器、愿意维护 OpenClaw/Hermes 与兼容工具的开发者 | 自行申请 Host 与 Key,自建鉴权头、城市解析、额度控制与错误处理。 |
自行部署是合理选择;托管方案省下的是服务器配置、运行监控和集成维护时间。OpenClaw Launch 的托管价格为首月 $3,续费 $6/月,支持支付宝和微信支付。应用自身的会员、API 配额或其他费用仍按应用方规则计算。
已经有机器人?前往国内应用一键接入查看连接状态;第一次部署可先阅读养龙虾入门指南。
和风天气接入常见问题
为什么要填两个字段?
和风天气给每个账号分配了专属 API Host,旧的公共域名会在校验 Key 之前就拒绝请求,所以必须同时提供 Host 和 Key。
免费额度是多少?
免费开发版每天约 1000 次调用,具体以和风天气控制台显示为准。
能查多少天的预报?
支持 3 天和 7 天两种预报,默认返回 3 天,指定 7 天即可拿到一周预报。
可以做每天定时推送吗?
可以。配合机器人的定时任务,把天气查询结果按固定时间推送到您使用的聊天平台。