home / skills / openclaw / skills / weather

weather skill

safe

This skill provides current weather and forecasts using free services without keys, letting you check conditions quickly.

npx playbooks add skill openclaw/skills --skill weather

Review the files below or copy the command above to add this skill to your agents.

Files (2)

SKILL.md

1.1 KB

---
name: weather
description: Get current weather and forecasts (no API key required).
homepage: https://wttr.in/:help
metadata: {"clawdbot":{"emoji":"🌤️","requires":{"bins":["curl"]}}}
---

# Weather

Two free services, no API keys needed.

## wttr.in (primary)

Quick one-liner:
```bash
curl -s "wttr.in/London?format=3"
# Output: London: ⛅️ +8°C
```

Compact format:
```bash
curl -s "wttr.in/London?format=%l:+%c+%t+%h+%w"
# Output: London: ⛅️ +8°C 71% ↙5km/h
```

Full forecast:
```bash
curl -s "wttr.in/London?T"
```

Format codes: `%c` condition · `%t` temp · `%h` humidity · `%w` wind · `%l` location · `%m` moon

Tips:
- URL-encode spaces: `wttr.in/New+York`
- Airport codes: `wttr.in/JFK`
- Units: `?m` (metric) `?u` (USCS)
- Today only: `?1` · Current only: `?0`
- PNG: `curl -s "wttr.in/Berlin.png" -o /tmp/weather.png`

## Open-Meteo (fallback, JSON)

Free, no key, good for programmatic use:
```bash
curl -s "https://api.open-meteo.com/v1/forecast?latitude=51.5&longitude=-0.12&current_weather=true"
```

Find coordinates for a city, then query. Returns JSON with temp, windspeed, weathercode.

Docs: https://open-meteo.com/en/docs

Overview

This skill provides quick access to current weather and forecasts using two free services that require no API key. It supports human-friendly text output for terminal use and a programmatic JSON fallback for integrations. The focus is speed, simplicity, and low friction for both ad-hoc checks and simple scripts.

How this skill works

By default the skill queries wttr.in for readable terminal output and compact one-line summaries using URL parameters and format codes. For programmatic needs it falls back to Open-Meteo, returning JSON with current weather fields (temperature, wind speed, weather code). You supply a location name, airport code, or coordinates, and the skill constructs the appropriate HTTP request and parses the response.

When to use it

Quick terminal checks for current conditions or a short forecast (wttr.in).
Generating one-line status messages for scripts, prompts, or dashboards.
Embedding weather screenshots as PNGs for chat or reports.
Programmatic retrieval of structured weather data (Open-Meteo JSON).
When you need a free, no-API-key solution for basic weather info.

Best practices

URL-encode multi-word locations (e.g., New+York) or use airport codes for precision.
Use wttr.in format codes for compact display: %c condition, %t temp, %h humidity, %w wind.
Request ?0 for current-only or ?1 for today-only to reduce output size.
For reliable programmatic parsing use Open-Meteo with explicit latitude/longitude and current_weather=true.
Cache results briefly for repeated calls to avoid unnecessary network requests.

Example use cases

Display a one-line weather summary in a shell prompt using curl 'wttr.in/London?format=3'.
Fetch a PNG snapshot of conditions for embedding in a chat or report: wttr.in/City.png
Query Open-Meteo for structured data to feed into automation or a home dashboard.
Generate hourly or daily forecasts by changing wttr.in query parameters or using Open-Meteo endpoints.
Use airport codes like JFK for weather checks at specific airports without geocoding.

FAQ

Do I need an API key?

No. Both wttr.in and Open-Meteo offer free access without API keys.

Which service should I use for scripts?

Use Open-Meteo for structured JSON suitable for parsing; use wttr.in for human-friendly terminal output or image snapshots.