核心功能与用法
ClawQuest: Agent Mine 是一款面向 ClawQuest 游戏的托管式挖矿自动化 Skill，基于 OpenClaw 框架开发，通过调用游戏公开 API 实现全流程自动化管理。
核心能力
挖矿自动化引擎
start_mining_session：启动完整的托管挖矿会话，自动执行开始挖矿→等待完成→结算奖励→间隔循环的流程- 内置状态机管理：
ApiInactive/ApiInUse/ApiClosing/ApiActive与MiningIdle/MiningInProgress/MiningRewardPending双轨状态监控 - 智能错误处理：支持最大连续错误阈值配置，超限时自动安全停止
体力与经济系统
get_stamina/buy_stamina：实时查询体力与钻石余额，支持自动购买体力（autoBuyStamina）- 当体力不足时自动触发钻石兑换，连续失败可配置止损
API 凭证管理
set_api_code/get_api_code/clear_api_code：持久化存储游戏内生成的X-Api-Code，支持多账户隔离（cacheKey）
实时监控
get_mining_session_events：事件流式读取，支持增量同步get_mining_quick_status/get_managed_mining_status：轻量/完整状态查询
显著优点
1. 全流程无人值守：从启动到结算完全自动化，无需人工干预挖矿周期
2. 容错机制完善：支持网络超时重试、状态冲突检测、资源不足自动处理
3. 灵活配置：环境变量覆盖超时、轮询间隔、错误阈值等关键参数
4. 会话隔离：多账户支持，不同 cacheKey 独立存储凭证与状态
5. 非侵入式设计：仅调用公开 API，不修改游戏客户端或内存
潜在局限与风险
| 方面 | 说明 |
|------|------|
| **认证依赖** | 需用户手动在游戏内生成 `apiCode`，Skill 无法自主完成登录流程 |
| **API 稳定性** | 受游戏官方服务器状态影响，维护或限流时可能中断 |
| **经济风险** | 自动购买体力功能若配置不当可能导致钻石过度消耗 |
| **账号安全** | `apiCode` 等同于临时凭证，泄露可能导致他人操控账号资源 |
| **合规灰区** | 自动化工具可能违反游戏服务条款，存在账号限制风险 |
适合人群
- 希望减少重复性挖矿操作的时间敏感型玩家
- 拥有稳定网络环境且理解 API 调用原理的技术用户
- 需要多账号管理的轻度工作室场景
常规风险控制建议
- 启用
autoBuyStamina时设置合理的autoBuyStaminaMaxFailures上限 - 定期轮换
apiCode并避免在公共环境存储凭证 - 监控
get_mining_session_events异常事件，及时人工介入 - 首次使用建议手动执行单轮流程验证配置正确性