功能描述

Comprehensive cryptocurrency market monitoring and economic data analysis. Use when tracking crypto prices, market sentiment, economic data releases, or anal...

使用说明 (SKILL.md)

Crypto Market Monitor

Name: Crypto Market Monitor
Author: kjjjj0

Complete cryptocurrency market monitoring system with price tracking, economic data releases, and impact analysis.

Installation

Quick install:

clawhub install crypto-market

For manual installation, see INSTALL.md.

Quick Start

Price Monitoring

Monitor 13 major cryptocurrencies (BTC, ETH, XRP, BNB, SOL, ADA, AVAX, DOGE, TRX, LINK, SUI, WLFI, XAUT) with real-time prices, volatility alerts (±5%), market sentiment analysis, and EMA technical indicators.

From your crypto workspace:

cd scripts
python3 crypto_monitor_telegram.py

Economic Data Reports

View upcoming economic data releases (7-day forecast) with importance levels (high/medium) and countdown timers.

From your crypto workspace:

cd economic
python3 daily_economic_report_v2.py

Economic Data Analysis

Update Actual Values

When economic data is released, update actual values to trigger automatic bullish/bearish analysis.

From your crypto workspace:

cd economic
python3 update_economic_data.py update "数据名称" "实际值" --datetime "发布时间"

Examples:

# CPI data (lower is bullish)
python3 update_economic_data.py update "CPI 消费者价格指数" "2.1%" --datetime "2026-03-13 21:30"

# NFP data (higher is bullish)
python3 update_economic_data.py update "非农就业数据" "+280K" --datetime "2026-03-14 21:30"

# GDP data (higher is bullish)
python3 update_economic_data.py update "GDP 季度报告" "1.8%" --datetime "2026-03-20 21:30"

# Unemployment rate (lower is bullish)
python3 update_economic_data.py update "失业率" "4.0%" --datetime "2026-03-14 21:30"

Quick Analysis (No Save)

Analyze data impact without saving to database.

python3 update_economic_data.py analyze "数据名称" "实际值" "预期值" "前值"

Example:

python3 update_economic_data.py analyze "CPI" "2.1%" "2.3%" "2.4%"

View Updated Data

Check all economic data with actual values.

python3 update_economic_data.py list

Bullish/Bearish Analysis

Bullish Indicators (Higher is Bullish) 🟢

Non-Farm Payrolls (NFP)
GDP
Retail Sales
ADP Employment
Manufacturing PMI
Services PMI

Rule: Actual > Expected (+2%+) = Bullish

Bearish Indicators (Lower is Bullish) 🟢

CPI (Inflation)
PPI (Prices)
Unemployment Rate
Interest Rates (FOMC)

Rule: Actual \x3C Expected (-2%+) = Bullish (pressure relief)

Scheduled Reports

Daily Economic Report

Time: 08:00 AM daily
Content: 7-day economic data forecast
Format: High importance events with expected/previous values and countdown

Comprehensive Monitoring

Time: Every 30 minutes
Content: Crypto prices + economic data reminders
Features: Volatility alerts, market sentiment, EMA indicators

Default Workspace Structure

crypto/                    # Your crypto workspace
├── economic/            # Economic data scripts
├── scripts/             # Monitoring scripts
├── data/                # Data storage (actual_data.json)
└── logs/                # Log files

Data Types

High Importance

Non-Farm Payrolls (NFP) - First Friday monthly, 21:30
CPI - Mid-month, 21:30
FOMC Interest Rate - Quarterly, 02:00
GDP - Quarterly end, 21:30
Unemployment Rate - First Friday monthly, 21:30

Medium Importance

ADP Employment - First Wednesday monthly, 21:15
Retail Sales - Mid-month, 21:30
Manufacturing PMI - First day monthly, 22:00
Services PMI - First day monthly, 22:00
PPI - Mid-month, 21:30

See data-types.md for detailed information on each indicator.

Scripts

Core modules (in economic/):

economic_calendar.py - Economic calendar management
economic_analyzer.py - Bullish/bearish analysis engine
update_economic_data.py - Actual value management

Monitoring (in scripts/):

crypto_monitor_telegram.py - Price monitoring + economic data

References:

quick-reference.md - Command cheat sheet
data-types.md - Economic indicator details
usage-examples.md - Real-world scenarios

Customization

Change Workspace

Edit paths in scripts or create a config file. See INSTALL.md for details.

Modify Alert Threshold

Edit scripts/crypto_monitor_telegram.py:

ALERT_THRESHOLD = 5.0  # Change to your preferred threshold

Add/Remove Tokens

Edit scripts/crypto_monitor_telegram.py TOKENS dictionary.

Important Notes

Timezone: All times are Asia/Shanghai (Beijing Time)
Data Storage: Actual values saved to data/actual_data.json
Impact Analysis: Automatic bullish/bearish determination based on actual vs expected deviation
Alert Thresholds: Price volatility alerts trigger at ±5% change

