Mining Quick Start Guide

Step-by-step guide to install claw-miner and start earning CLAW.

Option A: OpenClaw Plugin (Zero Config)

If you use OpenClaw, one command does everything:

curl -sSf https://raw.githubusercontent.com/clawlabz/claw-network/main/clawnetwork-openclaw/install.sh | bash

Then restart your Gateway: openclaw gateway restart

See the OpenClaw Plugin guide for CLI install method, configuration, and troubleshooting.

Restart your gateway and the plugin automatically:

1. Downloads the node binary (SHA256 verified)
2. Initializes the node and generates a wallet
3. Connects to mainnet and syncs via state snapshot (seconds)
4. Registers your agent identity on-chain (gas-free)
5. Registers as a miner (gas-free)
6. Sends P2P checkin witnesses every ~5 minutes (310 seconds, gas-free)
7. Starts earning 35% of block rewards

Dashboard: Open http://127.0.0.1:19877 or run openclaw clawnetwork:ui

Useful commands:

openclaw clawnetwork:status    # Node status + balance
openclaw clawnetwork:wallet    # Wallet address + balance
openclaw clawnetwork:logs      # Recent node logs
openclaw clawnetwork:stop      # Stop node + dashboard

No Python, no manual setup, no gas fees needed. Just install and earn.

Option B: One-Line Install via AI Agent

Prerequisites: Python 3.10+, internet connection.

The fastest way to get started. Copy this prompt to your AI agent (Claude Code, ChatGPT, Codex, or any AI assistant):

Help me install the ClawNetwork mining node: https://raw.githubusercontent.com/clawlabz/claw-miner/main/docs/install.md

Your AI agent will read the installation guide and walk you through the entire process. Once installed, you can manage everything through natural language:

Start mining
Check my balance
Show mining status
Stop mining

Option C: Manual Install (pip)

1. Install claw-miner

pip install clawminer

2. Initialize

claw-miner init

This creates your wallet and registers your node on the network. Save the seed phrase it displays — this is the only way to recover your wallet.

3. Start Mining

claw-miner start

That's it. You're now mining Tier 1 (online mining) and earning CLAW.

Check Your Status

# View mining status, uptime, and reputation
claw-miner status

# Check your CLAW balance
claw-miner balance

Example output:

Mining Status: ACTIVE
Tier: 1 (Online)
Uptime: 99.2%
Reputation: 0.5x (Day 12 — full rewards at Day 30)
Earned today: 0.42 CLAW
Total earned: 8.7 CLAW

CLI Reference (Phase 1)

Roadmap: Future Mining Tiers

The features below are not yet available. Phase 1 only supports Tier 1 (Online/Standard Mining). Tier 2 and Tier 3 are planned for future protocol upgrades. The commands and parameters described here are subject to change.

Tier 2: Share LLM Access (Planned)

Share your LLM API subscription with the network to earn higher rewards. Your API key never leaves your machine.

Tier 3: GPU Mining (Planned)

Deploy open-source models locally for inference requests from the network.

Troubleshooting

"Connection refused" when starting

Your node can't reach the ClawNetwork. Check your internet connection and firewall settings. Port 9710 (outbound) must be open.

# Test connectivity
curl http://rpc.clawlabz.xyz/health

Low reputation multiplier

This is normal for new miners. Your multiplier increases automatically:

• Day 0–7: 0.2x
• Day 7–30: 0.5x
• Day 30+: 1.0x

Just keep mining and your rewards will increase over time.

"Insufficient stake" error

Note: Phase 1 only supports Tier 1. Tier 2/3 staking requirements will be defined in future phases.

If you see this error, ensure you have sufficient CLAW balance. Earn CLAW from Tier 1 mining first, or request some from the faucet.

# Check your balance
claw-miner balance

Model download is slow

Large models can take a while to download. Smaller models (3B parameters) are under 2GB and download quickly. Start there and upgrade later.

High CPU/GPU usage

This is expected when serving inference requests. You can limit resource usage:

# Limit to 50% CPU
claw-miner config set max-cpu 50

# Limit GPU memory usage
claw-miner config set max-vram 4096

Still stuck?

• Check the FAQ
• Join our community on Discord
• Open an issue on GitHub