功能描述

老默天气 - 支持 AQI/花粉/预警/生活建议，中英双语输出，多城市对比。v2.1 完全免费 API。

使用说明 (SKILL.md)

Weather Skill V2.0 / 天气技能 v2.0

Name: Weather
Author: mrzhangkris

P0 + P1 Features Complete / P0 + P1 功能已完成

Get current weather conditions, forecasts, AQI, pollen data, extreme weather alerts, and lifestyle suggestions. Supports bilingual (Chinese/English) output with full translation of conditions and AQI descriptions.

获取当前天气状况、预报、空气质量、花粉数据、极端天气预警和生活建议。支持中英双语输出，天气状况和空气质量完全翻译。

When to Use / 使用场景

✅ USE this skill when: / 使用此技能：

"What's the weather?" / "天气怎么样？"
"Will it rain today/tomorrow?" / "今天/明天会下雨吗？"
"Temperature in [city]" / "[城市] 的温度"
"Weather forecast for the week" / "本周天气预报"
"Air quality in [city]" / "[城市] 的空气质量"
"Pollen levels" / "花粉指数"
"Weather alerts" / "天气预警"
"Lifestyle suggestions" / "生活建议"
"Compare weather between cities" / "多城市天气对比"
Travel planning weather checks / 旅行计划天气查询
Allergy sufferers checking pollen / 过敏患者查询花粉

❌ DON'T use this skill when: / 不要使用：

Historical weather data → use weather archives/APIs / 历史天气数据
Climate analysis or trends → use specialized data sources / 气候分析或趋势
Hyper-local microclimate data → use local sensors / 超本地微气候数据
Aviation/marine weather → use specialized services (METAR, etc.) / 航空/海洋天气

✅ Feature Highlights / 功能亮点

P0 Features (基础功能 - 已完成)

Feature / 功能	Description / 描述	Command / 命令
🔄 Dual API Fallback	wttr.in + Open-Meteo fallback for reliability / wttr.in + Open-Meteo 双重 API 确保稳定性	Automatic / 自动
📊 Air Quality (AQI)	PM2.5, AQI from Open-Meteo Air Quality API (FREE) / PM2.5、AQI 数据（Open-Meteo 空气质量 API，免费）	`--aqi`
🌸 Pollen Data	Tree/Grass/Ragweed/Mold pollen levels / 树木/草/豚草/霉菌花粉数据	`--pollen`
⚠️ Extreme Alerts	Rain/Snow/Thunderstorm warnings / 雨/雪/雷暴预警	`--alerts`
🌍 Bilingual Support	Chinese/English output / 中英文输出	`--lang zh/en/auto`
💡 Free All APIs	No paid APIs, fully free service / 全部免费 API，无付费服务	Free / 免费

P1 Features (高级功能 - 已完成)

Feature / 功能	Description / 描述	Command / 命令
💡 Lifestyle Suggestions	Clothing/Exercise/Car Wash/Allergy advice / 穿衣/运动/洗车/过敏建议	`--advice`
📈 Multi-City Comparison	Compare weather between cities with highlights / 多城市对比天气（带亮点）	`--compare "Beijing,Shanghai"`
🗺️ Smart Location	City name/Airport/Coordinates with automatic geocoding / 城市名/机场/坐标自动地理编码	Automatic / 自动

📝 Usage Guide / 使用指南

Basic Commands / 基本命令

# Current weather / 当前天气
weather Beijing
天气 北京

# With all data / 完整数据
weather Beijing --aqi --pollen --alerts --advice

# Multi-city comparison / 多城市对比
weather --compare "Beijing,Shanghai,Guangzhou"

Full Feature Examples / 完整功能示例

# Weather with AQI and lifestyle suggestions / 天气+空气质量+建议
weather Beijing --aqi --advice

# Weather with pollen data / 天气+花粉数据
weather Beijing --pollen

# Weather with extreme alerts / 天气+预警
weather Beijing --alerts

# Compare three cities with all data / 三个城市完整对比
weather --compare "Beijing,Shanghai,Guangzhou" --aqi --pollen --alerts --advice

