Lumina · the Impact OS for visionaries

One brain. Every channel.
Agents that run the business.

OpenClaw is the local-first agent framework under Lumina: an LLM brain wired to real chat channels (iMessage, Telegram, Slack), driven by Markdown skills and agents. Not a stateless chatbot — a daemon that wakes on a heartbeat, holds long-term memory, and executes multi-step work across sales, marketing, ops, and engineering. Two browser surfaces let you watch and steer it live.

63Agents (SOUL.md)
397Skills (SKILL.md)
5Tenants
3Live web surfaces
:18789Gateway daemon
Live — demo it now Coming soon — no front-end yet Beta — operator-gated
Browser control surfaces

Where you watch & steer the agents

All four share one Clerk login. Sign in once at app.holalumina.com/admin/login → every surface below opens with no re-auth (Clerk satellite-domain SSO).

Live

🛰️ Mission Control

Per-tenant agent-orchestration dashboard. A chat panel where you talk directly to your agents and watch them work — e.g. "create an HTML email previewing our retreat package" renders the HTML right in the thread. Page title: "Mission Control — AI Agent Orchestration Dashboard."

🔒 Sign in first, then open ↓
Live

🎨 Open Design

Per-tenant generative design shell. Chat to build pages and emails — "build an HTML landing page, headline X, button Y" renders inline. Hardened wedge surface (spec 101); handshakes to the main app via /api/od-handshake so it inherits your session with no re-auth.

🔒 Sign in first — cold-open returns 401 ↓
Live

✈️ Telegram channel

Message an OpenClaw agent from your phone. Telegram is a first-class gateway channel (the telegram plugin runs on the gateway alongside clawpipe + hindsight).

Operator creates a bot
Telegram @BotFather/newbot → copy the bot token
Token added to gateway config
Stored in the tenant's Doppler-backed openclaw.json / .env
Open the bot & send /start
Your chat ID pairs to the agent session
Message it like a person
Replies stream back from the live daemon
Live

🔌 Composio auth

OAuth broker for connecting third-party apps (Gmail, Slack, Calendars, CRMs) to a tenant's agents — so a skill can act in those tools. Runs as a gateway plugin + onboarding OAuth flow.

Open Integrations
/integrations (or run onboarding)
Pick the app → Connect
OAuth consent popup for that provider
Callback & store
/api/onboarding/composio-callback mints state, token saved to the tenant vault
Agents can now act in that app
via Composio
⚠️ Demo order (so nothing 401s on stage): sign in at app.holalumina.com/admin/login first. Then: Mission Control (mc-*) sits behind the gateway access login; Open Design inherits your app session via /api/od-handshake — cold-clicking it before sign-in returns 401. Lumina's Open Design (lumina.opendesign.holalumina.com) is not provisioned yet → 404 (coming soon).
Admin dashboard · app.holalumina.com/admin

The operator cockpit

Next.js 15 app on Vercel, Clerk auth, multi-tenant Postgres (Neon, RLS). Where humans create campaigns, manage sites, and (soon) work the lead pipeline.

🔑 How to sign in / register: Go to app.holalumina.com/admin/login → Clerk sign-in (email + OTP, or SSO). New users: /sign-up. After auth you land on /admin/home. For the demo, use the prepared Clerk demo account (operator has the credentials).
Live

📣 Campaigns

Create & orchestrate retreat / workshop / webinar / newsletter campaigns. Draft → Generating → Ready → Published. Generation is multi-agent (copy + landing page + HTML email).

Live

🌐 Landing Pages

Register & manage tenant sites and landing pages (name, URL, CMS link). New-page wizard wires copy + design.

Coming soon

👥 Lead Management

Unified inbox + pipeline for inbound leads. Front-end not built yet — backend pieces exist (CRM resolver, sales agents). Full flow in Coming Soon ↓

/admin/leads (planned)
Live

✉️ Newsletters

Draft, gate & send newsletters via Resend with an approval workflow.

Live

🎟️ Events & Offers

Manage events/registrations and promotional offers tied to campaigns.

Live

🖥️ Instances & Org

Provision/monitor tenant gateway instances; manage org members & roles.

Beta

🧰 Render & Presentations

