home / skills / openclaw / skills / google-weather

google-weather skill

safe

This skill provides real-time weather data from Google's Weather API for current conditions, forecasts, and hyperlocal insights worldwide.

npx playbooks add skill openclaw/skills --skill google-weather

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

Files (3)

SKILL.md

3.0 KB

---
name: google-weather
description: Google Weather API - accurate, real-time weather data. Get current conditions, temperature, humidity, wind, and forecasts. Powered by Google's Weather API for reliable, hyperlocal data updated every 15 minutes. Supports any location worldwide.
version: 1.2.0
author: Leo 🦁
tags: [weather, google, forecast, temperature, real-time, current-conditions, climate, wind, humidity]
metadata: {"clawdbot":{"emoji":"🌤️","requires":{"env":["GOOGLE_API_KEY"]},"primaryEnv":"GOOGLE_API_KEY","secondaryEnv":["GOOGLE_WEATHER_API_KEY","GOOGLE_MAPS_API_KEY"]}}
allowed-tools: [exec]
---

# Google Weather - Real-time Weather Data

Get accurate weather conditions using Google's Weather API. Requires a Google Cloud API key with Weather API enabled.

## Quick Usage

```bash
# Current weather (formatted output)
python3 skills/google-weather/lib/weather_helper.py current "New York"
python3 skills/google-weather/lib/weather_helper.py current "London"
python3 skills/google-weather/lib/weather_helper.py current "Sydney"

# 24h Forecast
python3 skills/google-weather/lib/weather_helper.py forecast "Tel Aviv"

# Raw JSON data
python3 skills/google-weather/lib/weather_helper.py json "Paris"
```

## Example Output

```
*New York*
Partly Cloudy ⛅
🌡️ 12°C (feels like 10°C)
💨 Wind: 18 km/h NORTHWEST
💧 Humidity: 55%
```

```
*24h Forecast for Tel Aviv*
18:00: 17.8°C, ☀️ 5 km/h NORTH
22:00: 14.3°C, ☀️ 6 km/h EAST_NORTHEAST
02:00: 12.8°C, ⛅ 8 km/h NORTHEAST
06:00: 10.8°C, ☀️ 6 km/h EAST_NORTHEAST
10:00: 16.1°C, ☀️ 5 km/h SOUTH
14:00: 20.4°C, 🌤️ 8 km/h WEST_NORTHWEST
```

## Supported Locations

Any location worldwide - just type the city name:
- `New York`, `London`, `Paris`, `Berlin`, `Sydney`
- `San Francisco`, `Berlin`, `Singapore`, `Dubai`
- Or any address, landmark, or coordinates

The skill automatically geocodes locations using Google Maps API.

## Data Available

- **Temperature**: Current + feels like
- **Conditions**: Clear, cloudy, rain, snow, etc. with emoji icons
- **Forecast**: Hourly data for temperature, wind, and conditions
- **Humidity**: Percentage
- **Wind**: Speed, direction, gusts
- **UV Index**: Sun exposure level
- **Precipitation**: Probability and type
- **Cloud Cover**: Percentage
- **Visibility**: Distance

## Setup

1. Create a project in [Google Cloud Console](https://console.cloud.google.com/)
2. Enable the [Weather API](https://console.cloud.google.com/apis/library/weather.googleapis.com)
3. Enable the [Geocoding API](https://console.cloud.google.com/apis/library/geocoding-backend.googleapis.com) (for location name lookup)
4. Create an API key and set it as `GOOGLE_API_KEY` environment variable

> Also supports `GOOGLE_WEATHER_API_KEY` or `GOOGLE_MAPS_API_KEY` if you already have one configured.

## Multi-language Support

Output adapts to location - supports English, Hebrew, and other languages based on the `language` parameter.

```bash
# Hebrew output
python3 skills/google-weather/lib/weather_helper.py current "Tel Aviv"
# Output: בהיר ☀️ 19°C...
```

Overview

This skill connects to Google’s Weather API to deliver accurate, hyperlocal weather data updated roughly every 15 minutes. It returns current conditions, temperature (including feels-like), humidity, wind details, UV index, precipitation, visibility, and hourly forecasts. The skill geocodes any input (city, address, landmark, or coordinates) using Google Maps and supports language localization.

How this skill works

Provide a location string or coordinates and the skill calls Google Maps geocoding to resolve the place, then queries Google’s Weather API for current conditions and hourly forecasts. Responses are parsed into human-friendly text or raw JSON, with emoji-enhanced condition labels and structured fields like temperature, wind speed/direction, humidity, and precipitation probability. API keys must be set in environment variables (GOOGLE_API_KEY, GOOGLE_WEATHER_API_KEY, or GOOGLE_MAPS_API_KEY).

When to use it

Get a quick current weather summary for any city or coordinate worldwide.
Retrieve an hourly 24-hour forecast for planning outdoor activities or travel.
Embed reliable, frequently updated weather data into bots, dashboards, or automation scripts.
Obtain raw JSON for programmatic processing or integration with other systems.

Best practices

Provision a dedicated Google Cloud project and restrict the API key to the required APIs and IPs for security.
Cache responses short-term (e.g., 10–15 minutes) to reduce API calls while preserving timeliness.
Fallback gracefully: detect geocoding failures and prompt for clarifying location input.
Request raw JSON when you need exact numeric fields; use formatted output for human-facing displays.
Respect rate limits and monitor billing to avoid unexpected charges.

Example use cases

Chatbot weather replies: deliver current conditions and a 24-hour forecast when users ask about a city.
Home automation: trigger cooling/heating rules using feels-like temperature and indoor/outdoor thresholds.
Travel assistant: check hourly forecasts for arrival/departure times and suggest packing items based on precipitation/UV index.
Dashboard widget: display compact, emoji-enhanced current weather and next hours for any monitored location.
Data export: fetch raw JSON for archival, analytics, or combining with other environmental data sources.

FAQ

What API key do I need?

Enable the Weather API and Geocoding API in Google Cloud and set an API key in GOOGLE_API_KEY or GOOGLE_WEATHER_API_KEY/GOOGLE_MAPS_API_KEY environment variables.

Can I get data for any location?

Yes. The skill geocodes cities, addresses, landmarks, or coordinates and supports locations worldwide with localized language output.