Output Formats / 输出格式

# Text format (default) / 文本格式（默认）
weather Beijing

# Table format / 表格格式
weather Beijing --format table

# JSON format / JSON 格式
weather Beijing --format json --aqi

Language Options / 语言选项

# Auto-detect (default) / 自动检测（默认）
weather Beijing --lang auto

# Force Chinese / 强制中文
weather Beijing --lang zh

# Force English / 强制英文
weather Beijing --lang en

📊 API and Limits / API 和限制

API / API	Free Limit / 免费限制	Notes / 说明
wttr.in	250/day	Main weather source / 主天气源
Open-Meteo	Unlimited	Complete weather suite / 完整天气服务（免费）
Open-Meteo Air Quality	Unlimited	Free air quality API / 免费空气质量 API
Open-Meteo Pollen	Unlimited	Free pollen API / 免费花粉 API
Open-Meteo Alerts	Unlimited	Free weather alerts / 免费天气预警

Note: All APIs are completely free with no API key required! / 注意: 所有 API 完全免费且无需 API Key！

🌍 Supported Cities / 支持城市

We support cities worldwide! Key examples:

我们支持全球城市！主要城市：

🇨🇳 China / 中国: Beijing (北京), Shanghai (上海), Guangzhou (广州), Shenzhen (深圳), Chengdu (成都)
🇺🇸 USA / 美国: New York (纽约), Los Angeles (洛杉矶), Chicago (芝加哥)
🇬🇧 UK / 英国: London (伦敦), Manchester (曼彻斯特)
🇯🇵 Japan / 日本: Tokyo (东京), Osaka (大阪)
🇫🇷 France / 法国: Paris (巴黎), Lyon (里昂)
🇩🇪 Germany / 德国: Berlin (柏林), Munich (慕尼黑)
And 1000+ more cities! / 还有 1000+ 个城市！

Add a city? / 添加城市:

English name / 英文名称
Chinese name / 中文名称
Coordinates / 坐标: "lat,lng" (e.g., "39.9042,116.4074")

🎯 Best Practices / 最佳实践

Daily Weather Check / 日常天气查询

weather Beijing --aqi --advice

This gives you: / 这会给你:

Current weather / 当前天气
Air quality / 空气质量
Lifestyle suggestions / 生活建议

Travel Planning / 旅行规划

weather --compare "Beijing,Shanghai,Guangzhou" --aqi --advice

This helps you: / 这会帮你:

Compare weather between cities / 比较城市天气
Check air quality / 检查空气质量
Get advice for each city / 获取每个城市的建议

Allergy Sufferers / 过敏患者

weather Beijing --pollen --advice

This shows you: / 这会显示:

Pollen levels for all types / 所有类型的花粉水平
Allergy risk / 过敏风险
Management suggestions / 管理建议

🔧 Implementation Details / 实现细节

Architecture / 架构

weather-v2.0/
├── lib/
│   ├── api.js          # API wrappers (wttr, open-meteo, waqi, pollen, alerts)
│   ├── formatter.js    # Output formatters (text, table, json)
│   ├── suggestions.js  # Lifestyle suggestions engine
│   └── client.js       # Main client combining all features
├── weather.js          # CLI entry point
└── tests/              # Test suite

Key Components / 核心组件

WttrAPI: Primary weather source (wttr.in)
OpenMeteoAPI: Fallback weather API (no key needed)
WAQIAPI: Air quality data (PM2.5, AQI)
PollenAPI: Pollen index data
AlertsAPI: Extreme weather warnings
Geocoder: Smart location recognition
SuggestionsEngine: Lifestyle recommendations
Formatter: Multi-format output (text/table/json)

Language Detection / 语言检测

Check explicit --lang parameter first / 首先检查显式 --lang 参数
Detect query language (Chinese vs Latin characters) / 检测查询语言
Fall back to system locale / 回退到系统区域设置
Default to English if undetermined / 默认英文

City Name Mapping / 城市名映射

{
  "北京": { lat: 39.9042, lng: 116.4074, name: "Beijing" },
  "Shanghai": { lat: 31.2304, lng: 121.4737, name: "上海" },
  // ... 1000+ cities
}

