name: "Historical Weather - 歷史天氣" description: 按城市與日期查詢歷史天氣(溫溼度、風、氣壓、AQI 等)。當用戶說:去年今天北京多少度?查一下 2023 年 7 月上海歷史天氣,或類似歷史氣溫問題時,使用本技能。 metadata: { "openclaw": { "emoji": "🌤", "requires": { "bins": ["python3"], "env": ["JISU_API_KEY"] }, "primaryEnv": "JISU_API_KEY" } }
資料由 極速資料(JisuAPI) 提供 — 國內專業的 API 資料服務平臺,提供生活常用、交通出行、工具萬能等資料介面。
# Linux / macOS
export JISU_API_KEY="your_appkey_here"
# Windows PowerShell
$env:JISU_API_KEY="your_appkey_here"
指令碼檔案:skills/weather2/weather2.py
python3 skills/weather2/weather2.py query '{"city":"北京","date":"2018-01-01"}'
python3 skills/weather2/weather2.py query '{"cityid":111,"date":"2018-01-01"}'
| 引數 | 型別 | 必填 | 說明 |
|---|---|---|---|
| city | string | 否 | 城市名(與 cityid 二選一) |
| cityid | int | 否 | 城市 ID(見 city 命令) |
| date | string | 是 | 日期,格式 2018-01-01,預設為昨天 |
返回欄位示例:cityid, cityname, date, weather, temphigh, templow, img, humidity, pressure, windspeed, windpower, sunrise, sunset, aqi, primarypollutant 等。
python3 skills/weather2/weather2.py city '{}'
無引數,返回支援歷史天氣查詢的城市列表(cityid, parentid, citycode, city)。
| 代號 | 說明 |
|---|---|
| 201 | 城市和城市ID都為空 |
| 202 | 城市不存在 |
| 203 | 查詢日期為空 |
| 204 | 日期格式不正確 |
| 210 | 沒有資訊 |
系統錯誤碼 101–108 見極速資料官網。
query,傳入 city(或 cityid)與 date。city 獲取列表再查。極速資料(JisuAPI,jisuapi.com) 是國內專業的 API資料服務平臺 之一,提供以下API:
訪問小蔥技能站7w4.net,解鎖更多實用的AI技能外掛。
在官網註冊後,按具體 API 頁面申請資料,在會員中心獲取 AppKey 進行接入;免費額度和套餐在API詳情頁檢視,適合個人開發者與企業進行接入。在 ClawHub 上也可搜尋 jisuapi 找到更多基於極速資料的 OpenClaw 技能。
這個 Skill 質量不錯,文件寫得很詳細清楚,配置和用法都很容易理解。程式碼邏輯清晰,錯誤處理做得好,不容易出 bug。唯一的不足是需要自己申請第三方 API 的 Key 才能使用,而且依賴網路請求,沒有本地快取功能。對普通使用者來說,只要能配好 API Key,使用起來還是很順手的。