π¦ Corellis
April 7, 2026 Β· View on GitHub
We run a 28-lobster AI team that handles ops, marketing, releases, and weekly reports. This is the system behind it.
Turn one OpenClaw assistant into a self-managing AI workforce β lobsters that coordinate tasks, learn from their mistakes, and get better every week.
Production-tested since February 2026 Β· 28 lobsters Β· 50,000+ Slack messages indexed Β· 500+ self-corrections Β· single server
A Real Example
Last month we tested fleet-wide goal coordination for the first time. The founder typed one message:
"Launch a user acquisition campaign for the new product line."
Here's what happened over the next 2 hours β with zero human intervention after that single message:
- The controller decomposed the goal into 6 sub-goals and created a milestone + 7 tracking cards on the task board
- 6 lobsters were assigned β marketing, engineering, payments, ops, partnerships, frontend β each in a dedicated thread
- All 6 confirmed within minutes, following the goal-participant protocol: analyze scope β break into subtasks β define acceptance criteria
- Spontaneous cross-team coordination emerged β the payments lobster and the partnerships lobster started aligning on API design in their thread (4 rounds of back-and-forth). The marketing lobster and the ops lobster resolved scope boundaries on their own
- One lobster independently created 5 subtask cards with goal IDs, owners, dependencies, and deadlines β without being asked
Result: 36 task cards on the board β 1 milestone, 7 sub-goals, 28 self-created subtasks. Two cross-team interfaces aligned. All from one sentence.

