Earn Hunter is an automated yield monitor for OKX Flash Earn, Fixed Earn, and Flexible Earn opportunities that triggers notifications across Telegram, Lark, or your terminal session.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install earn-hunter
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install earn-hunter using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Earn Hunter?
Earn Hunter is an advanced monitoring agent skill designed to help cryptocurrency investors track high-yield opportunities on OKX in real-time. By continuously scanning OKX Flash Earn, Fixed Earn, and Flexible Earn products, the skill eliminates the need to manually refresh platforms for high-demand staking and lending rates. It seamlessly integrates with Openclaw Skills to run lightweight background scans, checking APY rates, term durations, and capacity limits against your user-defined criteria.
Once a lucrative opportunity crosses your specified APY thresholds, Earn Hunter dispatches instant push notifications via Telegram, Lark, or direct interactive terminal outputs. To protect you from spam, the skill utilizes an intelligent threshold-crossing state dedup mechanism, ensuring you only receive alerts when rates actually change or new pools open. If you decide to act, the skill guides you through checking balances, comparing APRs, and handing off execution to complementary transaction tools.
Earn Hunter Use Cases
- Instant Flash Earn Notifications: Get alerted the moment high-yield, limited-capacity OKX Flash Earn pools open before they sell out.
- USDT/USDC Yield Tracking: Monitor flexible stablecoin rates and receive notifications when lending rates jump above your target threshold (e.g., 8% APY).
- Automated Passive Income Optimization: Keep an eye on Fixed Earn terms across specified currencies (like BTC, ETH, or SOL) and secure yield-bearing options without manual tracking.
- Minimal-Cost Background Execution: Run low-overhead cron scans that track market changes without keeping full LLM sessions open, optimizing your Openclaw Skills workspace.
How Earn Hunter Works
- Environment & Auth Verification: The skill initializes by checking the local OKX CLI configuration, verifying credential status (API key or OAuth), and generating path snapshots to ensure execution stability.
- Platform & Scheduler Setup: It auto-detects the host platform (OpenClaw, Claude Code, or Hermes) and registers the scan runner. On OpenClaw, it schedules a background job via the in-session cron tool. On standard CLI environments, it configures an OS crontab or macOS LaunchAgent.
- Scanning Cycle: The background script triggers at the scheduled interval, performing direct JSON queries against OKX earn APIs to gather current yield metrics with zero LLM token costs.
- Filtering and Deduping: Results are filtered using user-defined criteria in config.json. The script checks these against state.json to suppress duplicate alerts and tracks stablecoin rates using a threshold-crossing logic.
- Notification Delivery: If fresh high-yield opportunities exist, it renders localized alerts and sends them to Telegram, Lark, or the active terminal session.
- Subscription Hand-off: When a user decides to subscribe, the skill evaluates account balances across funding, trading, and simple earn savings, calculates optimal amounts, and initiates a hand-off to okx-cex-earn to finalize the trade.
Earn Hunter Setup
Prerequisites
Ensure you have the OKX CLI and jq utility installed on your system:
# Install the official OKX CLI tool globally
npm install -g @okx_ai/[email protected]
# Ensure jq is installed for JSON parsing
brew install jq || apt-get install jq
Activation & Initialization
Launch your agent and run the activation command to start configuring the platform, notifications, and scan parameters:
# Trigger the setup flow interactively
okx skill add earn-hunter
# Command the agent inside your terminal session:
# "Activate earn-hunter and monitor earn opportunities"
Follow the step-by-step interactive prompts to confirm your hosting platform, provide Telegram or Lark credentials, choose target currencies (e.g., USDT, SOL), and specify minimum APY requirements. The system will finalize the setup by creating configuration files under ~/.okx/earn-hunter/ and creating your background scheduler.
Earn Hunter Data Schema & Taxonomy
Earn Hunter manages state and scan policies locally in the user's home directory. This clear isolation ensures compatibility across different hosts utilizing Openclaw Skills. Below is the file configuration schema:
File Structure
All tracking details are localized in ~/.okx/earn-hunter/:
| File Name | Description | Key Properties |
|---|---|---|
config.json |
Defines scan filters, target assets, and APY alerts | currencies, fixed.globalMinApy, flexible.currencies, notify.language |
platform.json |
Details runner schedule, host OS, and alert targets | scheduler.type, scheduler.interval, notify.channel, notify.lark_webhook |
state.json |
Maintains deduplication history to prevent notification spam | flash (map of active IDs), fixed (active metrics), consecutive_failures |
env.snapshot |
Resolves exact binary paths for headless cron runs | OKX_BIN, NODE_BIN, JQ_BIN, ACTIVATION_PATH |
notify.log |
Standard text log recording execution and dispatch events | Diagnostic trace history |
Flexible Earn State Structure
To avoid alert fatigue on fluctuating stablecoin yields, the system records state utilizing a single key structure: state.flexible["<ccy>"]. The alert resets and cleanses itself only if the yield falls back below your defined APY limit.
Earn Hunter Advanced Features
- Multi-Platform Adaptive Schedulers: Seamlessly switches between OpenClaw conversational cron actions, native OS crontabs, and macOS LaunchAgents depending on the runtime environment.
- Environment-Safe Path Snapshots: Automatically records exact binary path locations on installation, shielding headless background processes from missing paths or nvm/homebrew environment drift.
- Isolated Test Sandbox Mode: Supports diagnostic triggers using
EH_TEST_NAMESPACE=1to test end-to-end alerting mechanics and verbose outputs without polluting production dedup indexes. - Smart Balances & Auto-Redemption: Analyzes available capital across funding, trading, and simple earn pools to provide optimized recommendations for subscription, automatically routing to okx-cex-earn.
- Error Fault-Tolerance: Tracks consecutive failures to alert users after three consecutive errors, preserving platform configurations and preventing broken schedules from running silently.
SKILL.md
Loading
Related Openclaw Skills
Into Thin Air Narrative & Decision-Making Toolkit
An AI-powered narrative toolkit that maps Jon Krakauer's Into Thin Air to high-stakes decision-making, mountaineering history, and survival ethics.
Fire Weather Climate Crisis Toolkit
An AI agent skill based on John Vaillant's Fire Weather that provides deep analytical frameworks for understanding climate-amplified megafires, firestorms, and environmental disasters.
Google Scholar Paper Finder
An advanced academic retrieval and ranking pipeline powered by Google Scholar MCP and custom venue quality datasets.
Savage Inequalities Education Justice Toolkit
An education justice toolkit that analyzes public school segregation, funding inequalities, and the moral crisis of America's property-tax-based education system.
Operation Gladio
An AI-powered geopolitical research toolkit designed to trace historical alliances, deep-state finance, and the legacy of Operation Gladio stay-behind networks.
HR Candidate Discovery and Screening
An AI-powered candidate sourcing, vetting, and outreach automation workflow powered by DeepSeek and Lark Mail, designed to keep human recruiters strictly in control.
Featured*
