天气交易（增强版）

重要警告：自主交易能力

启用后，本能力将使用真实资金执行真实交易。

关键信息：

• 默认状态：autostart:false — 不会自动运行
• 自主行为：手动启用后，每 6 小时运行一次
• 财务风险：日均部署资金约 $30–$60（启用质量过滤器后最高 $100/天）
• 无逐笔审核：交易自动执行，无需人工批准

安装与安全

凭据

必需：

• SIMMER_API_KEY — 来自 simmer.markets/dashboard 的交易 API 密钥

可选（非敏感配置）：

• 6 个 SIMMER_WEATHER_* 环境变量，用于配置交易参数（参见“配置”章节）

无需其他凭据（不涉及钱包私钥、RPC 端点或云服务凭证）。

可选依赖项：若安装 tradejournal，将记录交易详情。该依赖项默认未安装，请在安装前检查其源码。

安装方式

• 手动安装（无自动化脚本）
• 将文件放入 ~/.openclaw/skills/weather-enhanced/
• 创建包含 API 密钥的 .env 文件
• 不执行任何自动系统写入操作

依赖项

python-dotenv>=1.0.0  # 可选

精简依赖列表：

• 使用内置 urllib（不依赖 requests 库）
• 不依赖 web3、Telegram Bot 或其他未使用的库
• 可选：tradejournal 用于交易日志（在 requirements.txt 中已注释掉）

网络端点

本能力连接以下 3 个端点：

1. api.weather.gov（NOAA）

   • 用途：获取温度预报数据
   • 发送数据：经纬度（公开坐标）
   • 接收数据：天气预报（公开数据）
   • 认证方式：无需认证
   • 代码位置：weather_trader_enhanced.py 第 250–280 行左右

2. nominatim.openstreetmap.org（地理编码）

   • 用途：将城市名称转换为经纬度坐标
   • 发送数据：城市名称字符串（例如 "Chicago"）
   • 接收数据：经纬度坐标
   • 认证方式：无需认证
   • 代码位置：weather_trader_enhanced.py 第 200–230 行左右

3. api.simmer.markets（交易）

   • 用途：执行交易、读取投资组合
   • 发送数据：SIMMER_API_KEY（Bearer Token）、交易指令
   • 接收数据：交易确认、持仓、余额
   • 认证方式：Bearer Token
   • 代码位置：weather_trader_enhanced.py 第 300–350 行左右

注意：若安装了可选依赖 tradejournal，可能引入额外端点。

安全保证

• 代码中无其他网络连接
• API 密钥绝不会写入磁盘或打印至控制台
• API 密钥仅发送至 api.simmer.markets
• 无追踪、分析或遥测功能
• 无数据外泄行为
• 所有网络调用均在源码中可见（可用 grep 验证）

API 密钥权限

您的 SIMMER_API_KEY 应具备以下权限：

• 读取投资组合（必需）
• 读取持仓（必需）
• 下单交易（必需）
• 禁止提现权限
• 禁止修改账户权限

请创建最小权限密钥：

1. 访问 simmer.markets/dashboard → SDK 标签页
2. 创建新 API 密钥
3. 如提供选项，请选择 “Trading Only”（仅限交易）
4. 切勿授予提现权限
5. 将密钥存于 .env 文件中（已设置 git 忽略）
6. 测试完成后轮换密钥

配置存储

• .env 文件：仅存放 SIMMER_API_KEY（永不提交至版本控制）
• config.json：仅存放交易参数（不含任何密钥）
• 无持久化日志
• 所有数据均为临时性（仅输出至控制台）

注意：.env 中遗留的 WALLET_PRIVATE_KEY 和 POLYGON_RPC_URL 变量已弃用（web3 已移除）。

安全特性

• 默认禁用 autostart — 必须手动启用
• 质量过滤器（60%）— 跳过低流动性市场
• 单笔头寸限额（$5）— 控制单笔交易风险
• 交易限额（5 笔/次）— 每 6 小时最多执行 5 笔交易
• 入场阈值（15%）— 仅买入被低估的市场
• 离场阈值（45%）— 利润达标后自动卖出

启用前必做事项

请勿跳过以下步骤

1. 审查源码

# 查看核心交易逻辑
cat weather_trader_enhanced.py | less

# 验证网络端点（应仅匹配 3 处）
grep -n "urlopen|Request|http" weather_trader_enhanced.py

# 检查 API 密钥使用（应仅发送至 simmer.markets）
grep -n "api_key|SIMMER_API_KEY" weather_trader_enhanced.py

# 检查可选 tradejournal 使用情况
grep -n "tradejournal|log_trade" weather_trader_enhanced.py

2. 理解平台行为

OpenClaw 元数据控制项：

• autostart:false = 启动时不运行该能力（安全默认值）
• cron:"0 */6 * * *" = 执行计划（仅在 autostart 启用后生效）
• 通过编辑第 5 行，将 autostart:false 改为 autostart:true 即可启用
• 请参考 OpenClaw 文档验证此方法：https://docs.openclaw.ai/
• 手动编辑文件可防止意外激活
• 替代方案：不启用 autostart，手动运行

启用后：每 6 小时运行一次（凌晨 0 点、早上 6 点、中午 12 点、晚上 6 点）
禁用后：完全不运行

3. 验证 API 密钥权限

检查您的 Simmer API 密钥：

• 是否可读取投资组合？（必需）
• 是否可下单交易？（必需）
• 是否可提现资金？（应为否）
• 是否可修改账户？（应为否）

若密钥具备提现权限，请创建新的仅限交易密钥。

4. 实盘交易测试

# 先查询余额
python scripts/status.py

