KnowAir Forecast 明气预报

通过坐标获取实时天气预报,支持小时级与日级预测。

已扫描
适合谁
需要精准天气信息的旅行者、日常出行或户外活动策划者
不适合谁
无需天气数据的普通文档处理者、无法访问网络或配置 API 密钥的用户
国内可用性
需网络配置。可能需要网络配置或第三方服务可访问。
安装难度
新手友好(★☆☆)。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

openclaw skills install @shuowang-ai/knowair-forecast

Skill 说明

命令、参数、文件名以原文为准

KnowAir 明气预报 — 小时级与日级天气预报

使用彩云天气 API 查询任意位置的详细小时级和日级天气预报。

前置条件

  1. 有效的彩云天气 API Token,需设置为环境变量 CAIYUN_TOKEN,或存于 ~/.config/knowair/token 文件中。
  2. 目标位置的坐标(经度、纬度)。

快速开始

python3 scripts/query_forecast.py --lng 116.3176 --lat 39.9760 --type daily --days 7

使用流程

  1. 解析坐标 — 如需,将城市名称转换为经度和纬度。
  2. 选择预报类型hourly(小时级)或 daily(日级)。
  3. 运行脚本
   python3 scripts/query_forecast.py --lng <LNG> --lat <LAT> --type <TYPE>
  1. 展示结果 — 突出显示温度范围、降水概率以及显著的天气变化。

参数说明

参数说明默认值
--lng经度(-180 至 180)必填
--lat纬度(-90 至 90)必填
--type预报类型:hourlydailydaily
--hours预报小时数(1-360,仅限小时模式)48
--days预报天数(1-15,仅限日模式)7
--detail-level显示密度(0-6),0=自动,1=每小时,以此类推0
--lang输出语言:enzhen

默认设置

  • 预报类型:daily
  • 天数:7,小时数:48
  • 显示密度:自动(0)
  • 语言:en

错误处理

  • 缺少 API Token → 返回退出码 2,并提示配置方法。
  • API 请求错误 → 返回退出码 1,并输出错误详情。
  • 网络不可达 → 建议用户检查网络连接。

额外资源

  • [examples.md](examples.md) — 使用示例
SA
@shuowang-ai

已收录 1 个 Skill

相关推荐