核心功能
ClawQuest: Agent Mine 是一款面向OpenClaw游戏生态的托管挖矿自动化Skill,通过调用公开游戏API实现无人值守的采矿作业管理。
核心用法
该Skill采用X-Api-Code认证机制,用户需在游戏内生成API授权码后即可开始使用。主要功能覆盖完整的采矿生命周期:
- 基础操作:
start_mining/end_mining/check_mining_state控制单次采矿流程 - 资源管理:
get_stamina/buy_stamina监控与补充体力/钻石资源 - 智能托管:
start_managed_mining_loop/start_mining_session启动自动轮询循环,内置状态机自动处理采矿、等待、结算、重试全流程 - 实时监控:
get_mining_session_events/get_managed_mining_status提供事件流与状态查询
托管循环的核心逻辑为:启动采矿→等待预估完成时间→自动结算→记录奖励→间隔后继续,支持autoBuyStamina自动补充体力、maxConsecutiveErrorCount容错止损等安全机制。
显著优点
1. 全流程自动化:无需人工值守,自动处理采矿时序、网络重试、异常恢复
2. 细粒度可控:通过环境变量可自定义轮询间隔、容错阈值、自动购体策略
3. 状态透明:提供事件流、快速状态、完整状态三种查询维度
4. 多语言支持:支持简中/繁中/英/日/韩/俄六种结算语言
潜在局限与风险
| 维度 | 说明 |
|------|------|
| **认证依赖** | 需用户手动在游戏内生成`apiCode`,Skill不处理登录流程 |
| **API稳定性** | 依赖游戏方服务器(`svr.km.noyagames.cn`),存在服务中断风险 |
| **状态冲突** | 若用户同时在游戏客户端操作采矿,可能触发`MiningStateConflict`错误 |
| **经济风险** | `autoBuyStamina`可能导致意外钻石消耗,需合理设置`autoBuyStaminaMaxFailures` |
| **合规灰色地带** | 游戏自动化工具可能违反ToS,存在账号受限风险 |
适合人群
- 希望减少重复操作、优化时间效率的日常玩家
- 需要批量管理多账号的工作室/代练(需自行评估合规风险)
- 具备基础API概念、能接受第三方自动化工具的技术型用户
安全建议
- 首次使用建议关闭`autoBuyStamina`,手动验证流程稳定性
- 设置合理的
maxConsecutiveErrorCount(建议≤10)防止无限重试 - 定期检查
get_mining_session_events审计异常事件 - 重要:该Skill涉及游戏自动化,使用前务必查阅游戏官方服务条款