← Back to Skills Marketplace
229
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install knowair-historical
Description
Get historical weather data up to 72 hours back via the Caiyun Weather API. Returns past temperature, weather conditions, precipitation, wind, humidity, appa...
README (SKILL.md)
KnowAir Historical — Past Weather Data
Query historical weather data for up to 72 hours back using the Caiyun Weather API.
Prerequisites
- A valid Caiyun Weather API token set as
CAIYUN_TOKENenvironment variable, or stored in~/.config/knowair/token. - Coordinates (longitude, latitude) for the target location.
Quick Start
python3 scripts/query_historical.py --lng 116.3176 --lat 39.9760 --hours 24
Workflow
- Resolve coordinates — convert city name to coordinates if needed.
- Run the script:
python3 scripts/query_historical.py --lng \x3CLNG> --lat \x3CLAT> --hours \x3CHOURS> - Present results — summarize temperature range, weather changes, and notable events in the past period.
Options
| Flag | Description | Default |
|---|---|---|
--lng |
Longitude (-180 to 180) | Required |
--lat |
Latitude (-90 to 90) | Required |
--hours |
Hours to look back (1-72) | 24 |
--lang |
Output language: en or zh |
en |
Defaults
- Hours back: 24
- Language:
en
Failure Handling
- Missing token → exit code 2 with setup instructions.
- API error → exit code 1 with error details.
Usage Guidance
This skill appears to do exactly what it says: call the Caiyun Weather API and format recent historical data. Before installing, be aware that you must provide a CAIYUN_TOKEN (sensitive API token) either as the CAIYUN_TOKEN environment variable or in ~/.config/knowair/token; only provide a token you trust to this skill. Ensure your environment allows outbound HTTPS to api.caiyunapp.com and that the token is from Caiyun. If you have concerns, inspect the included scripts yourself (they are small and human-readable) before use.
Capability Analysis
Type: OpenClaw Skill
Name: knowair-historical
Version: 1.0.0
The skill is a legitimate tool for fetching historical weather data from the Caiyun Weather API. The Python script (scripts/query_historical.py) correctly handles API token retrieval from environment variables or a local config file and performs standard HTTP requests using the built-in urllib library without any signs of malicious intent, data exfiltration, or command injection.
Capability Assessment
Purpose & Capability
Name/description match the included Python script and required CAIYUN_TOKEN; requiring python3 and an API token is appropriate for querying Caiyun's historical weather API.
Instruction Scope
SKILL.md and the script are scoped to resolving coordinates, reading the token (env or ~/.config/knowair/token), calling the Caiyun API, formatting results, and printing JSON. It does not access other system files or external endpoints beyond the Caiyun API.
Install Mechanism
No install spec (instruction-only) and a single Python script; nothing is downloaded or written during install, so install risk is minimal.
Credentials
Only a single credential (CAIYUN_TOKEN) is required, which is appropriate for the external API. The script also optionally reads a local token file as documented; no other env vars or secrets are accessed.
Persistence & Privilege
Skill is not always-enabled and does not modify other skills or system configuration. It runs on demand and does not request elevated persistence.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install knowair-historical - After installation, invoke the skill by name or use
/knowair-historical - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of KnowAir Historical: fetch up to 72 hours of past weather data using the Caiyun Weather API.
- Returns past temperature, weather conditions, precipitation, wind, humidity, apparent temperature, and air quality at regular intervals.
- Supports queries for specific coordinates and customizable lookback periods (1–72 hours).
- Requires a CAIYUN_TOKEN environment variable and internet access.
- Clear error handling for missing tokens and API failures.
Metadata
Frequently Asked Questions
What is KnowAir Historical 明气历史天气?
Get historical weather data up to 72 hours back via the Caiyun Weather API. Returns past temperature, weather conditions, precipitation, wind, humidity, appa... It is an AI Agent Skill for Claude Code / OpenClaw, with 229 downloads so far.
How do I install KnowAir Historical 明气历史天气?
Run "/install knowair-historical" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is KnowAir Historical 明气历史天气 free?
Yes, KnowAir Historical 明气历史天气 is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does KnowAir Historical 明气历史天气 support?
KnowAir Historical 明气历史天气 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created KnowAir Historical 明气历史天气?
It is built and maintained by Shuo Wang (@shuowang-ai); the current version is v1.0.0.
More Skills