核心功能
ClawQuest Agent Mine 是一款面向 OpenClaw 游戏生态的托管挖矿 Skill，通过标准化的 HTTP Tool API 封装底层游戏接口，为自动化代理提供安全、可控的挖矿管理能力。
显著优点
1. 标准化接口封装：将复杂的游戏 /api/* 端点抽象为简洁的 Tool 调用（set_api_code、start_managed_mining_loop 等），降低集成门槛，避免直接操作原始 API 带来的风险。
2. 智能托管循环：start_managed_mining_loop 实现完整的挖矿生命周期管理——自动启停、等待预估完成时间、错误重试、奖励记录与轮询间隔控制，支持无人值守的持续运行。
3. 弹性配置机制：通过环境变量（REQUEST_TIMEOUT_MS、MANAGED_MINING_AUTO_BUY_STAMINA 等）与工具参数双重配置，兼顾默认值便捷性与高级用户自定义需求。
4. 状态透明化：提供多层状态查询工具（get_mining_quick_status、get_managed_mining_status、get_mining_session_events），支持事件流式输出，便于实时监控与故障排查。
5. 安全隔离设计：强制要求 X-Api-Code 认证，Skill 层不处理游戏登录逻辑，凭证由用户在游戏内生成后注入，实现权限最小化原则。
潜在局限
- 功能边界受限：明确禁止直接调用上游
/api/*端点，所有交互必须通过 Skill 提供的 Tool 层，灵活性受限于官方文档支持的工具有限集合。
- 单实例缓存依赖：
apiCode默认使用文件系统缓存（./data/api-code-store.json），多实例部署或容器化场景需额外配置API_CODE_STORE_PATH，否则存在状态不一致风险。
- 错误处理被动：Skill 要求代理层"报告错误而非自我修复"，复杂异常场景（如网络波动、游戏服务端限流）需调用方实现重试与降级策略。
- 资源消耗隐性成本：
autoBuyStamina功能依赖钻石自动兑换，若未设置autoBuyStaminaMaxFailures阈值，可能在异常情况下导致资源过度消耗。
适合人群
- 需要 7×24 小时离线挖矿的游戏玩家
- 构建 OpenClaw 自动化工作流的开发者与 Agent 运营者
- 希望避免直接维护游戏 API 集成复杂度的技术用户
常规风险
| 风险类别 | 具体表现 | 缓解建议 |
|---------|---------|---------|
| 认证泄露 | `apiCode` 在日志或环境变量中明文存储 | 启用缓存机制，避免在调用参数中重复传递 |
| 经济损耗 | 自动购买体力失败累积或钻石误消耗 | 设置 `autoBuyStaminaMaxFailures` 上限，定期审计 `get_stamina` 输出 |
| 账号封禁 | 高频 API 调用触发游戏方风控 | 遵守 `pollingIntervalMilliseconds` 默认值，避免擅自降低间隔 |
| 数据丢失 | 缓存文件损坏导致 `apiCode` 失效 | 配置持久化存储路径，配合 `get_api_code` 前置校验 |