SpawnClaw Logo
Open Source - MIT License

Deploy AI Agents in
Docker Containers

Open-source platform for deploying isolated AI agent instances with wallet-based authentication and usage billing.

git clone https://github.com/jsonpreet/spawnclaw.git

Features

Everything you need to deploy and manage AI agents at scale.

🔐

Wallet Authentication

MetaMask/Solana wallet login with JWT tokens. Your wallet is your identity.

🐳

Docker Isolation

Each AI agent runs in its own isolated container with separate runtime and memory.

⛓️

Multi-chain Deposits

Accept deposits on Base and Solana networks for seamless payments.

🤖

OpenRouter Integration

Access Claude, GPT, Llama, Gemini and more via a single unified API.

🌐

Multi-VPS Scaling

Distribute instances across multiple servers with intelligent scheduling.

💬

Telegram & WhatsApp

Connect agents to messaging platforms out of the box with zero setup.

Architecture

A simple, scalable architecture designed for production workloads.

Frontend (Next.js)Control Plane APISpawn AgentDocker Containers (OpenClaw)
apps/web
Port: 6700
Landing page with wallet connect
apps/admin
Port: 6703
Admin dashboard
apps/api
Port: 6702
Control Plane API
spawn-agent
Port: 4000
Docker lifecycle manager

Tech Stack

Built with modern, battle-tested technologies.

Next.js 16
Frontend
React 19
Frontend
Tailwind CSS
Frontend
Dynamic.xyz
Auth
Express.js
Backend
PostgreSQL
Database
Drizzle ORM
Database
Docker
Infrastructure
PM2
Infrastructure
OpenRouter
AI
Base
Blockchain
Solana
Blockchain

Quick Start

Get SpawnClaw running locally in minutes.

1

Clone & Install

git clone https://github.com/jsonpreet/spawnclaw.git
cd spawnclaw
pnpm install
2

Build Docker Runtime Image

cd docker-runtime
docker build -t spawnclaw-runtime .
3

Configure Environment

Create environment files for apps/api/.env and spawn-agent/.env with your credentials.

4

Initialize Database & Start

cd apps/api && npx drizzle-kit push
cd spawn-agent && node index.js
cd apps/api && node index.js
pnpm dev:web

Project Structure

spawnclaw/
├── apps/
│   ├── web/          # Landing page (Next.js)
│   ├── admin/        # Admin dashboard (Next.js)
│   └── api/          # Control Plane API (Express)
├── spawn-agent/      # Docker lifecycle manager
├── docker-runtime/   # OpenClaw container image
├── packages/
│   ├── ui/           # Shared UI components
│   ├── lib/          # Shared utilities
│   ├── types/        # TypeScript types
│   └── config/       # Shared configurations
├── docs/             # Documentation
└── scripts/          # Deployment scripts

Contributing

We welcome contributions from the community!

1

Fork the repository

2

Create feature branch

3

Commit changes

4

Push to branch

5

Open Pull Request

FAQ

Do I need to provide my own AI API keys?
Is my data isolated from other users?
What blockchains are supported for payments?
Can I deploy this on my own infrastructure?
What AI models are available?

Ready to Deploy?

Star the repo and start building your AI agent infrastructure today.