核心功能
ClawQuest: Agent Mine 是一款面向游戏自动化场景的托管挖矿 Skill，通过封装 OpenClaw 游戏公共 API，为自动化 Agent 提供安全、可控的挖矿操作能力。核心功能包括：API 密钥生命周期管理（设置/读取/清除）、挖矿状态实时查询、体力资源管理（查询/购买钻石兑换）、以及托管式挖矿循环（自动开始-等待-结束-结算的全流程）。
显著优势
1. 规范化封装：强制 Agent 仅通过 Skill 工具层交互，禁止直接调用上游 /api/* 端点，降低因 API 变更导致的工作流失效风险
2. 状态机清晰：明确定义 apiState（4 种）与 miningState（3 种）的数值映射，便于程序化判断当前游戏状态
3. 容错与弹性：支持自动购买体力、连续错误阈值控制、轮询间隔自定义，适应网络波动场景
4. 事件驱动架构：get_mining_session_events 提供增量事件流，适合构建实时监控面板
5. 环境可配置：10 余项环境变量覆盖超时、路径、阈值等关键参数，无需修改源码即可调优
潜在局限
- 依赖游戏 API 稳定性：上游服务 (
svr.km.noyagames.cn) 的变更或限流可能直接影响功能 - 无登录能力：需用户手动在游戏内生成
apiCode，无法完成完整的账号认证流程 - 状态冲突风险：错误调用时序（如重复
startMining）会触发MiningStateConflict（2009），需严格遵循建议调用顺序 - 资源前置成本：自动购买体力依赖钻石余额，缺乏智能收益-成本计算模块
适合人群
- 需要 7×24 小时自动化挖矿的游戏玩家
- 构建游戏数据分析或监控工具的开发者
- 熟悉环境变量配置与 API 调试的技术用户
常规风险
| 风险类型 | 说明 |
|---------|------|
| 账号封禁 | 自动化行为可能违反游戏服务条款，存在封号风险 |
| 资源损失 | `autoBuyStamina` 配置不当可能导致非预期钻石消耗 |
| 数据泄露 | `apiCode` 以明文形式缓存于本地 JSON 文件，共享环境需额外保护 |
| 服务中断 | 游戏服务器维护或 API 变更将导致功能失效 |