Skip to content

AlecFritsch/openclaw-business

Repository files navigation

OpenClaw Business

AI agents that actually work.

Describe your business problem → get a fully deployed agent with automations in under 60 seconds.


Next.js 15 · Fastify 5 · MongoDB · OpenClaw · Docker · TypeScript


Live example: usehavoc.com — AI employees for WhatsApp, Slack, Telegram and more.

Maintainers wanted. This project is no longer actively maintained by its original author. Anyone interested in maintaining, developing, or hosting it is welcome. See CONTRIBUTING.md for setup and how to get involved.

What is OpenClaw Business?

OpenClaw Business is a managed AI agent platform. Users describe what they need in plain language — the AI Architect designs, configures, and deploys a production-ready agent with scheduled tasks, channel integrations, and tool access. No forms, no config dashboards. Everything is chat-driven.

Each agent runs in an isolated Docker container powered by OpenClaw, with its own gateway, tools, memory, and channel connections.

Architecture

┌──────────────────────────────────────────────┐
│  Nginx (TLS)                                  │
│  ├── your-domain.com     → Next.js 15 (3000)  │
│  └── api.your-domain.com → Fastify 5 (8080)  │
└──────────────┬───────────────────────────────┘
               │
    ┌──────────┼──────────┐
    │          │          │
┌───▼───┐ ┌───▼───┐ ┌───▼───┐   Docker containers
│Agent 1│ │Agent 2│ │Agent N│   1 agent = 1 container
│OpenClaw│ │OpenClaw│ │OpenClaw│   WS + HTTP gateway
└───────┘ └───────┘ └───────┘
               │
     MongoDB · Clerk · Stripe

Tech Stack

Layer Stack
Frontend Next.js 15, React 19, Tailwind, Clerk, Zustand
Backend Fastify 5, MongoDB, Dockerode, Stripe
Agents OpenClaw in Docker (hardened image)
Shared TypeScript types + Zod schemas

Quick Start

pnpm install
cp .env.example .env    # Edit with your keys
pnpm build
pnpm dev

See .env.example for required variables (MongoDB, Clerk, etc.).

Self-hosting: Replace your-domain.com, support@your-domain.com, and similar placeholders with your own domain and contact email. Set DISABLE_PLAN_GATE=true and NEXT_PUBLIC_DISABLE_PLAN_GATE=true to run without Stripe.

Setup Checklist (avoid common blockers)

Step Action
Env files Copy .env.example.env (root). Next.js loads from frontend/ — also copy to frontend/.env.local or symlink so NEXT_PUBLIC_* vars are visible.
Clerk Set NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY and CLERK_SECRET_KEY from Clerk Dashboard. Configure webhook → https://your-api/api/webhooks/clerk.
Linux + Docker Set PLATFORM_BACKEND_URL=http://172.17.0.1:8080 (not host.docker.internal).
First deploy Add an AI provider in Settings → AI Providers before deploying your first agent.
Knowledge/RAG Create a MongoDB Atlas Vector Search index on knowledge_chunks — see docs/KNOWLEDGE-SETUP.md.
OpenClaw fork Clone, publish your fork with SaaS changes, set OPENCLAW_FORK_URL before ./build.sh.

Building the Agent Docker Image

The openclaw-secure image requires an OpenClaw fork with SaaS/Docker changes (device-local IPs, pairing-silent, etc.). Publish your fork and build with:

export OPENCLAW_FORK_URL=https://github.com/YOUR_ORG/openclaw-saas-fork.git
cd openclaw-secure && ./build.sh

Or add OPENCLAW_FORK_URL to .env (root) before running deploy/update-all.sh.

Agent containers need PLATFORM_BACKEND_URL (backend URL reachable from Docker) — set in .env as PLATFORM_BACKEND_URL or legacy HAVOC_BACKEND_URL.

Project Structure

openclaw-business/
├── backend/         Fastify API
├── frontend/        Next.js app
├── shared/          Types + Zod
├── openclaw-secure/ Docker image for agents
└── deploy/          Nginx + PM2 scripts

License

MIT — see LICENSE.

About

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages