核心功能
ClawQuest: Agent Mine 是一款面向 OpenClaw 游戏生态的托管式挖矿自动化技能，通过封装游戏公开 API 实现无人值守的挖矿工作流。核心能力包括：
- 托管挖矿循环：
start_managed_mining_loop自动执行启动挖矿→等待结算→结束挖矿→记录奖励的完整周期，支持自定义轮询间隔与错误重试策略 - 会话绑定与事件流：
start_mining_session提供 OpenClaw 会话集成，支持增量事件读取（get_mining_session_events） - 体力与资源管理：内置
buy_stamina/get_stamina体力购买与查询，支持autoBuyStamina自动补充机制 - 状态监控：轻量/完整双模式状态查询（
get_mining_quick_status/get_managed_mining_status），实时返回apiState（0-3）与miningState（0-2）状态码
显著优点
1. 合规代理层：强制通过 Skill 工具层（POST /tool/:name）交互，禁止直接调用上游 /api/*，降低违规封号风险
2. 容错设计：支持 maxConsecutiveErrorCount 连续错误阈值、forceRestart 强制重启、自动体力购买失败兜底
3. 多实例隔离：cacheKey 机制支持多账户并行管理
4. 可配置性强：10 余项环境变量覆盖超时、轮询间隔、事件缓冲区等关键参数
潜在局限与风险
| 风险类型 | 具体说明 |
|---------|---------|
| **账号安全** | 需提供游戏内生成的 `X-Api-Code`，存在令牌泄露风险；Skill 不处理登录流程，令牌有效期由游戏方控制 |
| **状态冲突** | 错误码 `2009 MiningStateConflict` 表明若游戏内手动操作或网络异常，可能触发状态机不一致 |
| **资源消耗** | 自动体力购买依赖钻石余额，`2008 DiamondNotEnought` 将导致挖矿中断 |
| **API 稳定性** | 上游游戏服务器（`svr.km.noyagames.cn`）可用性不受 Skill 控制，且 `2014 MiningApiNotActive` 表明部分玩家可能未开通挖矿权限 |
| **合规灰色地带** | 游戏自动化可能违反 ToS，存在封号风险（Skill 文档未明确免责声明） |
适合人群
- 希望减少重复点击的 OpenClaw 玩家
- 拥有稳定
X-Api-Code来源且接受托管风险的进阶用户 - 需要多账户并行挖矿的工作室/代理场景（需自行评估合规性）
常规风险提示
- 切勿编辑源码：文档明确禁止 fork/patch Skill 代码，所有调整应通过环境变量实现
- 错误上报优先：遇到异常应记录 HTTP 状态、响应体、
cacheKey与日志，而非自行绕过工具层 - 监控建议：定期调用
check_mining_state验证apiState=3(ApiActive)与miningState流转是否正常，关注2018 MiningNotFinished等待周期避免过早轮询