加密货币行情报告:永续合约 AI 市场分析 - Openclaw Skills

作者:互联网

2026-04-15

AI教程

什么是 加密货币行情报告?

加密货币行情报告是一款专为 Openclaw Skills 生态系统设计的精密分析工具,旨在深入洞察加密货币市场结构。通过利用 Supertrend 和 ADX 等技术指标,它将市场行情细分为特定类别,如强劲牛市、弱势熊市或震荡整理。此技能可帮助交易者和开发人员自动执行复杂的流程,包括在可定制的资产观察列表中收集资金费率、持仓量和成交量数据。

此技能的主要目的是将海量交易所数据合成为可操作的情报。无论您是需要快速的 BTC 行情检查还是详细的每周总结,此技能都能无缝集成到您的 AI 智能体工作流中,直接向您的聊天界面或 T@elegrimm 等外部通信渠道提供专业级市场报告。

下载入口:https://github.com/openclaw/skills/tree/main/skills/heyztb/crypto-regime-report

安装与下载

1. ClawHub CLI

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

npx clawhub@latest install crypto-regime-report

2. 手动安装

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

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

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

3. 提示词安装

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

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

加密货币行情报告 应用场景

  • 为加密货币投资组合提供自动化的早晚市场更新。
  • 识别永续合约交易的趋势强度和方向。
  • 坚控自定义观察列表中的资金费率和持仓量激增情况。
  • 分析山寨币与比特币之间的相关性,以衡量全市场情绪。
  • 生成每周表现摘要,用于长期趋势评估。
加密货币行情报告 工作原理
  1. 该技能从 OKX API 获取用户配置中定义的所有资产的实时 OHLCV(开盘价、最高价、最低价、收盘价、成交量)数据。
  2. 它计算技术指标,特别是用于方向的 Supertrend (10, 3) 和用于趋势强度的 ADX (14)。
  3. 获取包括资金费率和持仓量在内的实时永续合约数据,以提供专业的市场背景。
  4. 系统计算特定资产与比特币之间的相关性,以识别市场领涨者和滞后者。
  5. 生成格式化的 Markdown 报告,由 AI 智能体处理并交付给用户。

加密货币行情报告 配置指南

要开始使用此技能,请确保您的系统中安装了 python3 和 curl。随后您可以运行手动报告或为 Openclaw Skills 配置观察列表。

# 运行标准每日行情报告
python3 scripts/regime_report.py

# 运行每周总结
python3 scripts/regime_report.py --weekly

要自定义受坚控的资产,请编辑 references/config.json 文件:

{
  "watchlist": [
    {"symbol": "BTC", "name": "Bitcoin", "okx": "BTC-USDT-SWAP"}
  ],
  "indicators": {
    "supertrend": { "period": 10, "multiplier": 3 },
    "adx": { "period": 14, "strong_threshold": 25, "weak_threshold": 20 }
  }
}

您还可以使用 CLI 设置自动化报告:

openclaw cron add --name "Morning Report" --schedule "0 6 * * *" --message "Run the crypto regime morning report"

加密货币行情报告 数据架构与分类体系

该技能将市场数据组织成一种既易于人类阅读又可供机器解析的结构化格式。每份报告中都会捕获以下数据点:

类别 数据点 来源
价格行为 当前价格、24小时涨跌幅及行情分类 OKX API
技术指标 ADX(趋势强度)和 Supertrend 方向 内部逻辑
流动性 相对于 20 日平均成交量的百分比 (%) OKX API
衍生品 资金费率和持仓量 ($B) OKX API
相关性 与 BTC 的 Pearson 相关系数 计算得出
name: crypto-regime-report
description: Generate market regime reports for crypto perpetuals using Supertrend and ADX indicators. Use when the user asks for a regime check, market report, trend analysis, or scheduled morning/evening crypto updates. Reports include price action, trend direction/strength, funding rates, open interest, volume analysis, and BTC correlation for a configurable watchlist.
metadata:
  openclaw:
    emoji: "??"
    requires:
      bins: ["python3", "curl"]

Crypto Regime Report

Generate regime reports for crypto perpetual futures using technical indicators.

Quick Start

# Run a daily regime report
python3 {baseDir}/scripts/regime_report.py

# Run a weekly regime report
python3 {baseDir}/scripts/regime_report.py --weekly

Or ask directly: "What's the regime on BTC?" or "Run a market report."

Note: The script outputs a formatted report to stdout. The agent handles delivery (e.g., sending to T@elegrimm, displaying in ch@t).


What's Included in Reports

Price & Trend:

  • Current price + 24h change
  • Regime classification (Strong Bull/Bear, Weak Bull/Bear, Ranging)
  • ADX value (trend strength)
  • Trend direction (bullish/bearish based on Supertrend)
  • Distance from Supertrend line (%)

Volume & Liquidity:

  • Volume vs 20-day average (%)
  • ?? = low volume, ?? = high volume

Perpetuals Data:

  • Funding rate + change direction (↑↓→)
  • Open Interest (current, in $B)
  • ?? = elevated funding rate

Market Context:

  • BTC correlation (0.0 to 1.0)
  • ?? = high correlation (> 0.7)

Setup Guide

1. Configure Your Watchlist

Option A: Edit the default config

