🦞 Corellis

April 7, 2026 Β· View on GitHub

Stars License: MIT OpenClaw CI

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:

  1. The controller decomposed the goal into 6 sub-goals and created a milestone + 7 tracking cards on the task board
  2. 6 lobsters were assigned β€” marketing, engineering, payments, ops, partnerships, frontend β€” each in a dedicated thread
  3. All 6 confirmed within minutes, following the goal-participant protocol: analyze scope β†’ break into subtasks β†’ define acceptance criteria
  4. 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
  5. 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.

Demo: Lobsters coordinate on a goal


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 OpenClawOpenClaw + Corellis
1 AI assistant for you1 AI assistant per team member
Your personal memory4-layer memory: personal β†’ member β†’ channel β†’ company
You know what you discussedTeamind: search all team discussions semantically
You learn from your mistakesFleet learning: one lobster's lesson promotes to all
Manual setup per personOne 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:

MetricValue
Fleet size28 lobsters on a single server (64GB RAM, 16 vCPU)
Teamind indexed50,000+ Slack messages across 30+ channels
Self-improving cycles500+ corrections detected and persisted
Goals executed200+ goals decomposed and coordinated
Skills deployed17+ 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 CapabilitiesAll 24 scripts, memory architecture, security model, cron schedules
πŸ—οΈ Architecture Deep DiveDesign philosophy, system layers, GoalOps sequence diagrams
πŸ”§ Slack Bot SetupCreate Slack apps (automated or manual)
πŸ“‹ Operational Guides2nd Me setup, ACP sessions, GitHub tokens, credentials, audits
πŸš€ Tutorial: 3-Person TeamEnd-to-end walkthrough, zero to running
All 24 operational scripts

Core Operations

ScriptDescription
create-slack-app.shAuto-create Slack App via Manifest API
spawn-lobster.shCreate a new lobster container
health-check.shCheck gateway, Slack, disk, memory for all lobsters
rolling-upgrade.shUpgrade image with canary testing and auto-rollback

Fleet Management

ScriptDescription
apply-fleet-config.shDeep-merge JSON patches into all lobster configs
sync-fleet.shPush skills, memory, and API keys to all lobsters
broadcast.shSend message via AI session (lobster reformulates)
broadcast-direct.shSend message via Slack API (100% reliable)

Maintenance

ScriptDescription
config-watchdog.shDead-man switch: auto-rollback if not cancelled
gateway-watchdog.shCron job: restart gateway if unhealthy
enable-acp.shEnable Claude Code/ACP on a specific lobster
patch-all.shApply all OpenClaw patches (idempotent)
Governance framework

Corellis includes a governance framework so your fleet operates as a coherent organization:

TemplatePurpose
AGENTS.mdCompany-wide rules: session startup, memory management, correction detection, security
REGISTRY.mdMaster index of all shared resources
DIRECTORY.mdPath/permission mapping for all shared directories
PLAYBOOK-SPEC.mdStandard 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 time
  • personal-secrets.json (read-write) β€” Per-lobster private credentials

OpenClaw's SecretRef system ({"$ref": "secrets://KEY"}) keeps secrets out of config files.


Alternatives

ApproachCorellis Difference
CrewAI / AutoGenThey orchestrate tasks. Corellis orchestrates an organization β€” persistent lobsters with memory, identity, and relationships
ChatDev / MetaGPTCode-generation focused. Corellis is general-purpose: ops, marketing, research, finance, anything
Multiple separate assistantsNo 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)

License

MIT