---

name: crypto-monitor description: | 定期巡检加密货币行情，通过 CoinGecko API 获取 BTC、ETH、LTC 的实时价格（USD/CNY） 和 24h 涨跌幅。涨跌幅超过阈值时推送行情摘要，全部正常时回复 HEARTBEAT_OK。 支持 /crypto-monitor 斜杠命令触发，也可通过自然语言触发（如"帮我看一下 BTC 行情"、 "加密货币价格怎么样"、"crypto price check"）。 配合 Cron 定时任务实现自动巡检。 metadata: openclaw: requires: env: - COINGECKO_API_KEY - MONITOR_THRESHOLD_PERCENT bins: - curl - jq

crypto-monitor — 加密货币行情巡检

环境变量

变量名	必需	默认值	说明
COINGECKO_API_KEY	✅	—	CoinGecko Demo API Key（CG- 开头）
MONITOR_THRESHOLD_PERCENT	❌	3	涨跌幅告警阈值（百分比）

执行步骤

1. 环境检查

读取环境变量，确认 COINGECKO_API_KEY 已配置。若为空则报错并终止。 MONITOR_THRESHOLD_PERCENT 未设置时使用默认值 3。

2. 调用 CoinGecko API

获取 BTC、ETH、LTC 的实时行情数据：

curl -s "https://api.coingecko.com/api/v3/simple/price?\
ids=bitcoin,ethereum,litecoin&\
vs_currencies=usd,cny&\
include_24hr_change=true&\
x_cg_demo_api_key=${COINGECKO_API_KEY}"

3. 解析数据

用 jq 提取每个币种的：

• USD 价格（usd）
• CNY 价格（cny）
• 24h USD 涨跌幅（usd_24h_change）

4. 阈值判断

对每个币种，检查 |usd_24h_change| 是否超过 MONITOR_THRESHOLD_PERCENT：

• 超过阈值 → 标记为异动币种，纳入行情摘要
• 未超过 → 标记为正常

5. 输出结果

根据判断结果选择输出格式（见下方"输出格式"部分）。

异常处理

超时 / 网络错误

• API 调用失败时，等待 10 秒 后重试 1 次
• 仍然失败则报告：❌ CoinGecko API 调用失败: [HTTP 状态码 / 错误信息]

限流（HTTP 429）

• 收到 429 响应时，等待 60 秒 后重试
• 仍返回 429 则报告：⚠️ CoinGecko API 限流，请等待后重试（Demo 计划限制 30 calls/min）

数据异常

• 返回 JSON 中缺少预期字段时，报告具体缺失内容
• 价格为 0 或负数时标记为异常数据

输出格式

有超阈值币种时

📊 加密货币行情巡检报告

⚠️ 异动币种：
- BTC：$103,200 / ¥752,300（24h +5.2% ⬆️ 超过阈值 3%）

✅ 正常币种：
- ETH：$2,650 / ¥19,300（24h -1.1%）
- LTC：$87 / ¥634（24h +0.8%）

📋 阈值设置：±3%
⏰ 检查时间：2024-01-01 12:00 UTC

全部在阈值内时

HEARTBEAT_OK

停止条件

• 全部币种涨跌幅在阈值范围内 → 输出 HEARTBEAT_OK，任务完成
• 有币种超过阈值 → 输出行情摘要，任务完成
• API 多次失败 → 输出错误报告，任务完成

Cron 定时配置

推荐通过飞书 DM 让 Agent 创建 cron 任务：

请帮我创建一个 cron 定时任务：
- 任务名称：crypto-check
- 执行频率：每 4 小时
- 执行内容：调用 crypto-monitor Skill

对应 crontab 配置：0 */4 * * * openclaw run crypto-monitor