Edit {baseDir}/references/config.json to customize your asset list:

{
  "watchlist": [
    {"symbol": "BTC", "name": "Bitcoin", "okx": "BTC-USDT-SWAP"},
    {"symbol": "ETH", "name": "Ethereum", "okx": "ETH-USDT-SWAP"}
  ],
  "indicators": {
    "supertrend": { "period": 10, "multiplier": 3 },
    "adx": { "period": 14, "strong_threshold": 25, "weak_threshold": 20 }
  }
}

Option B: Use a custom config file

# Via environment variable (must be relative path within skill directory)
REGIME_CONFIG=references/my-config.json python3 {baseDir}/scripts/regime_report.py

Security note: For security, config paths are restricted to the skill directory. Absolute paths and path traversal (e.g., ../) are not allowed.

An example config is provided at {baseDir}/references/config.example.json — copy and modify it for your needs.

Config fields:

  • symbol — Short ticker (used for display)
  • name — Full name (used for display)
  • okx — OKX perpetual symbol (must match OKX's format: ASSET-USDT-SWAP)

To find OKX symbols: Visit OKX Markets or use:

curl -s "https://www.okx.com/api/v5/public/instruments?instType=SWAP"
# Optionally pipe through jq to filter: | jq '.data[].instId'

2. Configure Indicator Settings

Adjust in config.json:

Setting Default Description
supertrend.period 10 Lookback period for ATR calculation
supertrend.multiplier 3.0 ATR multiplier for band width
adx.period 14 Lookback period for ADX
adx.strong_threshold 25 ADX level for "strong" trend
adx.weak_threshold 20 ADX level for "weak" trend

3. Set Up Scheduled Reports (Optional)

Use OpenClaw's cron system to receive reports automatically.

Via CLI:

# Morning report (6am PST)
openclaw cron add r
  --name "Morning Regime Report" r
  --schedule "0 6 * * *" r
  --timezone "America/Los_Angeles" r
  --message "Run the crypto regime morning report"

# Evening report (3pm PST)
openclaw cron add r
  --name "Evening Regime Report" r
  --schedule "0 15 * * *" r
  --timezone "America/Los_Angeles" r
  --message "Run the crypto regime evening report"

# Friday weekly summary (4pm PST)
openclaw cron add r
  --name "Friday Weekly Summary" r
  --schedule "0 16 * * 5" r
  --timezone "America/Los_Angeles" r
  --message "Run the crypto regime weekly report with --weekly flag"

Via config (~/.openclaw/openclaw.json):

{
  // ... other config ...
  "cron": {
    "jobs": [
      {
        "name": "Morning Regime Report",
        "schedule": { "kind": "cron", "expr": "0 6 * * *", "tz": "America/Los_Angeles" },
        "sessionTarget": "isolated",
        "payload": { "kind": "agentTurn", "message": "Run the crypto regime morning report" },
        "delivery": { "mode": "announce" }
      },
      {
        "name": "Evening Regime Report",
        "schedule": { "kind": "cron", "expr": "0 15 * * *", "tz": "America/Los_Angeles" },
        "sessionTarget": "isolated",
        "payload": { "kind": "agentTurn", "message": "Run the crypto regime evening report" },
        "delivery": { "mode": "announce" }
      },
      {
        "name": "Friday Weekly Summary",
        "schedule": { "kind": "cron", "expr": "0 16 * * 5", "tz": "America/Los_Angeles" },
        "sessionTarget": "isolated",
        "payload": { "kind": "agentTurn", "message": "Run the crypto regime weekly report with --weekly flag" },
        "delivery": { "mode": "announce" }
      }
    ]
  }
}

4. Test the Reports

# Test daily report
python3 {baseDir}/scripts/regime_report.py

# Test weekly report
python3 {baseDir}/scripts/regime_report.py --weekly

What It Does

  1. Fetches OHLCV data from OKX for each asset on the watchlist
  2. Calculates Supertrend to determine trend direction
  3. Calculates ADX to measure trend strength
  4. Fetches current funding rates and open interest
  5. Outputs a formatted report suitable for T@elegrimm delivery

Indicators

Supertrend (10, 3)

  • Period: 10
  • Multiplier: 3
  • Bullish: Price above Supertrend line
  • Bearish: Price below Supertrend line

ADX (Average Directional Index)

  • > 25: Strong trend (bull or bear)
  • 20-25: Weak/moderate trend
  • < 20: No clear trend / ranging

Regime Classification

Supertrend ADX Regime
Bullish > 25 Strong Bull
Bullish 20-25 Weak Bull
Bearish > 25 Strong Bear
Bearish 20-25 Weak Bear
Either < 20 Ranging

Data Sources

Data Source Notes
Daily OHLCV OKX API Free, no key required
Weekly OHLCV Yahoo Finance 11+ years history, OKX fallback
Funding Rates OKX API Free, no key required
Open Interest OKX API Free, no key required

OKX API endpoints:

  • OHLCV: /api/v5/market/candles
  • Funding: /api/v5/public/funding-rate
  • Open Interest: /api/v5/public/open-interest

Resources

scripts/

  • regime_report.py — Main script that fetches data and generates the report

references/

  • config.json — Default watchlist configuration (edit this to customize)
  • config.example.json — Example config you can copy and modify

相关推荐