easy-mining（轻松挖矿）

Easy Mining Skill 🦐

*"一句话管理矿场"* — 通过自然语言管理 BTC 矿场，无需打开 App，直接在对话中完成日常运维。

链路：OpenClaw → Antalpha MCP Server → Nonce MCP Server → 矿机

🚀 新手入门：绑定 Nonce API Key

在使用任何功能之前，你需要先绑定 Nonce API Key。以下是完整步骤：

第一步：注册 Nonce 账号

1. 打开浏览器，访问 https://app.nonce.app
2. 点击右上角 Sign Up 注册账号（支持邮箱注册）
3. 完成邮箱验证后登录

第二步：生成 API Key

1. 登录后，点击右上角头像，进入 Settings（设置）
2. 找到 API Keys 选项卡
3. 点击 Generate New Key
4. 给 Key 取一个名字（如 my-ai-agent），点击确认
5. 复制生成的 API Key（格式为 ak_XXXXXXXXXXXXXXXXXXXXXXXX）

⚠️ API Key 只显示一次，请立刻保存好！如果丢失，需要重新生成。

第三步：验证连接

将 API Key 告诉我，我会帮你验证连接：

"我的 Nonce API Key 是 ak_XXXXXXXXXX，帮我验证一下连接"

验证成功后，你会看到你的 Workspace 信息和矿场列表。

第四步：开始使用

连接成功后，你可以直接用自然语言管理矿场：

• 📊 "帮我看一下矿场概况"
• ⚡ "现在有多少台矿机在线？算力多少？"
• 🌡️ "有没有高温或异常的矿机？"
• 💰 "过去7天的挖矿收益是多少？"
• 🔄 "重启那台离线的矿机"（会先让你确认）

⚠️ 重要规则

Rule 1: API Key 每次传入，不落库

你的 API Key 仅在当次请求中使用，Antalpha MCP Server 不会存储你的 Key。每次对话时，如果需要调用矿场数据，我会使用你本次提供的 Key。

Rule 2: 写操作必须二次确认

easy-mining-create-task-batch 是写操作（重启/调频/升级等），调用前我会：

1. 先列出将受影响的矿机列表
2. 等你明确说"确认"后再执行

❌ 错误做法：直接执行重启
✅ 正确做法：
   1. 查询目标矿机列表
   2. 展示 → "将重启以下 3 台矿机：[列表]，确认？"
   3. 用户回复"确认"后才调用 create-task-batch

Rule 3: 自动解析 Farm ID

大多数操作需要 farm_id，我会自动处理：

• 只有一个矿场 → 自动使用
• 多个矿场 → 询问你选哪个

📋 功能对照表

查询功能（只读）

写操作（需二次确认）

📊 返回格式示例

矿场概览

📊 矿场概览 — Kuching MY
├─ 总算力：48,500 GH/s（≈ 48.5 TH/s）
├─ 在线矿机：97 / 100 台
├─ 异常矿机：3 台（离线 2、高温 1）
└─ 今日收益：0.02112 BTC（≈ ¥1,450）

矿机列表（异常过滤）

⚠️ 异常矿机（3 台）
├─ [M001] 状态：offline | 最后在线：2h 前
├─ [M047] 状态：online  | 温度：78°C ⚠️ 过热
└─ [M089] 状态：offline | 最后在线：30min 前

收益历史

💰 7 天收益报表
┌─────────────┬──────────────┬──────────┐
│ 日期         │ BTC 收益     │ 在线矿机 │
├─────────────┼──────────────┼──────────┤
│ 2026-04-09  │ 0.02112 BTC  │ 100      │
│ 2026-04-08  │ 0.01991 BTC  │ 98       │
│ 2026-04-07  │ 0.02034 BTC  │ 100      │
└─────────────┴──────────────┴──────────┘
合计：0.14231 BTC（≈ ¥9,760）

🛠️ CLI 快速测试

# 验证 API Key
python3 scripts/mcp_client.py workspace --api-key <YOUR_KEY>

# 矿场列表
python3 scripts/mcp_client.py farms --api-key <YOUR_KEY>

# 矿机实时状态
python3 scripts/mcp_client.py miners --api-key <YOUR_KEY> --farm-id <FARM_ID>

# 收益历史（最近7天）
python3 scripts/mcp_client.py metrics \
  --api-key <YOUR_KEY> \
  --farm-id <FARM_ID> \
  --from-date 2026-04-03 --to-date 2026-04-09

# ⚠️ 重启矿机（写操作，需人工确认后执行）
python3 scripts/mcp_client.py create-task \
  --api-key <YOUR_KEY> \
  --farm-id <FARM_ID> \
  --task-name miner.system.reboot \
  --miner-ids <MINER_ID_1> <MINER_ID_2>

🔒 安全说明

🆘 常见问题

📁 文件结构

easy-mining/
├── SKILL.md                    # 本文件（前端 Skill 定义）
├── README.md                   # 项目介绍（中英双语）
├── scripts/
│   └── mcp_client.py           # MCP 客户端封装（CLI 测试工具）
└── references/
    └── nonce-tools.md          # Nonce MCP 工具参考文档