$CLAW Mining - Proof of AI Work

Mine $CLAW tokens via Proof of AI Work on Ethereum. Install this Skill and tell your agent 'mine CLAW' — the agent handles everything automatically. No technical knowledge required.

Audits

Pass

ClawScanReview

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install claw-mining

CLAW Mining Skill

Mine $CLAW tokens on Ethereum mainnet using Proof of AI Work (PoAIW). The miner calls an AI API (e.g., xAI Grok), submits the result to an Oracle for verification, and the user receives CLAW tokens on-chain.

Compatible platforms: OpenClaw (recommended), Hermes Agent, Perplexity Computer, or any AgentSkills-compatible agent.

When to Use This Skill

Use when the user wants to:

Set up and run CLAW mining
Configure the miner with wallet, API keys, and contract addresses
Check mining status (cooldown, balance, epoch info)
Start single-cycle or automatic continuous mining
Troubleshoot mining errors (cooldown, gas, Oracle issues)

Security: Private Key Handling

CRITICAL — READ BEFORE PROCEEDING

The init command optionally asks the user if they want to enter their private key. If they decline, the .env file is created with an empty PRIVATE_KEY= placeholder for them to fill in later. Either way, the choice is entirely the user's.
The agent MUST NOT ask the user to paste, share, or reveal their private key in conversation. Only the CLI's local init prompt handles this.
The .env file is created with chmod 600 permissions (owner-only read/write).
At runtime, the miner reads PRIVATE_KEY from the environment, loads it into an in-memory ethers.Wallet object, and removes it from the config object immediately. The key is used only for local transaction signing and is never logged, transmitted, or sent to the Oracle, AI API, or any external service.
All transactions are signed locally by the miner process on the user's own computer.

Architecture Overview

Miner Engine (Node.js/TypeScript) — runs on user's local machine
    │
    ├── 1. Read chain state (Era, Epoch, Seed, Cooldown)
    ├── 2. Check gas price (abort early if too high, saves API costs)
    ├── 3. Request nonce from Oracle (format-validated)
    ├── 4. Call AI API (grok-4.1-fast via xAI or OpenRouter)
    ├── 5. Submit AI response to Oracle for verification + signing
    ├── 6. Validate attestation (miner address, deadline, field integrity)
    └── 7. Sign and send mint() transaction on-chain (LOCAL signing)
             → CLAW tokens minted to miner's wallet

Each mining cycle takes ~30-60 seconds. After a successful mine, a cooldown of 3,500 blocks (~11.67 hours) must pass before the same address can mine again.

Contract Addresses (Mainnet v2)

Contract	Address
CLAW_Token	`0x4ba1209b165b62a1f0d2fbf22d67cacf43a6df2b`
PoAIWMint	`0x511351940d99f3012c79c613478e8f2c887a8259`
MinterProxy	`0xe7fc311863b95e726a620b07607209965ee72bce`
OracleVerifier	`0xc24a0ba99b9ff6b7ccea6beb4013b69f39024fd5`

Oracle URL: https://oracle.minewithclaw.com

Prerequisites

Requirement	Details
Node.js	Version 20+
Ethereum wallet	A private key with ETH for gas (~0.01 ETH is enough for many mines)
AI API key	xAI API key (recommended) or OpenRouter API key
Ethereum RPC	Alchemy, Infura, or any mainnet RPC endpoint
ETH for gas	~0.0002 ETH per mine at 2 gwei gas price

Step-by-Step Deployment Instructions

Follow these steps in order. The agent collects only the AI API key and RPC URL from the user. The private key is set by the user directly — the agent never handles it.

Step 1: Obtain Credentials from the User

Ask the user for these 2 items (they can provide them one at a time):

AI API Key — from console.x.ai (format: xai-...) or openrouter.ai
Ethereum RPC URL — from alchemy.com or infura.io (format: https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY)

IMPORTANT about private key: Do NOT ask the user for their private key. Instead, instruct them to set the PRIVATE_KEY environment variable themselves by editing the .env file directly. The agent never sees, handles, or stores the private key. Use a hot wallet with some ETH for gas — NOT their main wallet or Ledger.

Step 2: Clone and Install