Render artifacts (signed-URL, RLS-scoped) and manage generated slide decks / presentations.

Beta

🧠 Memory

Inspect the agent knowledge/memory store and index health.

Starter Pack · tenant: ericedmeades

What ships out of the box

A new tenant ("Eric Edmeades") boots as an iMessage-channel agent on the shared platform library — a coach agent + the runtime plugin stack + the baked-in ClawSuite. Behind it: 63 agents, 397 skills.

📦 Tenant config

Operator: Eric Edmeades · domain ericedmeades.com · tier pro · channel iMessage (via the immutable lumina-relay). Boots the canonical coaching agent (agents/sales/coach).

tenants/ericedmeades/{tenant,pack,cognition-registry}.yaml

🔋 Runtime plugins (the stack)

Declared in pack.yaml, health-checked at boot:

composiomanifest-model-router agent-browserlossless-clawopik-openclaw

Vanilla (baked into the image):

clawpipeclawspecclawwrap clawagentskillclawinterview

The shared agent roster (63)

Every tenant draws from this library. A sample by department:

🏛️ Executive

CEO / CMO
Strategy & marketing leadership
CTO / CCO
Eng orchestration & creative quality

💼 Sales

director
Owns lead→close pipeline
lumina · concierge
Conversational inbound qualification
enrollment · lead-nurture · pricing-yield · coach
Close, nurture, yield

📈 Marketing

strategist (Atlas)
Funnels, CRO, site planning
webinar-architect · funnel · copywriter · brand-guardian
Campaign creation

🛠️ Engineering

backend · frontend · email · devops
Builds & ships product

🌍 Website (Construct)

architect · researcher · seo · ux/visual · qa · perf-guardian
Full website build crew

🧑‍⚕️ Programs · Platform

onboarding (intake · medical · screening)
Participant intake & safety
interviewer · relay · skill-scanners
Platform plumbing & security

Skills & commands (397 total)

Each skill is a Markdown capability (~24 tokens to route) with a slash command. A demo-worthy slice:

/webinar-orchestrator
Full multi-agent webinar build → Vercel preview
/post-webinar-close
5–7 email close sequence for no-shows
/qualify-lead
Score inbound lead intent & fit
/create-campaign
Spin up a campaign end-to-end
/newsletter
Draft → gate → send via Resend
/design-review
Visual audit against brand tokens
/seo-strategy
Programmatic SEO + schema markup
skill find "<query>"
python3 -m compiler.engine.cli skill find
Onboarding

Set up a new tenant

Two paths. Self-serve onboarding spins up a tenant from the browser (conversational). Operator provisioning stands up the gateway daemon + channels on the host. A tenant = a brand identity + a plugin pack + its slice of agents & skills.

🟢 Self-serve onboarding (web)

