Shuzhi Weather

---

name: shuzhi-weather description: This skill should be used when users need to query weather information via the Shuzhi Weather API with HMAC-SHA256 authentication. It provides hourly weather forecasts based on latitude and longitude coordinates. Users must configure app_key and app_secret in ~/.openclaw/skills/shuzhi-weather/config.json before using this skill.

---

Shuzhi Weather Skill

This skill enables querying weather forecasts using the Shuzhi Weather API with HMAC-SHA256 authentication, providing hourly weather data for any location.

Configuration Requirements

IMPORTANT: Before using this skill, you must configure your API credentials:

Create the configuration file at ~/.openclaw/skills/shuzhi-weather/config.json with the following content:

{
  "app_key": "your_app_key_here",
  "app_secret": "your_app_secret_here"
}

Replace your_app_key_here and your_app_secret_here with your actual Shuzhi API credentials.

Configuration Priority

The skill follows this configuration priority order: 1. User's config.json at ~/.openclaw/skills/shuzhi-weather/config.json (highest priority) 2. Platform environment variables (if available) 3. Default values (if any exist)

When to Use This Skill

Activate this skill when:

Users ask for weather forecasts or weather information

Users inquire about temperatures at specific locations

Users mention weather-related queries that require current or future data

Users provide location names and expect weather details

Skill Components

Scripts

The scripts/get_weather.py script provides a reliable way to fetch weather data from the Shuzhi Weather API with HMAC-SHA256 authentication. This script:

Loads credentials from the user's config.json file

Generates dual HMAC-SHA256 signatures (URL signature + body signature)

Makes authenticated POST requests to the Shuzhi API

Returns structured weather data including hourly temperatures

References

The references/api_response_format.md contains documentation about the Shuzhi Weather API, including:

Request parameters (longitude, latitude, hourly data types)

Response format and field meanings

HMAC-SHA256 authentication mechanism

Error handling and response codes

Workflow

When this skill is activated:

1. Check configuration - Verify that ~/.openclaw/skills/shuzhi-weather/config.json exists and contains valid credentials. If not, prompt the user to configure it.

2. Extract location information from the user's query. This may include: - City names (e.g., "Beijing", "Shanghai", "Guangzhou") - Specific coordinates (latitude, longitude) - Descriptive locations

3. Convert location to coordinates: - If city name is provided, use geocoding to get latitude and longitude - If coordinates are provided directly, use them as-is - Common city coordinates: Beijing (39.9042, 116.4074), Shanghai (31.2304, 121.4737), Guangzhou (23.1291, 113.2644)

4. Execute the weather script using the coordinates: - Run scripts/get_weather.py with longitude and latitude parameters - The script loads credentials from config.json - Returns structured weather data including hourly temperatures

5. Present results to the user in a natural, readable format: - Summarize key information (current temperature, high/low, forecast) - Include relevant time information (next 24 hours or specific times mentioned) - Use units appropriate to the context (Celsius by default)

Important Notes

The Shuzhi Weather API requires HMAC-SHA256 authentication with dual signatures

Credentials must be configured in ~/.openclaw/skills/shuzhi-weather/config.json before use

Coordinate format: longitude first, then latitude

The API endpoint uses POST method with JSON body

Response code 200 indicates success

If credentials are missing or invalid, inform the user to check their config.json file

Example Interactions

User: "What's the weather like in Beijing?" Action: Check config exists, extract "Beijing", use coordinates (39.9042, 116.4074), run script, present forecast

User: "Will it be cold in Shanghai tomorrow?" Action: Extract "Shanghai" and "tomorrow", use coordinates (31.2304, 121.4737), run script, present tomorrow's temperature

User: "Get the temperature for longitude 116.4074 and latitude 39.9042" Action: Use provided coordinates directly, run script, present hourly data

User: "How hot will it be in Guangzhou today?" Action: Extract "Guangzhou", use coordinates (23.1291, 113.2644), run script, identify maximum temperature for today

Error Handling

If configuration is missing:

Inform the user that credentials need to be configured

Provide instructions on creating ~/.openclaw/skills/shuzhi-weather/config.json

Show the required JSON format

If API request fails:

Check if credentials are valid

Verify network connectivity

Display error message from the API response

Suggest checking the configuration file