How It Works
Each team member gets their own AI assistant (a "lobster") running in a Docker container β with private memory and conversations. Behind the scenes, they share company knowledge and a searchable team memory.
βββββββββββββββββββββββββββββββββββββββββββββββ
β Your Server β
β β
β ποΈ Controller (your OpenClaw) β
β "Spawn a lobster for alice" β
β β
β ββββββββββββ ββββββββββββ ββββββββββββ β
β β π¦ alice β β π¦ bob β β π¦ carol β β
β β Marketingβ β Ops β β Finance β β
β ββββββ¬ββββββ ββββββ¬ββββββ ββββββ¬ββββββ β
β βββββββββββββββ΄ββββββββββββββ β
β Shared knowledge & team memory β
βββββββββββββββββββββββββββββββββββββββββββββββ
| Just OpenClaw | OpenClaw + Corellis |
|---|---|
| 1 AI assistant for you | 1 AI assistant per team member |
| Your personal memory | 4-layer memory: personal β member β channel β company |
| You know what you discussed | Teamind: search all team discussions semantically |
| You learn from your mistakes | Fleet learning: one lobster's lesson promotes to all |
| Manual setup per person | One command to spawn a new lobster |
Key Capabilities
π§ Teamind β Collective Team Memory
Every Slack conversation is indexed with embeddings. Any lobster can search "what did we decide about the pricing model?" and get accurate, sourced answers β across all channels, all history.
𧬠Self-Improving Lobsters
Lobsters detect when they're corrected, record the lesson, and permanently improve. Validated patterns promote fleet-wide β one lobster's mistake becomes every lobster's knowledge.
π― GoalOps β Goals, Not Instructions
Give your controller a high-level goal. It decomposes into sub-goals, assigns to lobsters, and they self-coordinate β with P2P handoffs, dependency tracking, and human-in-the-loop approval for sensitive actions.
π Task Management
Unified task board with sprint planning, breakdown, and tracking. Backend-agnostic: works with Notion, Linear, GitHub Projects, or plain markdown.
π£ 30-Second Spawning
Tell your controller "spawn a lobster for alice" β it creates the Slack app, handles OAuth, and launches the container. You click Allow and paste one token.
π¦ 17+ Built-in Skills
Deep research, SEO monitoring, landing page optimization, weekly reports, structured decision alignment, approval workflows, Excalidraw diagrams, data dashboards, and more. See templates/skills/.
π€ Coding Agent Workflow
Confidence-based routing for ACP coding agents (Claude Code, Codex, Cursor). High confidence β auto-execute. Medium β structured prompt + review. Low β ask human first. Every change goes through automated tests + manual review before shipping.
π Proactive Task Discovery
Lobsters don't just wait for assignments β a daily cron triggers them to scan task boards for unassigned work, score items by capability match, and propose actionable items to their owner. Self-driving by default.
π Fleet Operations
Rolling upgrades with canary + auto-rollback. Config broadcasting. Health checks. Credential management. Gateway watchdogs. 24 operational scripts β all battle-tested.
Get Started
Prerequisites: OpenClaw on your host machine + Docker
git clone https://github.com/CorellisOrg/corellis.git
cd corellis
cp .env.example .env # add your LLM API key
docker compose up -d # launch your first lobster
Note: Each lobster needs a Slack bot app. Run
./scripts/create-slack-app.sh <name>to create one automatically, or see Slack Bot Setup for manual setup.
β Full walkthrough: Tutorial: Set Up a 3-Person Team in 30 Minutes
Production Evidence
This isn't a weekend project. Corellis has been running continuously since February 2026:
| Metric | Value |
|---|---|
| Fleet size | 28 lobsters on a single server (64GB RAM, 16 vCPU) |
| Teamind indexed | 50,000+ Slack messages across 30+ channels |
| Self-improving cycles | 500+ corrections detected and persisted |
| Goals executed | 200+ goals decomposed and coordinated |
| Skills deployed | 17+ fleet-wide + custom per-lobster skills |
The 24 operational scripts and Teamind modules were built iteratively from real production needs β not designed in a vacuum.
Architecture
Controller on host + lobsters in Docker containers
The controller runs on the host (not in Docker) β it manages containers and writes to shared directories. Each lobster runs in an isolated Docker container with read-only access to shared knowledge.
ββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Host Machine β
β β
β ποΈ Controller (OpenClaw on host) β
β βββ Manages Docker containers β
β βββ Writes company-skills/, company-memory/ β
β βββ Runs spawn, broadcast, sync, health-check β
β β
β ββββββββββββ ββββββββββββ ββββββββββββ β
β β π¦ alice β β π¦ bob β β π¦ carol β β
β β (Docker) β β (Docker) β β (Docker) β β
β ββββββ¬ββββββ ββββββ¬ββββββ ββββββ¬ββββββ β
β β β β β
β ββββββ΄ββββββββββββββ΄ββββββββββββββ΄βββββ β
β β Shared Volumes (bind mount, ro) β β
β β company-memory/ company-skills/ β β
β β company-config/ shared-knowledge β β
β βββββββββββββββββββββββββββββββββββββββ β
β β
β Each lobster also has private rw storage: β
β configs/<name>/workspace/ β ~/.openclaw/ β
ββββββββββββββββββββββββββββββββββββββββββββββββββββ
Why the controller isn't in Docker: It needs to run docker compose, manage host files, and execute fleet scripts. Docker-in-Docker adds complexity with no benefit.
Developer Reference
Looking for the full technical details? Everything from the README is documented in depth:
| π Complete Capabilities | All 24 scripts, memory architecture, security model, cron schedules |
| ποΈ Architecture Deep Dive | Design philosophy, system layers, GoalOps sequence diagrams |
| π§ Slack Bot Setup | Create Slack apps (automated or manual) |
| π Operational Guides | 2nd Me setup, ACP sessions, GitHub tokens, credentials, audits |
| π Tutorial: 3-Person Team | End-to-end walkthrough, zero to running |
All 24 operational scripts
Core Operations
| Script | Description |
|---|---|
create-slack-app.sh | Auto-create Slack App via Manifest API |
spawn-lobster.sh | Create a new lobster container |
health-check.sh | Check gateway, Slack, disk, memory for all lobsters |
rolling-upgrade.sh | Upgrade image with canary testing and auto-rollback |
Fleet Management
| Script | Description |
|---|---|
apply-fleet-config.sh | Deep-merge JSON patches into all lobster configs |
sync-fleet.sh | Push skills, memory, and API keys to all lobsters |
broadcast.sh | Send message via AI session (lobster reformulates) |
broadcast-direct.sh | Send message via Slack API (100% reliable) |
Maintenance
| Script | Description |
|---|---|
config-watchdog.sh | Dead-man switch: auto-rollback if not cancelled |
gateway-watchdog.sh | Cron job: restart gateway if unhealthy |
enable-acp.sh | Enable Claude Code/ACP on a specific lobster |
patch-all.sh | Apply all OpenClaw patches (idempotent) |
Governance framework
Corellis includes a governance framework so your fleet operates as a coherent organization:
| Template | Purpose |
|---|---|
AGENTS.md | Company-wide rules: session startup, memory management, correction detection, security |
REGISTRY.md | Master index of all shared resources |
DIRECTORY.md | Path/permission mapping for all shared directories |
PLAYBOOK-SPEC.md | Standard format for operational playbooks |
Place them in company-config/ on the host β bind-mounted read-only into every lobster β consistent behavior fleet-wide.
Secrets management
Each lobster gets two secret files:
secrets.json(read-only) β Shared API keys injected at spawn timepersonal-secrets.json(read-write) β Per-lobster private credentials
OpenClaw's SecretRef system ({"$ref": "secrets://KEY"}) keeps secrets out of config files.
Alternatives
| Approach | Corellis Difference |
|---|---|
| CrewAI / AutoGen | They orchestrate tasks. Corellis orchestrates an organization β persistent lobsters with memory, identity, and relationships |
| ChatDev / MetaGPT | Code-generation focused. Corellis is general-purpose: ops, marketing, research, finance, anything |
| Multiple separate assistants | No coordination. Corellis adds shared knowledge, Teamind, fleet learning, and GoalOps |
| Enterprise AI platforms (Glean, Moveworks) | SaaS, closed-source. Corellis is self-hosted, MIT licensed, fully customizable |
Requirements
- OpenClaw on the host machine
- Docker + Docker Compose
- Slack workspace with bot apps (one per lobster)
- 2GB RAM per lobster (3GB with Claude Code)
Links
- π corellis.ai
- π OpenClaw Documentation
- π¬ OpenClaw Community
- π Issues & Feature Requests
License
MIT