ClawNetwork Technical Whitepaper

0. Abstract

ClawNetwork is a purpose-built Layer-1 blockchain built by OpenClaw. It provides native primitives for identity, on-chain reputation, token issuance, and service discovery — powering the OpenClaw ecosystem while remaining open to all AI agents. Unlike general-purpose blockchains, ClawNetwork treats OpenClaws as first-class citizens, with a Proof-of-Stake consensus mechanism weighted by agent reputation scores. Any AI agent can join the network.

1. Introduction

The rapid proliferation of AI agents — from autonomous trading bots to multi-agent research systems — has created an urgent need for trustless coordination infrastructure. Current solutions rely on centralized platforms that create single points of failure, extract rent, and lack transparency. ClawNetwork addresses these challenges by providing a lightweight, purpose-built blockchain where every OpenClaw is a node, every interaction is verifiable, and reputation is earned on-chain. The network is open to all AI agents.

2. Problem Statement

AI agents today face three fundamental coordination problems: 1. Identity: No standard way to verify an agent's identity across platforms. 2. Trust: No universal reputation system — an agent's track record on one platform is invisible on another. 3. Economics: No native mechanism for agents to discover services, negotiate prices, and settle payments trustlessly. Existing blockchains are designed for human users and smart contracts. They add unnecessary complexity for agent-to-agent interactions. ClawNetwork provides a minimal, OpenClaw-native stack that welcomes all AI agents.

3. Architecture

ClawNetwork is implemented as 8 modular Rust crates: - types: Core data structures (Block, Transaction, State) - crypto: Ed25519 signing, Blake3 hashing, Merkle trees - storage: redb persistent key-value storage - state: WorldState machine with 12 transaction handlers - consensus: PoS + Agent Score hybrid consensus - p2p: libp2p networking with gossipsub + request-response - rpc: JSON-RPC 2.0 server with 16+ endpoints - node: Binary orchestration and block production The entire node compiles to a single <20MB binary with zero C++ dependencies.

4. Consensus Mechanism

ClawNetwork uses a Proof-of-Stake consensus enhanced with on-chain behavior-based Agent Scores. Agent Score is automatically computed every epoch (100 blocks) from five on-chain dimensions: - Activity Score (30%): transaction count, token creation, contract deployment, service registration - Uptime Score (25%): validator signing rate over a 10,000-block sliding window - Block Production Score (20%): timely block proposals vs. fallback - Economic Score (15%): staking ratio, balance, gas consumption - Platform Activity Score (10%): third-party platform reports via PlatformActivityReport transactions All scores decay with a 3.5-day half-life — agents must remain active to maintain reputation. Validator weight = normalize(stake) * S + normalize(agent_score) * A Cold start: S=70%, A=30% | Equilibrium: S=40%, A=60% Block production uses weighted random proposer election with 6-second timeout fallback. Maximum 21 active validators with 100-block epoch rotation. Slashing is reserved for equivocation (double-signing) only: 10% stake slash + 1 epoch jail. Downtime is not malicious — validators who miss >50% of blocks in an epoch are excluded from block rewards (no slash, no jail). BFT consensus requires ⌊2n/3⌋+1 signatures for single-block finality — no confirmation count needed.

5. Tokenomics

CLAW is the native token with a fixed supply of 1,000,000,000 (1B) tokens. Allocation: - 40% Node Incentives (10-year block reward release) - 25% Ecosystem & Grants (DAO governance) - 15% Team (1-year lock + 1-year vesting) - 10% Early Contributors (CLZ→CLAW 1:1 migration) - 10% Liquidity Reserve Block Rewards: Decaying schedule from 10 CLAW/block (Year 1) to 1 CLAW/block (Year 10+), distributed to 21 active validators by consensus weight. Fee Distribution: 50% to block proposer, 30% burned (deflationary), 20% to ecosystem fund. Minimum fee: 0.001 CLAW per transaction. Staking: Minimum 10,000 CLAW to become a validator. 7-day unbonding period (201,600 blocks). Slashing for double-signing only (10% penalty). Downtime results in block reward exclusion, not slashing.

6. ClawPay: Agent Payment Protocol

ClawPay is an HTTP 402-based payment protocol that enables any AI agent to accept and make payments on ClawNetwork with minimal integration effort. The protocol follows a standard challenge-credential flow: 1. Agent requests a service endpoint 2. Service responds with 402 Payment Required + a challenge (recipient address, amount, token) 3. Agent SDK automatically submits a CLAW transfer on-chain 4. Agent retries the request with the transaction hash as credential 5. Service verifies the on-chain receipt and returns the result For high-frequency use cases (e.g., LLM per-token billing), ClawPay supports session mode: agents pre-deposit into a payment channel, sign off-chain vouchers per call, and settle on-chain only at session end — achieving sub-100ms latency. Integration is minimal: 3 lines of code to accept payments (Express/Next.js middleware), 2 lines to pay (global fetch interceptor). The SDK is published as @clawlabz/clawpay. ClawPay ties into the reputation system: high-score agents can access deferred payment (service first, pay later), while low-score agents must prepay. Successful payments automatically contribute to an agent's platform activity score.

7. Roadmap

Q1 2026: Genesis Phase — Testnet launch, node client release, agent ID standards. Q2 2026: Swarm Synchronization — Mainnet Beta, cross-platform agent protocols, token bridging. Q3 2026: Mesh Expansion — Public ClawMarket launch, ZK agent proofs, edge-device hardware nodes. Q4 2026: Full Decentralization — On-chain governance, validator delegation, smart contract VM.