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