Conversational setup driven by ClawInterview — collects brand, channel, and integrations, then provisions a Railway instance. APIs under /api/onboarding/*.

Start
Open /onboardingPOST /api/onboarding/start
Interview
/api/onboarding/chat — adaptive Q&A captures brand voice, org, goals
Connect channel
iMessage welcome or Telegram verify (/api/onboarding/telegram-verify, /imessage-welcome)
Connect apps
Composio OAuth for Gmail / Slack / CRM
Go live
/api/onboarding/complete → Railway provisions the instance; track via /api/onboarding/status

🛠️ Operator provisioning (host)

Stand up the gateway daemon + channels manually. Full runbook: docs/multi-tenant-guide.md. Gate: openclaw doctor passes with zero errors.

# 1 · infra + secrets
sudo sysadminctl -addUser <tenant> -fullName "<Name>"
sudo -u <tenant> npm i -g openclaw@latest
mkdir -p ~/.openclaw && chmod 700 ~/.openclaw   # .env → 600
doppler setup   # OPENCLAW_PORT, WEBHOOK_PORT, bot tokens…

# 2 · launchd services (gateway · webhook-proxy · cloudflared)
scripts/<tenant>/install-<tenant>-daemons.sh
# ref working example: scripts/yumi/

# 3 · Cloudflare tunnel → localhost:<webhook-port>

# 4 · install + verify
sudo bash scripts/<tenant>/install-<tenant>-daemons.sh
sudo -u <tenant> openclaw doctor

🎨 Define the tenant (files)

Copy the skeleton at tenants/_template/tenants/<name>/ and fill in:

tenant.yaml
operator, domain, tier, gateway version
pack.yaml
runtime plugins + agents + skill bundles
brand/
voice.md, brand-book.md, brand-ref.yaml
design-system/
colors_and_type.css, logos, KIT.md
skills/
tenant-specific skill overrides
cognition-registry.yaml
Manifest model-tier mapping
Install the build packages once per host: bash scripts/setup-packages.sh — editable-installs clawscaffold, clawagentskill, clawwrap, clawpipe, lumina-pack.
Tenant: ceremonia · live.ceremoniacircle.org

A real business running on OpenClaw

Ceremonia is a psychedelic-healing retreat company ($5k–$25k retreats). Its agents qualify inbound seekers over iMessage/SMS, build & run campaigns, screen participants for medical safety, and process retreat media — all brand-gated to Ceremonia's voice.

Live

🌐 Public site

The marketing site (Next.js on Vercel), brand-tokenized from tenants/ceremonia/design-system.

🧭 Agents serving Ceremonia

concierge "Lumina"sales/concierge
First warm voice for retreat seekers
luminasales/lumina
Qualifies inbound via iMessage/SMS
strategist "Atlas"marketing/strategist
Funnels & CRO for enrollments
medical-screeningprograms/onboarding
Flags health contraindications

Ceremonia skills & commands

/ceremonia-page-copywriter
Brand-safe v3 site copy (PAS/AIDA/Hormozi/Brunson) → humanized → brand-gated
/retreat-videos
Process retreat Google Photos albums → Vimeo + Airtable
retreat-financials
Reconcile retreat financials
typebot-flow-builder
Build intake / qualification flows
Plugins & intelligence layer

What plugs into the brain

Two families: runtime plugins on the gateway (extend what live agents can do) and knowledge / dev plugins (MCP tools that make building & recalling faster).

🧭 Manifest

Smart LLM router for OpenClaw. Picks the cheapest model that can do the job (tiers: simple → standard → complex → reasoning) and logs tokens, cost & latency per tenant for billing.

plugin: manifest-model-router

🔭 Hindsight

Persistent cross-session memory / recall (vectorize-io), tenant-isolated at the DB layer. An agent remembers facts & decisions across days, not just within one session.

plugin: hindsight-openclaw (spec 109 hardened)

🔍 GBrain

Semantic search over code + curated memory (HNSW vectors). "Where is X handled?" / "what did we decide?" — better than grep for fuzzy questions.

gbrain query "<q>" · code-def · code-refs

📊 Opik

LLM observability (comet-ml/opik) — traces, evals and quality scoring of agent runs.

plugin: opik-openclaw

🌐 Agent-Browser

Headless browser control for agents — navigate, fill forms, scrape, verify live pages.

plugin: agent-browser

🪶 Lossless-Claw

Context-efficiency plugin — keeps long agent context coherent while trimming token cost.

plugin: lossless-claw

🐝 Ruflo

Multi-agent orchestration MCP — spin up swarms, route tasks, store/recall learned patterns.

swarm_init · agent_spawn · memory_search

🗺️ Repowise

Workspace code intelligence — "how does X work / why / what breaks if I touch it."

get_answer · get_why · get_risk

🧱 Context-Mode

Sandbox that runs analysis off-context — only the answer enters the conversation, not the raw bytes.

ctx_batch_execute · ctx_search · ctx_execute
ClawSuite · the build packages

How agents & campaigns get built

The "claw" packages are Python tools baked into the gateway image. They turn interviews into specs, specs into scaffolds, and chain skills into pipelines. Install: bash scripts/setup-packages.sh.

🧵 Clawpipe

Markdown pipeline engine — chains skills into multi-step workflows (intake → CRM → email), with resume, lessons-learned, goals & heartbeat-driven runs.

# run / resume / inspect a pipeline
python -m clawpipe run <pipeline>
python -m clawpipe resume <id>
python -m clawpipe show | lessons | goals

🎙️ ClawInterview

Conversational data collection — runs an adaptive Q&A over iMessage/Telegram and writes structured records (e.g. retreat intake → Airtable). Powers the onboarding interview engine.

# drives onboarding intake; invoked by
# the interviewer agent +
# /website-intake-interview

🏗️ ClawScaffold

Scaffolds new agents & tenants from a spec (assemble / extract / interview). External package — github.com/austinmao/clawscaffold.

# discover, then scaffold a skill/agent
python -m clawagentskill find <query>
python -m clawagentskill adopt | port | scan

📐 Clawspec

Generates technical specs & contracts (TDD-enforced) and runs eval baselines (Opik-scored).

python -m clawspec …

📦 Clawwrap

Bundles & governs outbound — the targets.yaml + outbound-policy.yaml gate that validates every WhatsApp/email/Slack send target.

clawwrap/config/{targets,outbound-policy}.yaml

🧩 Clawagentskill

Skill discovery + scaffold validation — find / adopt / port / scan / status. Used in pre-commit & harness-eval baselines.

python -m clawagentskill status
Example flow: ClawInterview collects a retreat seeker's answers over iMessage → Clawpipe runs the qualify→CRM→email pipeline → the outbound send is validated by the Clawwrap gate → the run is logged for Opik scoring. No step touches a hardcoded address; the gate resolves every target.
System architecture

How it's wired

Channels feed a gateway daemon on Hetzner; the brain routes through Manifest to the LLMs; state lives in Neon; the web surfaces deploy on Vercel; tenant instances orchestrate via Railway + Cloudflare.

① Channels — how people reach the agents
iMessagelumina-relay (vanilla)
Telegramtelegram plugin
Slack / WhatsAppoutbound gate
Mission Control / Open Designbrowser chat surfaces
② OpenClaw Gateway — Hetzner
Gateway daemonNode.js · :18789 · loopback · token auth
Heartbeat loopcron 30–60min · HEARTBEAT.md
Agents (63)SOUL.md identities
Skills (397)SKILL.md capabilities
agent-squad sidecarFastAPI · :18790 · parallel dispatch
Pluginsclawpipe · hindsight · composio · manifest · opik
▼   brain routes via Manifest → Anthropic / OpenRouter LLMs   ▼
③ Data & secrets
Neon PostgresVercel · multi-tenant RLS · app_user · render_artifacts
Dopplersecrets / env vaults
Composio3rd-party OAuth tokens
Airtable / Attiorecords & CRM (resolvers)
④ Web — Vercel hosting
webapp.holalumina.com — admin + MC/OD discovery
ceremonialive.ceremoniacircle.org
holaluminamarketing site
⑤ Tenant orchestration & ingress
Railwaytenant spawn · POST /api/onboarding/start
MC / OD containersDocker on Hetzner · mc-* / *.opendesign
Cloudflare Tunnelingress · satellite domains
Clerkauth · cross-surface SSO
Coming soon

Lead Management System

The backend muscle exists (CRM resolvers, sales agents, the outbound gate). What's missing is the operator front-end. Here's the flow it will expose:

Front-end coming soon

👥 Lead → Pipeline → Close

A single cockpit to see every inbound lead, where it came from, what the agent already said, and what to do next — instead of leads scattered across iMessage threads, forms, and the CRM.

1. Capture   Form / iMessage / Telegram / webinar reg → lead created
2. Qualify   /qualify-lead scores intent & fit; Lumina agent engages warmly
3. Screen    programs/onboarding agents flag medical contraindications
4. Route     director agent assigns → enrollment / nurture / concierge
5. Track     synced to CRM (Attio resolver); pipeline stage updated
6. Close     outbound (clawwrap gate) → operator approves → send
  ── the missing piece: a /admin/leads UI over all six steps ──

Until the UI ships, the pipeline runs agent-side and surfaces in Mission Control chat. The front-end will turn it into a sortable board with stage filters, lead scoring, and one-click approvals.

🚧 Other front-ends in flight: Lumina's Open Design surface (not yet provisioned), deeper Render & Memory admin views (currently beta), and a public /api/tool-call gateway endpoint (proposed) to let dashboards probe any plugin tool directly.