Output Templates / 输出模板

Chinese Template / 中文模板:

📍 {city}: {emoji} {temp}°C, {condition}, 湿度 {humidity}%
📊 空气质量: {aqi} ({quality})
🌸 花粉指数: {pollen}
 Clothing: {clothing}
Exercise: {exercise}

English Template / 英文模板:

📍 {city}: {emoji} {temp}°C, {condition}, {humidity}% humidity
📊 AQI: {aqi} ({quality})
🌸 Pollen: {pollen}
 Clothing: {clothing}
Exercise: {exercise}

📚 Examples / 示例

Example 1: Daily Check / 示例 1: 日常查询

$ weather Beijing --aqi --advice

📍 北京 ☀️
├─ 温度: 25°C | 体感: 27°C
├─ 天气: 晴 | 湿度: 60%
└─ 风: 北 5km/h

📊 空气质量: 75 (良)
   PM2.5: 45 | PM10: 65

👕 穿衣建议: 穿短袖、短裤
🚗 洗车建议: 适合洗车
🏃 运动建议: 适合户外运动
🌸 过敏建议: 花粉风险低

Example 2: Multi-City / 示例 2: 多城市对比

$ weather --compare "Beijing,Shanghai,Guangzhou" --aqi

📊 多城市天气对比

📍 3 个城市: Beijing, Shanghai, Guangzhou

🔥 最热: Guangzhou (32°C)
❄️ 最冷: Beijing (25°C)
💧 最湿润: Shanghai (85%)
💨 风最大: Beijing (15km/h)

┌─────┬─────────────────────────────────────────────────┐
│ 城市       │ 温度         | AQI     | 湿度       │
├─────┼─────────────────────────────────────────────────┤
│ ☀️ 北京      │ 25°C   | 75 (良) │ 60% │
│ 🌤️ 上海      │ 28°C   | 60 (良) │ 70% │
│ 🌧️ 广州      │ 32°C   | 55 (优) │ 85% │
└─────┴─────────────────────────────────────────────────┘

Example 3: Full Features / 示例 3: 完整功能

$ weather Beijing --aqi --pollen --alerts --advice --format table

┌─────┬─────────────────────────────────────────────────┐
│ 北京       │ 温度         | AQI     | 湿度       │
├─────┼─────────────────────────────────────────────────┤
│ ☀️ Beijing  │ 25°C   | 75 (良) │ 60% │
└─────┴─────────────────────────────────────────────────┘

🐛 Troubleshooting / 故障排除

City Not Found / 城市未找到

❌ Error: City not found: InvalidCity

Solution / 解决方案:

Check city spelling / 检查城市拼写
Try English name / 尝试英文名称
Try coordinates / 尝试坐标: "39.9042,116.4074"

AQI/data Unavailable / 空气质量数据不可用

📊 空气质量: N/A

Solution / 解决方案:

Some APIs may not have data for all cities / 部分 API 可能没有所有城市数据
Try a larger city / 尝试大城市
Wait and retry / 稍后重试

Rate Limiting / 限速

If you see frequent errors / 如果频繁出现错误:

Wait a few minutes / 等待几分钟
Reduce request frequency / 减少请求频率
Check API status / 检查 API 状态

📖 Documentation / 文档

README.md: Complete user guide / 完整用户指南
tests/test-weather.js: Test suite / 测试用例
_meta.json: Skill metadata / 技能元数据

🤝 Contributing / 贡献

This skill is maintained by the OpenClaw community / 这个技能由 OpenClaw 社区维护.

GitHub: https://github.com/openclaw
Discord: https://discord.gg/openclaw

Contributions welcome! / 欢迎贡献！

📄 License / 许可证

MIT License

🙏 Acknowledgments / 致谢

wttr.in for weather data / 感谢 wttr.in 提供天气数据
Open-Meteo for complete weather suite (weather, AQI, pollen, alerts) / 感谢 Open-Meteo 提供完整的天气套件（天气、空气质量、花粉、预警）
**All APIs above are completely free with no API key required! / 以上所有 API 完全免费且无需 API Key！

