ClawQuest：Agent Mine — OpenClaw 托管挖矿

本 Skill 为 OpenClaw 会话工作流提供托管式挖矿工具。

Agent 规则（OpenClaw）

自动化 Agent（包括 OpenClaw 工作流）必须遵守以下约束：

• 仅限使用工具：仅可通过本 Skill 提供的 工具 HTTP API 与游戏交互 —— 即向 skill-openclaw 服务发起 POST /tool/:name 请求，并严格使用下文所列的工具名称（如 set_api_code、check_mining_state、start_managed_mining_loop 等）。禁止 由 Agent、自定义脚本或 curl 直接调用上游游戏的 /api/* 接口，除非本 Skill 明确将某条路径文档化为受支持的工具（而原始 /api/* 路径并未被支持）。
• 不得修改源码：禁止 编辑、打补丁或 fork skill-openclaw 源码树、package.json 或运行时代码以“修复”行为。仅可使用已文档化的环境变量及本 SKILL.md 文件中说明的配置方式。
• 报告错误；禁止在代码中自我修复：若工具调用失败或行为异常，应 如实报告 故障详情（HTTP 状态码、响应体、工具名称、cacheKey、时间戳、日志等）。禁止 修改 Skill 代码、注入替代 HTTP 客户端，或绕过工具层作为临时解决方案。

API 协议约定

所有挖矿及体力相关 API 均需携带 X-Api-Code 请求头。

• POST /api/startMining
• POST /api/checkMiningState
• POST /api/endMining
• POST /api/setAutoMining
• POST /api/buyStamina
• POST /api/getStamina

（内部轮次流程仍通过托管循环实现调用 POST /api/setAutoMining、POST /api/startMining 和 POST /api/endMining；但这些接口未作为 Skill 工具对外暴露。）

认证方式：

• 请求头：X-Api-Code:

本 Skill 不执行游戏客户端登录。用户须自行提供游戏中生成的 apiCode。

状态码定义

check_mining_state 返回 apiState 和 miningState。其数值映射关系如下：

apiState

miningState

工具列表

set_api_code

持久化保存一个 apiCode，供后续调用使用。

输入参数：

• apiCode（必填）
• cacheKey（可选，默认值：default）

get_api_code

读取已缓存的 apiCode。

输入参数：

• cacheKey（可选，默认值：default）

clear_api_code

删除已缓存的 apiCode。

输入参数：

• cacheKey（可选，默认值：default）

check_mining_state

查询 API 激活状态与当前挖矿状态。返回 apiState 和 miningState（参见「状态码定义」章节）。

输入参数：

• apiCode（可选，若未提供则回退至缓存值）
• cacheKey（可选，默认值：default）

buy_stamina

使用钻石购买体力。

输入参数：

• apiCode（可选，若未提供则回退至缓存值）
• cacheKey（可选，默认值：default）

get_stamina

获取当前体力与钻石数量。

输入参数：

• apiCode（可选，若未提供则回退至缓存值）
• cacheKey（可选，默认值：default）

start_managed_mining_loop

启动托管式挖矿循环执行。

执行流程：

1. start_mining —— 遇错即中止
2. 等待至 estimatedEndAt 时间点
3. 循环执行 end_mining —— 遇错重试，成功即视为本轮完成
4. 记录奖励
5. 等待轮次间隔后继续下一轮

输入参数：

• apiCode（可选，若未提供则回退至缓存值）
• cacheKey（可选，默认值：default）
• lang（可选）
• pollingIntervalMilliseconds（可选）
• roundIntervalMilliseconds（可选）
• maxConsecutiveErrorCount（可选）
• autoBuyStamina（可选）
• autoBuyStaminaMaxFailures（可选）
• forceRestart（可选）

start_mining_session

功能同 start_managed_mining_loop，额外绑定 OpenClaw 会话并启用事件流。

get_mining_session_events

读取增量式会话事件。

输入参数：

• sinceEventId（可选，默认值：0）

get_mining_quick_status

读取轻量级托管循环状态。

get_managed_mining_status

读取完整托管循环状态。

stop_managed_mining_loop

请求安全终止正在运行的托管循环。

已弃用工具

• start_auto_mining（已弃用）
• stop_auto_mining（已弃用）

推荐调用顺序

1. set_api_code（一次性初始化）
2. start_mining_session
3. （可选）按需调用 get_mining_quick_status 或 get_mining_session_events —— 默认不启用自动周期性轮询
4. 需要时调用 stop_managed_mining_loop

错误码

所有 API 响应均包含 code 字段。0 表示成功；非零值表示错误。

通用错误

挖矿相关错误

环境变量