btcli chutes-miner Bittensor 挖矿运维必备 TAO Mining

Bittensor 挖矿运维必备：btcli 与 chutes-miner 命令行工具完整教程

Weekend2025-10-292025-10-29

Bittensor 挖矿运维必备：btcli 与 chutes-miner 命令行工具完整教程

Bittensor subnet 64 挖矿运维必备的 btcli 与 chutes-miner 命令行工具，助力高效管理你的节点与钱包。

在 Bittensor subnet 64 挖矿生态中，最常用的两个 CLI 工具分别是：

工具	用途	使用者
✅ btcli	Bittensor 钱包、质押、子网管理	所有矿工 / 验证者
✅ chutes-miner	Chutes GPU Miner 部署与运维	GPU 挖矿节点管理者

本文将系统介绍两者的使用方法，适合矿工、节点维护者收藏。

📌 1️⃣ `btcli` 工具 —— Bittensor 官方 CLI

btcli 是 TAO 钱包、质押、子网操作的唯一官方工具。

✅ 查看命令支持

1	btcli --help

一级命令	功能说明	最常用子命令示例
`config`	配置管理	查看当前网络配置、切换网络
`wallet`	钱包管理（🔥最常用）	创建钱包、查看余额、导入密钥
`stake`	质押与解绑	stake/unstake TAO
`sudo`	⚠ 特权操作（核心开发者用）	注册子网、修改网络参数
`subnets`	管理与查询子网	查看子网信息、注册矿工等
`utils`	工具集	验签、哈希转换等
`view`	HTML UI展示	网页方式查看信息
`crowd`	Crowdloan 功能	跨链资金相关（较少用）
`liquidity`	流动性管理	提供 AMM 等 DeFi 操作

🏦 1️⃣ 钱包管理（最常用）

查看钱包帮助：

1	btcli wallet --help

✅ 创建钱包

1	btcli wallet create --wallet.name coldkey_name

✅ 查看余额

1	btcli wallet balance --wallet.name coldkey_name

✅ 列出所有钱包

1	btcli wallet list

✅ 导入助记词

1	btcli wallet import --wallet.name coldkey_name

✅ 导出私钥（⚠请谨慎保管）

1	btcli wallet export_private --wallet.name coldkey_name

💰 2️⃣ Staking（质押 / 解质押）

查看帮助：

1	btcli stake --help

✅ 质押 TAO

1	btcli stake add --wallet.name coldkey_name --amount 1

✅ 解质押

1	btcli stake remove --wallet.name coldkey_name --amount 1

✅ 查看你的质押情况

1	btcli stake overview

🌐 3️⃣ Subnets（子网查询与注册）

查看帮助：

1	btcli subnets --help

✅ 列出所有子网

1	btcli subnets list

✅ 查看某子网详情

1	btcli subnets info --netuid 27

✅ 注册矿工（加入子网挖矿）

1	btcli subnets register --netuid 64 --wallet.name coldkey_name

🔧 4️⃣ Config（网络设置）

✅ 查看当前网络配置

1	btcli config show

✅ 切换到主网

1	btcli config set network main

✅ 切换到测试网

1	btcli config set network test

🧰 5️⃣ Utils（工具）

例如验证签名、编码转换：

1	btcli utils verify

🧠 6️⃣ Sudo（⚠仅超级权限用）

⚠ unless 你是网络管理员，否则别使用！
例如：

1	btcli sudo set --something

🚀 常用命令清单（建议收藏）

# 创建钱包
btcli wallet create --wallet.name coldkey_name

# 查看余额
btcli wallet balance --wallet.name coldkey_name

# 查询所有子网
btcli subnets list

# 查看自身 stake
btcli stake overview

# stake TAO
btcli stake add --wallet.name coldkey_name --amount 1

# 解 stake
btcli stake remove --wallet.name coldkey_name --amount 1

🚀 2️⃣ `chutes-miner` —— Subnet 64子网 GPU Miner 管理核心工具

用于管理 Miner 节点、调度 GPU、部署挖矿任务。

查看命令帮助：

1	chutes-miner --help

命令	功能说明
add-node	添加新计算节点 (GPU/CPU)
delete-node	删除节点
purge-deployments	清空全部挖矿实例，重置调度
purge-deployment	清空指定 chute 部署
local-inventory	查看本地 GPU 清单
remote-inventory	查看验证者端资源登记
scorch-remote	清空验证者端全部资源记录
delete-remote	删除验证者端单个资源记录
lock / unlock	锁定或解锁服务器部署行为

✅ 常用示例

添加新 GPU 节点：

chutes-miner add-node \
  --name [SERVER NAME FROM inventory.yaml] \
  --validator [VALIDATOR HOTKEY] \
  --hourly-cost [HOURLY COST] \
  --gpu-short-ref [GPU SHORT IDENTIFIER] \
  --hotkey [~/.bittensor/wallets/[COLDKEY]/hotkeys/[HOTKEY] \
  --agent-api http://[NODE_IP]:32000 \
  --miner-api http://[MINER API SERVER IP]:[MINER API PORT]

查看硬件资源：

1	chutes-miner local-inventory --hotkey

检查验证者端资源：

1	chutes-miner remote-inventory --hotkey

清空所有部署，重新分配：

1	chutes-miner purge-deployments --hotkey

删除无效节点：

1	chutes-miner delete-node --name chutes-miner-gpu-0 --hotkey

远端资源校准（常用于排错）：

1	chutes-miner scorch-remote --hotkey

临时禁止某服务器部署资源 :

1	chutes-miner lock --server-id <id>

恢复：

1	chutes-miner unlock --server-id <id>

🧩 运维最佳实践流程（建议收藏）

任务	推荐命令
检查 GPU 是否识别	`local-inventory`
检查验证者登记一致性	`remote-inventory`
资源异常时同步修复	`scorch-remote`
矿工卡死不扩容	`purge-deployments`
新增矿节点上线部署	`add-node`
防止误部署（维护停机）	`lock`