通过 X-Api-Code 认证实现游戏自动化挖矿管理，支持托管循环、体力自动购买与状态监控，适合需要离线挂机的玩家。
说明：
## 核心功能
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` 前置校验 |
会员专属
