A high-performance weather retrieval skill for fetching real-time meteorological data across China via the Amap Weather API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install weather-search
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install weather-search using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Weather Search?
The Weather Search skill is a specialized tool designed for Openclaw Skills that enables AI agents to query live weather data directly from the Amap (高德地图) Weather API. It provides comprehensive environmental insights, including temperature, wind metrics, and humidity levels, specifically optimized for Chinese geographical locations.
By integrating this skill, developers can empower their AI agents to handle location-aware queries with precision. Whether the user provides a city name, a specific administrative code, or exact longitudinal and latitudinal coordinates, this skill ensures the agent delivers accurate, real-time atmospheric reports.
Weather Search Use Cases
- Real-time weather monitoring for Chinese metropolitan areas and provinces.
- Automating environmental data collection for travel or logistics planning.
- Providing AI-driven local context for users asking about current temperature or wind conditions.
- Batch querying multiple cities to compare regional weather patterns.
How Weather Search Works
- The skill receives a query containing a city name, city code, or GPS coordinates.
- It authenticates with the Amap Web Service using the pre-configured AMAP_API_KEY.
- A structured GET request is sent to the Amap restapi endpoint.
- The skill parses the returned JSON payload to extract 'lives' data, such as weather conditions and report time.
- The formatted meteorological data is returned to the agent or user interface.
Weather Search Setup
To use this feature within Openclaw Skills, you must obtain an API key and configure your environment:
- Register at the Amap Console and create a Web Service Key.
- Set your environment variable:
export AMAP_API_KEY="your_api_key_here"
- Ensure curl is installed on your system as it is a required binary for this skill.
Weather Search Data Schema & Taxonomy
The skill processes data according to the Amap Weather Info schema. Key fields include:
| Field | Description |
|---|---|
| province / city | Geographic identifiers for the query area |
| adcode | Standard administrative division code |
| weather | Current condition (e.g., Clear, Rain, Cloudy) |
| temperature | Current temperature in Celsius |
| winddirection | Direction of the wind |
| humidity | Air humidity percentage |
Weather Search Advanced Features
- Multi-city support: Query multiple locations in a single request using the pipe (
|) delimiter. - Coordinate-based search: Precision querying using latitude and longitude for areas without specific city names.
- JSON/XML output flexibility: Support for multiple data formats to suit different integration needs.
- Scriptable CLI access: Easy integration into automated workflows using local shell scripts.
SKILL.md
Loading
Related Openclaw Skills
Polygon Integration
A powerful integration for accessing Polygon blockchain data, market status, and financial ticker information through the Membrane framework.
Quant Research Platform
A professional-grade quantitative research suite for factor mining, historical backtesting, and sophisticated portfolio optimization.
Hotboard Trending Data Skill
A comprehensive Openclaw Skills integration for fetching real-time trending data and hot lists from multiple global platforms.
n8n Automation Skill
The n8n Automation Skill allows users to trigger complex, multi-step workflows in n8n using natural language commands via an OpenClaw agent.
WeChat Article Fetcher
A professional utility to archive WeChat Official Account articles into local HTML files with full image and media metadata support.
prompt-buttons
A helper skill for AI agents to generate interactive tap-based button menus with seamless fallbacks for non-supported channels.
Featured*