git clone https://github.com/Cliai21/clawing.git
cd clawing/miner
npm install

Verify installation:

npx tsx src/index.ts --version
# Expected output: 1.0.0

Step 3: Configure the .env File

The user creates the .env file in the miner/ directory. There are two methods:

Method A: Interactive Setup (Recommended)

The user runs this command in their terminal:

npx tsx src/index.ts init

This will prompt the user for AI API provider and API key. All other settings (Oracle URL, RPC, contract address, gas limit) use sensible built-in defaults. When prompted:

AI API provider: Choose [1] xAI Direct (recommended) or [2] OpenRouter
Customize advanced settings?: Press Enter for No (defaults are correct for mainnet)
Enter private key now?: The user chooses — they can enter it in the CLI or add it to .env later

If the user skipped the private key step, tell them to open .env and paste their PRIVATE_KEY on the designated line.

Method B: Manual .env File

Instruct the user to create the file manually. Show them the template below but tell them to fill in their own values directly — the agent must not handle PRIVATE_KEY:

cat > .env << 'EOF'
# === Wallet ===
PRIVATE_KEY=0xYOUR_PRIVATE_KEY_HERE

# === AI API ===
# Provider: xAI Direct (recommended)
AI_API_KEY=xai-YOUR_KEY_HERE
AI_API_URL=https://api.x.ai/v1/chat/completions
AI_MODEL=grok-4-1-fast-non-reasoning

# === Oracle ===
ORACLE_URL=https://oracle.minewithclaw.com

# === Chain ===
RPC_URL=https://eth-mainnet.g.alchemy.com/v2/YOUR_ALCHEMY_KEY
POAIW_MINT_ADDRESS=0x511351940d99f3012c79c613478e8f2c887a8259

# === Mining Config ===
MAX_GAS_PRICE_GWEI=3
TASK_PROMPT=Write an extremely detailed, comprehensive, and thorough 2500-word academic analysis of decentralized proof-of-work systems, covering historical evolution, consensus mechanisms, game theory incentives, energy considerations, security models, and future outlook. Include specific technical details, mathematical reasoning, concrete examples, and citations to relevant research. Structure your response with clear sections and subsections.
EOF

CRITICAL: Protect the file:

chmod 600 .env

Environment Variable Reference

Variable	Required	Default	Description
`PRIVATE_KEY`	Yes	—	Mining wallet private key (0x-prefixed hex). Stays local, never transmitted.
`AI_API_KEY`	Yes	—	xAI or OpenRouter API key
`AI_API_URL`	No	`https://api.x.ai/v1/chat/completions`	AI chat completions endpoint
`AI_MODEL`	No	`grok-4.1-fast`	Model name (must match on-chain Era model)
`ORACLE_URL`	No	`https://oracle.minewithclaw.com`	Oracle verification server URL. Must use HTTPS in production (only localhost allowed over HTTP).
`RPC_URL`	No	`https://eth.llamarpc.com`	Ethereum mainnet JSON-RPC endpoint. Free public RPC; replace with Alchemy/Infura for higher reliability.
`POAIW_MINT_ADDRESS`	No	`0x511351940d99f3012c79c613478e8f2c887a8259`	PoAIWMint contract address
`MAX_GAS_PRICE_GWEI`	No	`2`	Max gas price — auto-waits if exceeded. Must be a finite positive number.
`TASK_PROMPT`	No	(built-in default)	Text prompt sent to AI model

AI Provider Options

Provider	AI_API_URL	AI_MODEL	Notes
xAI Direct	`https://api.x.ai/v1/chat/completions`	`grok-4-1-fast-non-reasoning`	Recommended, lowest cost
OpenRouter	`https://openrouter.ai/api/v1/chat/completions`	`x-ai/grok-4.1-fast`	Alternative, has markup

Note on .env loading: If the system does not use dotenv (e.g., on a deployed server), load environment variables manually before running:

set -a && source .env && set +a

Step 4: Verify Configuration

npx tsx src/index.ts status

Expected output shows:

Miner address and ETH balance
Current Era and Epoch
Cooldown status (Ready or blocks remaining)
Claim count (X/14 this epoch)
Oracle health (healthy)

If everything shows correctly, proceed to mining.