# 执行实盘交易（建议从小额开始）
python weather_trader_enhanced.py --live --smart-sizing

• 在 simmer.markets/dashboard 上密切监控
• 确认交易正确执行
• 等待头寸结算（通常需 1–3 天）
• 分析结果

5. 启用自主交易（可选）

仅在成功完成手动测试后进行。

OpenClaw 使用基于元数据的启用机制：

• 通过 SKILL.md 中的 autostart 字段启用能力
• 请结合 OpenClaw 文档或平台 UI 进行验证
• 手动编辑可防止意外激活

步骤：

1. 编辑 SKILL.md 第 5 行（元数据行）
2. 将 "autostart":false 改为 "autostart":true
3. 保存文件
4. 重启：openclaw restart
5. 查看日志确认定时任务已启动

仅手动运行（替代方案）：

python weather_trader_enhanced.py --live --smart-sizing

此方式可完全掌控交易执行时机。

快速入门

# 查询余额
python scripts/status.py

# 执行实盘交易
python weather_trader_enhanced.py --live --smart-sizing

# 可选：测试用空跑模式
python weather_trader_enhanced.py --dry-run

运行要求

• 从 simmer.markets/dashboard → SDK 标签页获取 SIMMER_API_KEY
• Simmer 钱包中需有 USDC 余额

配置

可通过环境变量或 config.json 进行配置：

特性

• 动态置信度 — 根据预报提前期在 60–90% 区间动态调整
• 市场质量评分 — 过滤低流动性市场
• 智能地理编码 — 支持任意美国城市
• 增强解析能力 — 更精准识别温度区间
• 重试机制 — 自动恢复因 API 故障导致的失败

命令

# 实盘交易
python weather_trader_enhanced.py --live --smart-sizing

# 查询持仓
python weather_trader_enhanced.py --positions

# 查看当前配置
python weather_trader_enhanced.py --config

# 设置配置项
python weather_trader_enhanced.py --set entry_threshold=0.20

# 可选：测试用空跑模式
python weather_trader_enhanced.py --dry-run

工作原理

1. 从 NOAA 获取目标城市的天气预报
2. 通过 Simmer API 发现相关天气预测市场
3. 使用动态置信度模型计算交易优势（根据预报时间在 60–90% 区间调整）
4. 按质量分（流动性、成交量、到期时间等）筛选市场
5. 当市场价格低于入场阈值时执行买入
6. 当市场价格高于离场阈值时自动卖出

动态置信度随预报提前期变化：

• 当日预报：90%
• 提前 1 天：88%
• 提前 2 天：85%
• 提前 3 天：80%
• 提前 7 天及以上：60%

市场质量评分权重：

• 流动性（40%）
• 成交量（30%）
• 距离结算时间（20%）
• 价格极端程度（10%）

仅交易质量分 ≥ 60% 的市场。

故障排查

"SIMMER_API_KEY not set"
请设置环境变量或在 .env 文件中添加

"No weather markets found"
Polymarket 上暂无活跃天气市场时属正常现象

"Position size too small"
请增大 max_position_usd 值，或使用 --smart-sizing 参数

"Quality score too low"
市场因流动性/成交量不足被过滤

安全检查清单

安装前请确认以下各项：

代码审查

• 已审阅 weather_trader_enhanced.py 源码
• 已确认仅存在 3 个网络端点（NOAA、Nominatim、Simmer）
• 已确认 API 密钥仅发送至 api.simmer.markets
• 无可疑代码或混淆逻辑

依赖项

• 已确认 requirements.txt 中仅有 python-dotenv>=1.0.0
• 无冗余依赖（web3、Telegram、requests 已移除）
• 使用内置 urllib 处理 HTTP 请求
• 若安装 tradejournal，已预先检查其源码

配置

• 已确认 SKILL.md 第 5 行为 autostart:false
• 已通过 OpenClaw 文档/UI 验证启用方式
• 已掌握禁用方法
• 已审阅头寸限额（单笔最高 $5）

API 密钥配置

• 已创建最小权限 Simmer API 密钥
• 密钥不含提现权限
• 密钥存于本地 .env 文件中（永不提交）
• 明确知晓密钥具有读取投资组合和下单权限

测试

• 已成功运行 python scripts/status.py
• 已使用 --live 参数以小额资金执行手动交易
• 已在 simmer.markets/dashboard 上监控交易
• 已充分理解自主运行行为
• 可选：已先用 --dry-run 测试

风险认知

• 已理解自主交易风险
• 已知悉日均最大资金部署量（约 $30–$60，上限 $100）
• 已接受无逐笔人工审批机制
• 已掌握停止方法（通过 OpenClaw 禁用或编辑 SKILL.md）
• 已从小额资金起步（$50–$100）

平台行为

• 已确认 OpenClaw 尊重 autostart:false 设置
• 已明确该能力仅在手动启用后才运行
• 已理解 cron 计划（启用后每 6 小时执行一次）
• 已掌握查看 OpenClaw 日志的方法

若任一复选框未勾选，请勿启用本能力。

紧急停止

如需立即停止：

# 方案 1：通过 OpenClaw UI 禁用

# 方案 2：编辑 SKILL.md
# 修改第 5 行："autostart":false
# 然后执行：openclaw restart

# 方案 3：彻底停止 OpenClaw
openclaw stop

# 在 simmer.markets/dashboard 上手动平仓

支持

源码位于 weather_trader_enhanced.py
所有网络调用均在此文件中明确记录
无隐藏功能或代码混淆

使用风险自负。本能力将执行真实资金交易。
使用前请充分理解预测市场及交易相关风险。