{
  "keywords":     ["BTC ETF", "BlackRock", "比特币"],
  "keyword_mode": "any",       // "any" | "all"
  "sources":      ["coindesk", "cointelegraph", "jin10"],
  "poll_interval": 300         // 秒，默认 300
}

市场盯盘技能

两类监控，共享同一套警报数据结构和通知回路：

类型	数据源	状态
价格盯盘	HTTP轮询（Binance/Hyperliquid/OKX/Bitget）+ CoinGecko备用 + pytdx（A股）	✅ 已实现
新闻盯盘

金十数据、华尔街见闻（HTTP轮询）+ CoinDesk/CoinTelegraph/The Block/Decrypt（RSS） | ✅ 已实现 |

---

数据源和精度

价格源

来源	协议	资产	延迟
Binance	HTTP行情（5秒轮询）	任意USDT交易对（动态发现）	~100ms
Hyperliquid

HTTP allMids（5秒轮询） | 全部HL上线资产（动态发现） | ~100ms | | OKX | HTTP行情（5秒轮询） | 任意USDT现货（动态发现） | ~100ms | | Bitget | HTTP行情（5秒轮询） | 任意USDT现货（动态发现） | ~100ms | | pytdx | TCP轮询（盘中4秒） | A股（沪深） | ~200ms | | CoinGecko | HTTP轮询（30秒） | 全资产备用（动态发现） | 30秒 |

动态交易对发现： 守护进程启动时自动从各交易所拉取完整交易对列表，每小时刷新一次。任意USDT交易对的加密货币均自动支持，无需手动添加交易对映射。

资产→交易所优先级（按EXCHANGE_PRIORITY顺序，动态计算每个资产的可用交易所）：

• - 绝大多数主流币：Binance → Hyperliquid → OKX → Bitget → CoinGecko
• HYPE：Hyperliquid → OKX → Bitget → CoinGecko（Binance无HYPEUSDT交易对）
• XAUT：OKX → CoinGecko（地区限制可能影响OKX）
• 任何新上线或长尾币种：自动检查各交易所，无需改代码

新闻源

来源	类型	说明
金十数据	HTTP轮询	⚠️ 非官方接口，格式随时可能变更
华尔街见闻

HTTP轮询 | ⚠️ 非官方接口，同上 | | CoinDesk | RSS 2.0 | 官方RSS源 | | CoinTelegraph | RSS 2.0 | 官方RSS源 | | The Block | RSS 2.0 | 官方RSS源 | | Decrypt | RSS / Atom | 官方RSS源 |

---

警报数据结构

所有警报存入~/.openclaw/agents/{agent}/private/market-alerts.json。

公共字段（所有类型）：
json
{
id: eth-1741234567,
type: price, // price | news
status: active, // active | triggered | cancelled
one_shot: true,
context_summary: ETH减仓窗口：减3.5枚，套出换HYPE,
sessionkey: agent:laok:feishu:direct:ouxxx,
agent_id: laok,
reply_channel: feishu,
replyto: user:ouxxx,
transcript_file: /path/to/session.jsonl,
transcriptmsgid: msg-id,
created_at: 2026-03-12T13:00:00
}

价格类额外字段：
json
{
asset: ETH,
market: crypto, // crypto | astock
condition: >=, // >= | <= | > | <
target_price: 2150
}

新闻类额外字段：
json
{
keywords: [BTC ETF, BlackRock, 比特币],
keyword_mode: any, // any | all
sources: [coindesk, cointelegraph, jin10],
poll_interval: 300 // 秒，默认300
}

---

价格盯盘工作流

设置价格警报

bash
SKILL=$HOME/.openclaw/skills/market-watch/scripts

python3 $SKILL/register-price-alert.py \
--agent laok \
--asset ETH \
--market crypto \
--condition >= \
--target 2150 \
--context-summary ETH减仓窗口：减3.5枚ETH（OKX），套出约$7,500买HYPE \
--session-key agent:laok:feishu:direct:ou_xxx \
--reply-channel feishu \
--reply-to user:ou_xxx

参数说明：

• - --market：crypto（加密）或astock（A股，代码如600519）
• --condition：>= / <= / > / <
• --session-key：用户的当前会话密钥（稳定标识，用于触发时找到正确会话）
• --reply-to：飞书通知目标，格式user:ou_xxx
• --transcript-msg-id：推荐填入当前对话的消息ID（触发时用于追溯设盘上下文）。代理在注册警报时应传入当前消息的ID，否则触发通知中「消息ID」字段将为空，无法精准跳转到设盘时的对话记录。

---

新闻盯盘工作流

设置新闻关键词警报

bash

基础用法：监控任一关键词命中

python3 $SKILL/register-news-alert.py \
--agent laok \
--keywords BTC ETF,BlackRock,ETF通过 \
--keyword-mode any \
--context-summary 盯ETF审批进展，可能触发价格上涨 \
--session-key agent:laok:feishu:direct:ou_xxx \
--reply-channel feishu \
--reply-to user:ou_xxx

一次性警报（发现即停，适合等待明确事件）

python3 $SKILL/register-news-alert.py \ --agent laok \ --keywords 停火,ceasefire,Iran deal \ --one-shot \ --context-summary 等停火消息，判断是否影响风险资产

仅监控特定来源

python3 $SKILL/register-news-alert.py \ --agent laok \ --keywords HYPE,Hyperliquid \ --sources coindesk,cointelegraph,theblock,decrypt

全部命中模式（需要所有关键词同时出现在同一条新闻中）

python3 $SKILL/register-news-alert.py \ --agent laok \ --keywords BTC,ETF,SEC \ --keyword-mode all

参数说明：

• - --keywords：关键词，逗号分隔（支持中英文）
• --keyword-mode：any（任一命中）| all（全部命中），默认any
• --sources：数据源，逗号分隔，可选：jin10, wallstreetcn, coindesk, cointelegraph, theblock, decrypt（默认全部）
• --poll-interval：轮询间隔（秒），默认300（5分钟）
• --one-shot：触发一次后自动停止（新闻警报默认持续监控）

---

守护进程管理

bash
DAEMON=$HOME/.openclaw/skills/market-watch/scripts/daemon.sh

bash $DAEMON start # 按需启动（检查活跃警报类型，只启动需要的进程）
bash $DAEMON stop # 停止两个进程
bash $DAEMON restart # 重启
bash $DAEMON status # 状态 + 活跃警报列表
bash $DAEMON log # 两个进程的最近40行日志
bash $DAEMON log --lines 100 # 更多日志

文件路径：

• - 价格进程PID：/tmp/market-watch-{agent}-price.pid
• 新闻进程PID：/tmp/market-watch-{agent}-news.pid
• 价格日志：/tmp/market-watch-{agent}.log
• 新闻日志：/tmp/market-watch-{agent}-news.log
• 警报数据：~/.openclaw/agents/{agent}/private/market-alerts.json
• 新闻去重：~/.openclaw/agents/{agent}/private/news-monitor-state.json

---

查看和取消警报

bash
python3 $SK