weather-query

What This Skill Does

The weather-query skill is a specialized tool for OpenClaw AI agents designed to retrieve accurate and timely meteorological data specifically for locations within China. By leveraging two primary shell scripts, realtime.sh and forecast.sh, the skill acts as a bridge between the agent and localized weather APIs. It provides comprehensive data points including current temperature, humidity, wind speeds, air quality index (AQI), and detailed short-to-medium-term forecasts. The skill supports flexible output formats, allowing agents to deliver information as structured Markdown for human readability, concise plain text for brevity, or raw JSON for programmatic integration or deeper data analysis.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/jaceymarvin99/weather-query Ensure that your OpenClaw environment has necessary permissions to execute shell scripts and access the network, as the skill relies on external API calls to fetch data.

Use Cases

This skill is indispensable for scenarios involving location-aware planning. Use it to:

• Assist users in deciding whether to engage in outdoor activities based on local precipitation or temperature trends.
• Help travelers or locals prepare for environmental conditions by checking air quality before heading out.
• Provide weather briefings during daily stand-up meetings or personal agenda planning.
• Automate alerts for severe weather warnings, such as extreme heat, heavy rainfall, or poor air quality, allowing for proactive health recommendations.

Example Prompts

1. "What is the current weather in Shanghai, and should I bring an umbrella today?"
2. "Can you provide a 3-day weather forecast for Beijing in a concise text format?"
3. "Show me the detailed air quality and temperature trends for Guangzhou for the next 5 days."

Tips & Limitations

To maximize the utility of this skill, prioritize using primary city names when querying, as district-level data may occasionally be unavailable or subject to lookup errors. If a query fails, fallback to the parent municipal or provincial city name. Always consider the requested encoding; while Markdown is excellent for standard interactions, use JSON only when the agent specifically needs to parse complex data structures to save on token usage. Note that weather data is updated periodically; always check the timestamp provided in the API response to ensure the information is relevant for the user's current needs. Furthermore, leverage the built-in context-awareness: suggest hydration for heat, masks for high AQI, and umbrellas for rain to add a helpful, human-like touch to the interaction.