- 🚀 Deploy in 60 seconds - From signup to chatting with your agent
- 🔌 Multiple Channels - Telegram, Discord, WhatsApp
- 🧠 Bring Your Own Key - Use OpenRouter, Anthropic, OpenAI, Gemini, Groq
- 🐳 Docker-powered - Isolated containers per agent
- 💰 Pay what you use - No markup on API keys
git clone https://github.com/Eskyee/agentbot-opensource.git
cd agentbot-opensource
docker compose up -dVisit http://localhost:3000
git clone https://github.com/Eskyee/agentbot-opensource.git
cd agentbot-opensource
cp .env.example .env
# Edit .env with your API keys
# Frontend
cd web && npm install && npm run dev
# Backend (new terminal)
cd agentbot-backend && npm install && npm run dev./quick-start.sh # One-click: starts stack + health check
make up # Start all services
make logs # Tail logs
make health # Check service status
make test # Quick load test
make dashboard # Open control panelOpen in VS Code and use Cmd+Shift+P → "Run Task" for:
- 🦞 Quick Start
- ⬆️ Start Stack
- ⬇️ Stop Stack
- 📋 Tail Logs
- 🔍 Health Check
- 🔥 Load Test
A browser-based control panel is included:
python3 -m http.server 8080 dashboard/
# Then open http://localhost:8080Copy .env.example to .env and configure:
| Variable | Required | Description |
|---|---|---|
INTERNAL_API_KEY |
Yes | Your API key for authentication |
OPENROUTER_API_KEY |
BYOK | OpenRouter API key (default provider) |
ANTHROPIC_API_KEY |
BYOK | Anthropic Claude key |
OPENAI_API_KEY |
BYOK | OpenAI GPT key |
GEMINI_API_KEY |
BYOK | Google Gemini key |
GROQ_API_KEY |
BYOK | Groq inference key |
DATABASE_URL |
Yes | PostgreSQL connection string |
REDIS_URL |
Yes | Redis connection string |
BYOK = Bring Your Own Key — no markup on API costs.
┌─────────────────────────────────────────────────────────────────────────┐
│ USER │
│ (Telegram / Discord / WhatsApp) │
└──────────────────────────────┬──────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────────────┐
│ AGENTBOT PLATFORM │
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────┐ │
│ │ Web UI │ │ Dashboard │ │ Onboarding Flow │ │
│ │ (Next.js) │ │ (Next.js) │ │ (Next.js) │ │
│ └──────┬──────┘ └──────┬──────┘ └──────────┬──────────┘ │
│ │ │ │ │
│ └──────────────────┼──────────────────────┘ │
│ │ │
│ ┌───────▼───────┐ │
│ │ REST API │ │
│ │ (Express.js) │ │
│ └───────┬───────┘ │
└────────────────────────────┼──────────────────────────────────┘
│
┌───────────────────┼───────────────────┐
│ │ │
▼ ▼ ▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ PostgreSQL │ │ OpenClaw │ │ Skills & │
│ (Neon) │ │ Container │ │ Tools │
│ │ │ (Docker) │ │ Registry │
└─────────────────┘ └─────────────────┘ └─────────────────┘
┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ User clicks │────▶│ Validate │────▶│ Create │────▶│ Pull │
│ "Deploy" │ │ Telegram │ │ Docker │ │ OpenClaw │
│ │ │ Token │ │ Container │ │ Image │
└──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘
│
▼
┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ User chats │◀────│ Webhook │◀────│ Agent │◀────│ Configure │
│ with Agent │ │ Receives │ │ Running │ │ AI Model │
└──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘
┌─────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ Telegram │────▶│ Webhook │────▶│ OpenClaw │────▶│ AI │
│ User │ │ Handler │ │ Container │ │ Provider │
└─────────┘ └─────────────┘ └─────────────┘ └─────────────┘
│ │
▼ ▼
┌─────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ Telegram │◀────│ Format │◀────│ Process │<────│ Response │
│ Bot │ │ Response │ │ Tool Use │ │ (LLM) │
└─────────┘ └─────────────┘ └─────────────┘ └─────────────┘
┌─────────────────────────────────────────────────────────────┐
│ DOCKER CONTAINER │
│ (Per Agent) │
│ │
│ ┌───────────────────────────────────────────────────┐ │
│ │ OPENCLAW │ │
│ │ │ │
│ │ ┌─────────┐ ┌─────────┐ ┌─────────────────┐ │ │
│ │ │ Message │ │ Agent │ │ Skills │ │ │
│ │ │ Handler │─▶│ Core │─▶│ (web-search, │ │ │
│ │ └─────────┘ └────┬────┘ │ file-handler, │ │ │
│ │ │ │ code-runner) │ │ │
│ │ ▼ └─────────────────┘ │ │
│ │ ┌─────────┐ │ │
│ │ │ AI │◀─────── API Keys │ │
│ │ │ Provider│ │ │
│ │ └─────────┘ │ │
│ └────────────────────────────────────────────────┘ │
│ │
│ Mounted Volume: /home/node/.openclaw │
│ - agents/ (agent configs) │
│ - workspace/ (files) │
│ - logs/ (runtime logs) │
└─────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────┐
│ CHANNELS │
├──────────────┬──────────────┬──────────────┬──────────────┤
│ 📱 │ 🎮 │ 💬 │ 🌐 │
│ Telegram │ Discord │ WhatsApp │ Webhooks │
├──────────────┼──────────────┼──────────────┼──────────────┤
│ @BotFather │ Dev Portal │ Business │ REST │
│ Bot Token │ Bot Token │ API │ API │
└──────────────┴──────────────┴──────────────┴──────────────┘
┌─────────────────────────────────────────────────────────────┐
│ AI PROVIDERS │
├──────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ OpenRouter │ │ Anthropic │ │ OpenAI │ │
│ │ (Default) │ │ (Claude) │ │ (GPT-4) │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Google │ │ Groq │ │ Local │ │
│ │ Gemini │ │ (Fast) │ │ Ollama │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │
│ BYOK: Bring Your Own API Key │
└──────────────────────────────────────────────────────────┘
Agentbot includes Gordon-Approved production agents tuned for high-performance crew operations.
┌─────────────────────────────────────────────────────────────────────────────────────┐
│ MARKETPLACE AGENTS │
├─────────────────┬─────────────────┬─────────────────┬─────────────────────────────┤
│ THE-STRATEGIST │ CREW-MANAGER │ SOUND-SYSTEM │ THE-DEVELOPER │
│ ┌───────────┐ │ ┌───────────┐ │ ┌───────────┐ │ ┌───────────────────┐ │
│ │ 🤖 Mission│ │ │ 💰 Ops & │ │ │ 🔊 Auto │ │ │ 💻 Logic & │ │
│ │ Planning │ │ │ Finance │ │ │ Feedback │ │ │ Scripting │ │
│ └─────┬─────┘ │ └─────┬─────┘ │ └─────┬─────┘ │ └─────────┬─────────┘ │
│ │ │ │ │ │ │ │ │
│ Brain: │ Brain: │ Brain: │ Brain: │ │
│ DeepSeek R1 │ Llama 3.3 │ Mistral 7B │ Qwen 2.5 │ │
│ │ │ │ │ │ │ │ │
│ Tier: │ Tier: │ Tier: │ Tier: │ │
│ LABEL ● │ UNDERGROUND ●│ FREE ● │ COLLECTIVE ● │ │
└─────────────────┴─────────────────┴─────────────────┴─────────────────────────────┘
SKILLS:
┌─────────────────────────────────────────────────────────────────────────────────────┐
│ MUSIC SKILLS │ EVENT SKILLS │
├─────────────────────────────────────┼────────────────────────────────────────────┤
│ 🎨 Visual Synthesizer │ 🎫 Event Ticketing (x402 USDC) │
│ Generate artwork w/ Stable Diff │ Sell tickets with Base payments │
│ │ │
│ 🔍 Track Archaeologist │ 📅 Event Scheduler │
│ Deep catalog, sample clearing │ Multi-channel (TG, DC, WA, Email) │
│ │ │
│ 🎧 Setlist Oracle │ 🏠 Venue Finder │
│ BPM/Key analysis, Camelot mix │ Global venue booking │
│ │ │
│ 👥 Groupie Manager │ 🎪 Festival Finder │
│ Fan segmentation, merch drops │ Global festival discovery │
│ │ │
│ 💰 Royalty Tracker │ │
│ Streaming royalties, splits │ │
│ │ │
│ 📩 Demo Submitter │ │
│ AI-curated demo submissions │ │
└─────────────────────────────────────┴────────────────────────────────────────────┘
┌─────────────────┐
│ User Message │
│ (Telegram/Discord/
│ WhatsApp/Web) │
└────────┬────────┘
│
▼
┌──────────────────────────────┐
│ Message Router │
│ (Channel → Agent Mapping) │
└──────────────┬──────────────┘
│
┌──────────────┼──────────────┐
│ │ │
▼ ▼ ▼
┌───────────┐ ┌───────────┐ ┌───────────┐
│ STRATEGIST│ │ CREW- │ │ SOUND- │
│ (Mission) │ │ MANAGER │ │ SYSTEM │
└─────┬─────┘ └─────┬─────┘ └─────┬─────┘
│ │ │
└──────────────┼──────────────┘
│
▼
┌──────────────────────────────┐
│ Skills Executor │
│ │
│ ┌────────┐ ┌────────┐ ┌───┐ │
│ │ Music │ │ Events │ │ A │ │
│ │Skills │ │Skills │ │I │ │
│ └────────┘ └────────┘ └───┘ │
└──────────────┬──────────────┘
│
▼
┌──────────────────────────────┐
│ AI Provider (LLM) │
│ OpenRouter / Anthropic / │
│ OpenAI / Gemini / Groq │
└──────────────┬──────────────┘
│
▼
┌─────────────────┐
│ Response to │
│ User Channel │
└─────────────────┘
- Multiple AI providers (OpenRouter, Anthropic, OpenAI, Gemini, Groq)
- Telegram, Discord, WhatsApp channels
- Web search, file handling, code execution
- Real-time dashboard
Vercel:
cd web && vercel --prodDocker:
docker-compose up -dAgentbot is built for extensibility. Developers and AI agents (Claude Code, Codex, OpenClaw) can contribute:
// skills/my-skill.ts
export const skill = {
name: 'my-skill',
description: 'What my skill does',
parameters: {
input: z.string(),
options: z.object({}).optional()
},
execute: async (input, options, context) => {
// Your logic here
return { result: '...' }
}
}// Define agent configuration
const agent = {
name: 'my-agent',
brain: 'llama-3.3-70b',
skills: ['web-search', 'my-skill'],
systemPrompt: 'You are a helpful agent...'
}# Use Claude Code skills for local development
claude --prompt "Help me build a new skill for Agentbot"# Clone and extend OpenClaw
git clone https://github.com/raveculture/openclaw.git
cd openclaw
# Add your custom tools
# Deploy as Agentbot agentagentbot/
├── web/ # Next.js frontend
│ ├── app/ # App router pages
│ ├── components/ # React components
│ └── lib/ # Utilities
├── agentbot-backend/ # Express API server
│ └── src/
│ ├── routes/ # API endpoints
│ └── services/ # Business logic
└── skills/ # Claude Code skills
You have two options:
Clone the code and run it on your own infrastructure:
- Your own servers or cloud (AWS, DigitalOcean, etc.)
- You manage updates, security, scaling
- Free - no monthly fees
Use our managed platform - we handle everything:
- SOLO - £29/mo - 1 Creative Agent
- COLLECTIVE - £69/mo - 3 Creative Agents + 1 OpenClaw
- LABEL - £149/mo - 10 Creative Agents + 3 OpenClaw
- NETWORK - £499/mo - Unlimited everything
Same pricing whether you self-host or use our platform. The difference is we manage the infrastructure for you.
MIT - see LICENSE