介绍
# Weather Skill v1.1.0
快速、可靠的天气查询，支持缓存并在多个来源之间自动回退。
## 功能
- ⚡ **快速**：缓存结果 30 分钟（重复查询即时响应） - 🔄 **可靠**：自动从 wttr.in 回退至 Open-Meteo - 📍 **智能默认**：默认为美国北卡罗来纳州罗利市；预配置了常用城市 - 🛠️ **工具就绪**：暴露 `weather_fetch` 工具以供直接集成 - 💬 **斜杠命令**：可注册为 Discord/Telegram 原生命令
## 用法
### 作为工具
```python # Fetch weather for default location (Raleigh) weather_fetch()
# Fetch weather for specific city weather_fetch(location="San Francisco") ```
### 命令行
```bash # Default (Raleigh) python3 weather_fetch.py
# Specific city python3 weather_fetch.py "New York"
# JSON output python3 weather_fetch.py "Boston" --json ```
### Discord 斜杠命令
安装后，可以通过以下方式调用该技能： ``` /weather [city] ```
示例： - `/weather` — 罗利天气 - `/weather Atlanta` — 亚特兰大天气 - `/weather San Francisco` — 旧金山天气
## 工作原理
1. **检查缓存** — 如果缓存结果小于 30 分钟，立即返回 2. **尝试 wttr.in** — 快速，带有表情符号的精美格式 3. **回退至 Open-Meteo** — 可靠的 JSON API，无速率限制 4. **缓存结果** — 保存以备下次使用
## 支持的城市
预配置了 50 多个主要美国城市的坐标，包括： - 罗利、达勒姆、教堂山、夏洛特（北卡罗来纳州） - 亚特兰大、纽约、洛杉矶、芝加哥、休斯顿、凤凰城 - 波士顿、西雅图、丹佛、迈阿密、奥斯汀
**列表中没有？** 该技能默认使用罗利坐标。您可以在 `weather_fetch.py` 的 `COORDS` 字典中添加更多城市。
## 数据来源
| 来源 | 类型 | 回退顺序 | |--------|------|----------------| | wttr.in | 文本/表情符号 | 主要 | | Open-Meteo | JSON API | 回退 |
## 文件
- `skill.yaml` — 技能清单 - `weather_fetch.py` — 带有缓存的主要获取程序 - `weather_fetch.tool.json` — 工具模式 - `SKILL.md` — 本文档
## 缓存位置
``` ~/.openclaw/.cache/weather/ ├── raleigh.json ├── atlanta.json └── ... ```
## 版本历史
- **1.1.0** — 新增缓存、回退逻辑、工具定义、50+ 城市坐标 - **1.0.0** — 初始仅文档技能
## 许可证
MIT