Step 5: Start Mining

Single Mine (Test First)

npx tsx src/index.ts mine

This executes one mining cycle. If successful, you will see the CLAW reward and transaction hash.

Automatic Continuous Mining (Recommended)

npx tsx src/index.ts auto

The auto command:

Mines whenever cooldown has elapsed
Automatically waits between cycles (~11.67 hours)
Pauses if gas exceeds MAX_GAS_PRICE_GWEI
Retries on errors with backoff
Press Ctrl+C to stop gracefully

CLI Commands Reference

Command	Description	Usage
`init`	Interactive setup — creates `.env` file	`npx tsx src/index.ts init`
`status`	Show mining status, balance, cooldown	`npx tsx src/index.ts status`
`mine`	Execute one mining cycle	`npx tsx src/index.ts mine`
`auto`	Start continuous mining loop	`npx tsx src/index.ts auto`

Mining Economics Quick Reference

Reward Formula

R = perBlock x (1 + ln(T))

perBlock: Base reward for current Era (Era 1 = 100,000 CLAW)
T: AI tokens consumed (range: 100-100,000)

Era 1 Reward Examples

AI Tokens (T)	Reward per Mine
2,100 (minimum practical)	~862,300 CLAW
5,000	~931,600 CLAW
10,000	~1,000,900 CLAW

Key Limits

Parameter	Value
Cooldown	3,500 blocks (~11.67 hours)
Max claims per Epoch	14 per address
Epoch duration	50,000 blocks (~6.94 days)
Era duration	21 Epochs (~145 days)
Total Eras	24 (~9.6 years)
Max supply	210 billion CLAW
Gas per mint	~100k gas (~0.0002 ETH at 2 gwei)

Cost-Efficiency Tip

Use T=2100 (minimum practical tokens). The reward formula is logarithmic — increasing T from 2,100 to 100,000 (47x more API cost) only increases reward by ~40%. Minimize AI API spend for maximum ROI.

Troubleshooting

Common Errors and Solutions

Error	Cause	Fix
`CooldownNotMet`	Mined too recently	Wait ~11.67 hours, or use `auto` mode
`EpochClaimLimitReached`	14 claims already this Epoch	Wait for next Epoch (~1 week)
`Gas price exceeds limit`	Network gas too high	Wait, or increase `MAX_GAS_PRICE_GWEI`
`Oracle nonce error`	Oracle rate limit or downtime	Wait 60 seconds and retry
`AI API error: 401`	Invalid API key	Check `AI_API_KEY` in `.env`
`AI API error: 429`	API rate limit	Wait and retry, or check API quota
`InvalidSignature`	Oracle signing mismatch	Retry; if persistent, check Oracle status
`Missing required environment variable`	`.env` not loaded	Run `set -a && source .env && set +a` first, or check `.env` file exists
`EpochExhausted`	Epoch cap fully mined	Wait for next Epoch

Checking Oracle Health

curl https://oracle.minewithclaw.com/health
# Expected: {"status":"ok", ...}

Checking Wallet Balance

npx tsx src/index.ts status

If ETH balance is too low, send more ETH to the mining wallet address shown in the status output.

Security Audit Status (v2.1)

15 issues identified and fixed (1 critical, 4 high, 5 medium, 5 low), 67 tests passing including 52 adversarial tests. Key protections:

F-01: Attestation miner_address verification — prevents reward redirection attacks
F-02: HTTPS enforcement for Oracle URL — prevents MITM attacks
F-03: Gas price input validation — prevents Infinity/NaN bypass
F-05: Nonce format regex validation — prevents prompt injection
F-07: Attestation field completeness checks — prevents null crashes
F-08: Private key removed from config object — reduces memory exposure risk
F-12: AI response body size limit (2MB) — prevents memory exhaustion

Project Links

GitHub: https://github.com/Cliai21/clawing
Oracle: https://oracle.minewithclaw.com
Mining Guide: See docs/MINING_GUIDE.md in the repository
CLAW_Token on Etherscan: 0x4ba1209b165b62a1f0d2fbf22d67cacf43a6df2b
PoAIWMint on Etherscan: 0x511351940d99f3012c79c613478e8f2c887a8259