earn-hunter

Earn Hunter

Automated monitor for OKX Flash Earn, Fixed Earn, and Flexible Earn (Simple Earn) opportunities.

{baseDir} = the directory containing this SKILL.md file. All relative paths (references/, templates/, config/) are resolved from here.

Preflight

1. Verify okx CLI installed: which okx. If missing, install via npm install -g @okx_ai/okx-trade-cli. On OpenClaw, also verify the in-session cron tool is available in the agent tool list (used for scheduling — not the openclaw CLI).

2. Check optional dependent skills:

   okx skill list --json
   

   Optional skills (not required for scanning/notifications):

   • okx-cex-earn — needed for purchase guide (subscription execution)
   • okx-cex-auth — needed for authentication recovery

   If either is missing, attempt to install but do not block if installation fails:

   okx skill add okx-cex-earn
   okx skill add okx-cex-auth
   

   • Install succeeds → continue
   • Install fails (network error, marketplace unavailable, etc.) → warn and continue: "⚠ {skill_name} 安装失败，扫描和通知功能不受影响。申购引导和认证恢复需要该 skill，后续可手动安装。"
   • Preflight continues regardless of skill installation result

3. Auth mode detection — run both, first match wins:

   • okx config show --json → has non-empty api_key field → API Key mode. Add --profile live to all commands.
   • No API key + okx auth status --json → "status":"logged_in" → OAuth mode. No --profile flag needed.
   • Neither → stop. Load okx-cex-auth skill and follow login steps.

4. Init config and state:

   • If ~/.okx/earn-hunter/ directory does not exist → mkdir -p ~/.okx/earn-hunter
   • If ~/.okx/earn-hunter/config.json does not exist → copy {baseDir}/config/default.json to it
   • If ~/.okx/earn-hunter/state.json does not exist → write {"flash":{},"fixed":{},"flexible":{},"consecutive_failures":0,"last_error":""}
   • If ~/.okx/earn-hunter/platform.json does not exist → run Platform Detection
   • Always (re)install the scan script: cp {baseDir}/scripts/scan.sh ~/.okx/earn-hunter/scan.sh && chmod +x ~/.okx/earn-hunter/scan.sh. This is the script cron and interactive scans both call.
   • Write ~/.okx/earn-hunter/env.snapshot with resolved tool paths (cron cannot rely on the user's login PATH):

     cat > ~/.okx/earn-hunter/env.snapshot << SNAP
     # auto-generated by earn-hunter activation — $(date -Iseconds)
     OKX_BIN=$(command -v okx)
     NODE_BIN=$(command -v node)
     JQ_BIN=$(command -v jq)
     ACTIVATION_PATH=$PATH
     SNAP
     

     The scan script sources this file to resolve tool paths even under cron's minimal PATH=/usr/bin:/bin.