安全使用建议

This skill appears to be what it says: a weather CLI using public APIs and requiring no credentials. Before installing, quickly check: (1) package.json for dependencies and any postinstall/postinstall scripts (to ensure no unexpected downloads or scripts run), (2) whether the platform will run npm install / node — the SKILL.md shows 'weather' and lists 'curl' but the code is Node-based, so confirm how it will be executed on your agent, (3) that you are comfortable with the skill making outbound network calls to wttr.in and Open‑Meteo endpoints (no secrets are sent), and (4) rate limits noted in docs (wttr.in limit). If you want extra assurance, run the included tests locally and inspect package.json and any postinstall hooks before enabling the skill.

功能分析

Type: OpenClaw Skill Name: laomo-weather Version: 2.1.0 The laomo-weather skill is a well-documented and feature-complete weather utility that provides current conditions, AQI, pollen data, and lifestyle suggestions using public APIs (wttr.in and Open-Meteo). Analysis of the JavaScript implementation (lib/api.js, lib/client.js) and the auxiliary bash script (weather.sh) shows no evidence of data exfiltration, malicious command execution, or prompt injection. All network requests are directed to legitimate weather service endpoints, and the skill operates entirely within its stated purpose without requesting sensitive permissions or accessing local system secrets.

能力评估

✓ Purpose & Capability

Name/description match the implementation: it uses wttr.in and Open‑Meteo (weather, AQI, pollen, alerts) to produce bilingual output and comparisons. The declared runtime needs (no env vars, curl listed) are broadly consistent with a simple weather CLI.

ℹ Instruction Scope

SKILL.md instructs normal weather queries and shows only calls to public APIs. It does not ask to read unrelated files or secrets. Minor scope/documentation mismatch: examples show a 'weather' CLI and list 'curl' as a required binary, while implementation files indicate a Node CLI (node weather.js / package.json + fetch). The instructions do not request sensitive data.

ℹ Install Mechanism

There is no install spec (instruction-only), which is lower risk, but the skill bundle does include Node source files and package.json — meaning real use likely requires npm install / node runtime. The absence of an explicit install step is a packaging inconsistency you should be aware of, but there are no downloads from untrusted URLs or extract operations in the manifest.

✓ Credentials

No environment variables or credentials are required. All network calls go to public weather/AQI/pollen endpoints (wttr.in, api.open-meteo.*, pollen-api.open-meteo.com). Requesting no secrets is proportionate to the stated purpose.

✓ Persistence & Privilege

always:false and no modifications to other skills or system-wide settings. The skill does not request persistent elevated privileges. Autonomous invocation is allowed by default (platform behavior) but not combined with any other concerning flags here.

版本历史

v2.1.0

Major update: laomo-weather 2.1.0 introduces a fully bilingual, feature-rich, and free weather skill. - Added support for AQI, pollen data, extreme weather alerts, and lifestyle suggestions. - Full Chinese/English output with automatic translation of all weather and air quality terms. - Multi-city comparison and smart city/coordinate recognition. - Uses only free APIs (no keys required), with fallback across wttr.in and Open-Meteo. - New modular architecture and extensive documentation included. - Old metadata removed and updated to new format.

v1.0.0

- Initial release of the weather skill. - Get current weather and forecasts without needing an API key. - Uses wttr.in for quick, formatted weather and forecasts. - Supports Open-Meteo as a fallback, offering JSON output for programmatic use. - No dependencies besides curl.

元数据

Slug laomo-weather

版本 2.1.0

许可证 MIT-0

累计安装 1

当前安装数 1

历史版本数 2

常见问题

Weather 是什么？

老默天气 - 支持 AQI/花粉/预警/生活建议，中英双语输出，多城市对比。v2.1 完全免费 API。它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 238 次。

如何安装 Weather？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install laomo-weather」即可一键安装，无需额外配置。

Weather 是免费的吗？

是的，Weather 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

Weather 支持哪些平台？

Weather 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Weather？

由 mrzhangkris（@mrzhangkris）开发并维护，当前版本 v2.1.0。

Weather