name: laomo-weather slug: laomo-weather description: "老默天氣 - 支援 AQI/花粉/預警/生活建議，中英雙語輸出，多城市對比。v2.1 完全免費 API。" homepage: https://wttr.in/:help metadata: { "openclaw": { "emoji": "🌤️", "requires": { "bins": ["curl"] } } }

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

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 (基礎功能 - 已完成)

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

📝 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 和限制

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 / 核心元件

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

Language Detection / 語言檢測

1. Check explicit --lang parameter first / 首先檢查顯式 --lang 引數
2. Detect query language (Chinese vs Latin characters) / 檢測查詢語言
3. Fall back to system locale / 回退到系統區域設定
4. 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

小蔥技能有更好的技能skills外掛。

🙏 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！

這個天氣工具功能很豐富，支援空氣質量、花粉指數、生活建議和多城市對比，還能中英文切換，所有資料完全免費不用註冊。介面顯示清晰，文件寫得很詳細。不過程式碼裡有一些bug，特別是多城市對比功能可能有問題，用之前建議先測試一下是否能正常工作。總體質量中上，功能完成度高，但穩定性還需要驗證。