Tempest Weather:WeatherFlow 气象站实时数据 - Openclaw Skills

作者:互联网

2026-03-29

AI教程

什么是 Tempest Weather?

Tempest Weather 技能通过 Tempest REST API 实现了 AI 代理与 WeatherFlow 硬件之间的无缝集成。通过在 Openclaw Skills 生态系统中使用此工具,开发者可以让代理获取精确的本地环境数据,包括风速、降雨量和雷击。无论是用于家庭自动化还是数据记录,此技能都为获取后院气象站指标提供了稳固的桥梁。它处理从当前状况到历史趋势分析的一切,为超本地化气象智能提供技术基础。

下载入口:https://github.com/openclaw/skills/tree/main/skills/wranglerdriver/tempest-weather

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install tempest-weather

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 tempest-weather。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

Tempest Weather 应用场景

  • 获取当前的风速、阵风和降雨数据,用于本地活动规划。
  • 使用每日、每月或每年的气象站统计数据审计历史天气模式。
  • 监控后院环境状况,用于智能家居自动化触发器。
  • 基于个人传感器数据为特定地理位置生成简明的天气摘要。
Tempest Weather 工作原理
  1. 用户或代理使用特定关键词(如 tempest weather 或 backyard weather)触发技能。
  2. 脚本使用提供的 TEMPEST_API_TOKEN 与 WeatherFlow REST API 进行身份验证。
  3. 根据配置中提供的站 ID 或特定设备 ID 获取数据。
  4. 技能处理原始 API 响应,根据要求应用单位转换(公制或美制)。
  5. 向代理返回一个简明的 JSON 对象和可选的人类可读摘要以供处理。

Tempest Weather 配置指南

要将其集成到您的 Openclaw Skills 集合中,请设置以下环境变量:

export TEMPEST_API_TOKEN="your_token_here"
export TEMPEST_STATION_ID="your_station_id"
export TEMPEST_DEVICE_ID="your_device_id"
export TEMPEST_UNITS="us" # 或 "metric"

使用 Python 运行获取脚本:

python3 scripts/get_tempest_weather.py

Tempest Weather 数据架构与分类体系

该技能主要通过包含观测值和历史记录的 JSON 输出组织数据。以下是返回数据结构的映射:

字段 描述
observations 来自设备的当前实时传感器读数。
stats 来自 stats_day、stats_month 或 stats_year 的历史行。
source_url 指向 Tempest API 源的可追溯性链接。
timestamp 数据采集的 ISO 格式时间。
name: tempest-weather
description: Get current weather conditions from a WeatherFlow Tempest station using the Tempest REST API. Use when the user asks for "tempest weather" (preferred trigger), or asks for backyard/home weather, Tempest station readings, wind/gust/rain/lightning from a specific station, or quick local weather summaries sourced from Tempest data.
license: MIT
metadata:
  openclaw:
    requires:
      env:
        - TEMPEST_API_TOKEN
        - TEMPEST_STATION_ID
        - TEMPEST_DEVICE_ID
        - TEMPEST_UNITS
      anyBins:
        - python3
    primaryEnv: TEMPEST_API_TOKEN
    homepage: https://github.com/wranglerdriver/tempest-weather

Tempest Weather

Use this skill to fetch current conditions from a Tempest station/device or retrieve historical station statistics (day/month/year) from the Tempest Stats API.

Run the fetch script

Use:

python3 scripts/get_tempest_weather.py

The script reads configuration from environment variables by default, if both station and device id are set device_id is used by default:

  • TEMPEST_API_TOKEN (required)
  • TEMPEST_STATION_ID (optional if TEMPEST_DEVICE_ID is set)
  • TEMPEST_DEVICE_ID (optional if TEMPEST_STATION_ID is set)
  • TEMPEST_UNITS (optional: metric or us, default us)

Useful command options

# Explicit station/token (current observations)
python3 scripts/get_tempest_weather.py --station-id 12345 --token "$TEMPEST_API_TOKEN"

# Explicit device/token (current observations)
python3 scripts/get_tempest_weather.py --device-id 67890 --token "$TEMPEST_API_TOKEN"

# Historical stats for current local day/month/year (defaults to "now")
python3 scripts/get_tempest_weather.py --stats day
python3 scripts/get_tempest_weather.py --stats month
python3 scripts/get_tempest_weather.py --stats year

# Historical stats for a specific target date period
python3 scripts/get_tempest_weather.py --stats day --date 2026-02-23
python3 scripts/get_tempest_weather.py --stats month --date 2026-02
python3 scripts/get_tempest_weather.py --stats year --date 2025

# Metric output
python3 scripts/get_tempest_weather.py --units metric

# JSON only (machine-friendly)
python3 scripts/get_tempest_weather.py --json

Output behavior

  • Emit concise JSON (always)
  • Include a short human summary unless --json is used
  • Include timestamp and source URL for traceability
  • For --stats, return the matched historical row from stats_day, stats_month, or stats_year

If data fetch fails

  • Check token validity and station/device ID
  • Retry once for transient network errors
  • Return a short actionable error message

Field mapping reference

For Tempest observation index mapping and response notes, read:

  • references/tempest-api.md

License

  • LICENSE (MIT)

Source

  • https://github.com/wranglerdriver/tempest-weather