weather-query

What This Skill Does

The weather-query skill is a specialized OpenClaw agent capability designed to provide accurate, real-time weather data and multi-day forecasts. By integrating with the QWeather API (using JWT authentication), it bypasses the need for generic web searches, ensuring faster and more reliable weather reporting. The skill intelligently parses location data, whether provided as a city name, a specific LocationID, or exact geographic coordinates. It supports a wide range of natural language queries, automatically mapping temporal expressions like "tomorrow" or "next three days" to precise API parameters.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/murphys7017/qweather

Ensure you have configured the necessary environment variables: QWEATHER_API_HOST, QWEATHER_PROJECT_ID, QWEATHER_CREDENTIALS_ID, and QWEATHER_PRIVATE_KEY_PATH. For a seamless user experience, you may also set QWEATHER_DEFAULT_LOCATION to define a preferred city for quick lookups.

Use Cases

This skill is perfect for users who need quick environmental context during their daily workflows. It is ideal for checking local conditions before deciding on outdoor activities, planning travel, or simply staying informed about local climate shifts. By supporting both current weather snapshots and detailed 15-day forecasts, it covers everything from a quick "Should I take an umbrella?" check to detailed weekend trip planning.

Example Prompts

1. "What is the current temperature and humidity in Shanghai right now?"
2. "Will it rain tomorrow in San Francisco? I'm planning to go hiking."
3. "Give me the weather forecast for the next 3 days for my default location."

Tips & Limitations

To get the best results, ensure your environment variables are correctly mapped, especially the private key path for JWT authentication. The skill is optimized for structured data retrieval; if the API call fails, the skill will provide a clear error message directing you to verify your API host and credentials. Avoid using generic web searches for weather, as this skill is purpose-built to handle location resolution and data formatting more effectively. Note that the forecast accuracy is limited to the constraints of the QWeather API service. Always specify the city clearly if the default location is not configured.