Earn Hunter 用于自动监控 OKX 平台的闪赚（Flash Earn）、定期赚币（Fixed Earn）和活期赚币（Flexible Earn / Simple Earn）机会，在发现符合条件的机会时发送推送通知，并可引导完成申购。
使用前需确认已安装 okx CLI（which okx），如缺失可通过 npm install -g @okx_ai/okx-trade-cli 安装；扫描依赖 jq。可选依赖技能 okx-cex-earn（申购引导）和 okx-cex-auth（认证恢复），缺失时不影响扫描与通知，可后续执行 okx skill add okx-cex-earn、okx skill add okx-cex-auth 安装。
认证支持两种模式：存在非空 api_key 时使用 API Key 模式并在命令中加 --profile live；否则若 okx auth status --json 返回 logged_in 则使用 OAuth 模式。配置与状态文件位于 ~/.okx/earn-hunter/，包括 config.json（扫描范围、币种、APY 阈值、语言）、platform.json（调度类型、通知渠道）和 state.json（去重状态），扫描脚本为 ~/.okx/earn-hunter/scan.sh。
平台与调度分为 OpenClaw（通过会话内 cron 工具调度，结果经由会话渠道回传）、Claude Code、Hermes Agent 及其他平台（通过操作系统 crontab 或 macOS LaunchAgent 调度，由 scan.sh 完成扫描与 curl 推送，零 LLM 消耗）；通用平台不支持自动调度，需手动触发扫描。
通知渠道支持 Telegram 和 Lark（飞书），也可仅会话显示；后两者之外的配置方式、价格与收费信息暂未提供。扫描范围可选择闪赚、定期、活期，币种与 APY 阈值可配置，活期因需逐币调用 API 建议保持较小币种列表。首次激活会进行平台探测与确认、通知渠道检测、扫描配置确认及冒烟测试，验证推送链路可用后设置调度。
技能路由支持激活、配置管理、申购引导、扫描执行、暂停/恢复、卸载和测试模式等意图。限制方面：通用平台无自动调度；会话渠道离线时收不到通知；OS crontab 平台在最小 PATH 下依赖 env.snapshot 解析工具路径，若该步骤失败会导致定时任务静默失败。