360 Secure SkillHub
360 安全技能中心

OpenWeatherMap Weather

通过 OpenWeatherMap API 按城市名称或经纬度查询当前天气，并读取 5 天/3 小时预报；支持公制、英制与标准单位及多语言描述。需要配置 API Key，结果以文本展示温度、湿度、风速、云量和日出日落等信息。

philiplawlor
philiplawlor
热度 59.87
最近更新 2026-05-11 17:37:44
分类：生活依赖：第三方 API

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add openweathermap
Metadata
name
openweathermap
description
Get current weather data, forecasts, and weather information from OpenWeatherMap API. Use when the user asks about weather, temperature, forecasts, or any weather-related queries for any location. Supports both metric (Celsius, m/s, hPa) and imperial (Fahrenheit, mph, inHg) units. Requires an OpenWeatherMap API key from https://home.openweathermap.org/api_keys
metadata
{"openclaw":{"requires":{"env":["OPENWEATHERMAP_API_KEY"],"files":["~/.openweathermap"]},"primaryEnv":"OPENWEATHERMAP_API_KEY"}}

OpenWeatherMap Weather Skill

Setup

Get your free API key from: https://home.openweathermap.org/api_keys

Store your API key securely (the skill checks these in order):

  1. Environment variable $OPENWEATHERMAP_API_KEY
  2. File ~/.openweathermap (should contain just the API key, one line)
  3. Ask the user for their API key

Current Weather API

By City Name

GET https://api.openweathermap.org/data/2.5/weather?q={city},{country_code}&appid={API_KEY}&units={units}

By Coordinates

GET https://api.openweathermap.org/data/2.5/weather?lat={lat}&lon={lon}&appid={API_KEY}&units={units}

Parameters

Parameter Required Description
appid Yes Your OpenWeatherMap API key
q Yes* City name, state code, country code (e.g., "London,UK" or "Stamford,CT,US")
lat Yes* Latitude
lon Yes* Longitude
units No metric, imperial, or standard. Default: standard
lang No Language code for description (e.g., en, es, fr, de)

Units:

  • metric = Celsius, m/s, hPa
  • imperial = Fahrenheit, mph, hPa (use for US locations)
  • standard = Kelvin, m/s, hPa

Location Tips for US:

  • Use state abbreviation: Stamford,CT,US or full name Stamford,Connecticut,US
  • The API often requires country code for US cities

Example API Calls

London (Metric - Celsius)

curl "https://api.openweathermap.org/data/2.5/weather?q=London,UK&appid=YOUR_API_KEY&units=metric"

Stamford CT (Imperial - Fahrenheit)

curl "https://api.openweathermap.org/data/2.5/weather?q=Stamford,CT,US&appid=YOUR_API_KEY&units=imperial"

By Coordinates

curl "https://api.openweathermap.org/data/2.5/weather?lat=41.05&lon=-73.54&appid=YOUR_API_KEY&units=imperial"

Response Fields

  • main.temp - Temperature (Celsius/Fahrenheit/Kelvin based on units)
  • main.feels_like - Perceived temperature
  • main.humidity - Humidity %
  • main.pressure - Atmospheric pressure (hPa)
  • wind.speed - Wind speed (m/s or mph based on units)
  • wind.deg - Wind direction (degrees)
  • wind.gust - Wind gusts (if available)
  • clouds.all - Cloudiness %
  • weather[0].main - Weather condition (Rain, Snow, Clouds, Clear, etc.)
  • weather[0].description - Detailed description
  • visibility - Visibility in meters
  • sys.sunrise / sys.sunset - Unix timestamps
  • name - Location name
  • timezone - Shift from UTC in seconds

Displaying Weather to User

Use imperial units (Fahrenheit, mph) for US users:

  • Fahrenheit reads naturally to Americans
  • Wind speed in mph is the US standard
  • Convert pressure from hPa to inHg: 1 inHg = 33.86 hPa

24-hour time: Convert Unix timestamps to 24-hour format (e.g., 18:45 instead of 6:45 PM)

Example formatting:

🌡️ Temp: 45°F (feels like 40°F)
💧 Humidity: 65%
💨 Wind: 12 mph NW
🌅 Sunrise: 06:32
🌇 Sunset: 18:45

Forecast API (5 Day / 3 Hour)

GET https://api.openweathermap.org/data/2.5/forecast?q={city}&appid={API_KEY}&units=imperial

Returns forecast data in 3-hour intervals for 5 days.

API Limits

  • Free tier: 60 calls/minute, 1,000,000 calls/month
  • One Call API 3.0 (hourly/daily/minutely forecasts + alerts): requires paid subscription