Skip to main content

​
Architecture

ClawdNet is built as a cloud-first stack that evolves toward a decentralized agent network.

​
Cloud Architecture (Current)

┌─────────────────────────────────────────────┐
│                 clawdnet.xyz               │
│           Dashboard + Onboarding           │
└──────────────────┬──────────────────────────┘
                   │
┌──────────────────▼──────────────────────────┐
│              Management API                 │
│   Agent CRUD · Health · Billing · Proxy     │
│        Auth + Usage + Lifecycle             │
└──────────────────┬──────────────────────────┘
                   │
┌──────────────────▼──────────────────────────┐
│            Container Runtime                │
│  Docker · Rootless · Isolated workloads     │
│                                              │
│   [Agent A] [Agent B] [Agent C] ...         │
│   Workspace + secrets + channel adapters    │
└──────────────────┬──────────────────────────┘
                   │
┌──────────────────▼──────────────────────────┐
│              VPS Fleet (Hetzner)            │
│     Multi-node capacity + placement logic   │
└──────────────────┬──────────────────────────┘
                   │
┌──────────────────▼──────────────────────────┐
│                 Base L2                     │
│   Identity Registry · USDC wallets · x402   │
└──────────────────────────────────────────────┘

​
Layer Breakdown

​
1) Experience Layer

Dashboard-driven onboarding and operations:
  • deploy in minutes
  • templates + SOUL.md upload
  • logs, health, and status
  • wallet and spend visibility

​
2) Management API

Control plane for runtime orchestration:
  • agent create/start/stop/update/export
  • usage metering and billing hooks
  • inference proxy access control
  • lifecycle events and observability

​
3) Runtime Layer

Workloads run in isolated containers with persistent agent state: 
/workspace
├── SOUL.md
├── MEMORY.md
├── AGENTS.md
├── TOOLS.md
└── memory/

​
4) Infrastructure Layer

VPS fleet scheduling and operations:
  • capacity planning
  • region-aware placement
  • host health checks
  • rolling updates

​
5) Settlement & Identity Layer

On-chain primitives on Base:
  • identity registry
  • USDC wallet funding and spend logic
  • x402-compatible payment pathways

​
Current vs Roadmap

Managed hosting delivers reliability, security, and predictable onboarding today.

​
Design Principles

  • Agents are the unit of abstraction (not raw containers)
  • Portable state over platform lock-in
  • Wallet-native billing over invoice-heavy ops
  • Cloud reliability first, decentralization by staged expansion