For detailed installation, customization, and usage scenarios, see INSTALL.md and usage-examples.md.

安全使用建议

This package appears to implement the advertised crypto and economic monitoring features, but several inconsistencies deserve attention before you install or run it: - Hardcoded root paths: The Python modules use absolute paths (e.g. /root/.openclaw/workspace/...) while INSTALL.md uses ~/.openclaw/.... That can cause the code to create or write files under /root (which may fail or be surprising). Search the scripts for '/root/.openclaw' and change them to a configurable, user-writable workspace (or set up the intended workspace path explicitly). - Undeclared credentials: The code references Telegram notifications and an optional TradingEconomics API. The skill's metadata declares no environment variables. Inspect the crypto_monitor_telegram.py tail (the sending logic) to see whether it expects TELEGRAM_BOT_TOKEN, CHAT_ID, or other secrets, and supply them via a safe config (not environment variables you don't control). Do not run on a machine that contains secrets until you confirm where the skill will send data. - Network behavior: The scripts call CoinGecko and Binance APIs and may print or send their outputs. If you need to audit outbound endpoints, run the code in a network-restricted sandbox first. - Persistence & cron: INSTALL.md suggests cron entries that will run the scripts periodically. Only install cron jobs after you confirm the scripts behave as expected and write logs/data where you expect. Recommendations before installing: 1) Review the full crypto_monitor_telegram.py send logic (it was truncated); verify which external endpoints receive data and whether credentials are required. 2) Replace hardcoded /root paths with a configurable workspace path (e.g., use ~/.openclaw/workspace/crypto or a path you control). 3) Run the scripts in an isolated container or VM first to confirm behavior and network traffic. 4) If you intend to enable Telegram notifications, set up a dedicated bot and chat and store the token securely (and only after you inspect the sending code). 5) If you are not comfortable doing these code changes, avoid installing the skill on production or privileged hosts. Given these mismatches and missing declarations the skill is best treated cautiously; the issues are more likely sloppy engineering than outright malice, but they increase risk and should be resolved before use.

功能分析

Type: OpenClaw Skill Name: crypto-market-publish Version: 2.0.0 The crypto-market skill bundle is a legitimate tool for monitoring cryptocurrency prices and economic indicators. It fetches data from public APIs (CoinGecko and Binance) and provides logic for analyzing the market impact of economic events like CPI and NFP. The scripts (e.g., crypto_monitor_telegram.py and economic_analyzer.py) are well-structured, and the instructions in SKILL.md and INSTALL.md are consistent with the stated purpose of providing automated market reports and alerts.

能力评估

ℹ Purpose & Capability

The scripts and docs implement crypto price monitoring, an economic calendar, and impact analysis as advertised. However there are oddities: scripts hardcode absolute /root/.openclaw/workspace/* paths while INSTALL.md instructs creating ~/.openclaw/workspace/crypto — the mixed paths are inconsistent and may cause the skill to read/write under root rather than the user's home. The code also references external services (CoinGecko, Binance, TradingEconomics) and Telegram notifications, which are legitimate for this purpose but the skill does not declare the API keys or tokens that would normally be required.

⚠ Instruction Scope

SKILL.md tells the agent to run the included scripts and set up cron jobs; the scripts perform network calls to public crypto APIs and create/read/write JSON data files. They also insert absolute sys.path entries (e.g. '/root/.openclaw/workspace/crypto/economic' and '/root/.openclaw/workspace/economic'), which can cause the runtime to import code from unexpected filesystem locations. The monitoring script claims to send reports to Telegram but no env vars or config for Telegram credentials are declared; that behaviour is not fully documented and is truncated in the bundle, so the destination and authentication are unclear.

✓ Install Mechanism

No install spec (instruction-only plus included scripts). That is the lower-risk pattern for install mechanics. INSTALL.md uses standard unzip/copy/chmod steps and suggests pip installing a few Python packages. Nothing in the install instructions downloads arbitrary binaries from unknown hosts.

⚠ Credentials

The skill declares no required environment variables or credentials, yet the code clearly expects network access to CoinGecko/Binance and mentions optional TradingEconomics API keys and Telegram integration. The absence of declared TELEGRAM_BOT_TOKEN/CHAT_ID or other API credentials is an inconsistency: running the code as-is may either fail or attempt to send data in an undocumented way. Also the code writes actual_data.json into absolute paths under /root — requiring write access to system locations that are disproportionate to a user-level monitoring tool.

⚠ Persistence & Privilege

The skill will create directories and files (actual_data.json, logs) and suggests cron jobs to run every 30 minutes and daily reports. While it does not request 'always: true' or any platform-level privilege, the hardcoded use of /root/.openclaw/workspace paths means it may attempt to persist data under root-owned locations or behave differently when run as non-root. That filesystem/persistence behavior is not aligned with the user's INSTALL.md which uses the user's home directory.

版本历史

v2.0.0

v2.0: Removed hardcoded paths, added installation guide, improved portability and usability

元数据

Slug crypto-market-publish

版本 2.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题