Command Your AI Agent Empire from the CEO Desk
A local-first AI agent office simulator that orchestrates CLI, OAuth, and API-connected providers (including Claude Code, Codex CLI, Gemini CLI, OpenCode, Kimi Code, GitHub Copilot, and Antigravity) as a virtual company of autonomous agents.
Quick Start · AI Install Guide · Release Notes · OpenClaw · Direct Messenger · $ Command · Features · Screenshots · Tech Stack · Providers · Docker Deploy · Security
**Dashboard** — Real-time KPI metrics, agent rankings, and department status at a glance
|
**Kanban Board** — Drag-and-drop task management with department and agent filters
|
**Skills Library** — Browse and assign 600+ agent skills across categories
|
**Multi-Provider CLI** — Configure Claude Code, Codex, Gemini CLI, OpenCode, and Kimi Code with model selection
|
**OAuth Integration** — Secure GitHub & Google OAuth with encrypted token storage
|
**Meeting Minutes** — AI-generated meeting summaries with multi-round review approval
|
**Messenger Integration** — Configure Telegram, WhatsApp, Discord, Google Chat, Slack, Signal, iMessage sessions and send `$` CEO directives
|
**Settings** — Configure company name, CEO name, default provider preferences (CLI/OAuth/API), and language preferences
|
**Detailed Report** — Example of completion report popup, report history, and detailed report view for a request
|
**PPT Generation** — Example captures of PPT generation output for a report request
|
- Direct file: [`Sample_Img/claw-empire-intro.mp4`](Sample_Img/claw-empire-intro.mp4) ### PPT Sample Sources Use the sample sources below when reviewing or extending report-to-PPT generation: Usage path: **Chat window > Report Request button**, then enter your request. - Folder: [`docs/reports/Sample_Slides`](docs/reports/Sample_Slides) - Sample deck (`.pptx`): [`docs/reports/PPT_Sample.pptx`](docs/reports/PPT_Sample.pptx) - HTML slides: [`slide-01.html`](docs/reports/Sample_Slides/slide-01.html), [`slide-02.html`](docs/reports/Sample_Slides/slide-02.html), [`slide-03.html`](docs/reports/Sample_Slides/slide-03.html), [`slide-04.html`](docs/reports/Sample_Slides/slide-04.html), [`slide-05.html`](docs/reports/Sample_Slides/slide-05.html), [`slide-06.html`](docs/reports/Sample_Slides/slide-06.html), [`slide-07.html`](docs/reports/Sample_Slides/slide-07.html), [`slide-08.html`](docs/reports/Sample_Slides/slide-08.html), [`slide-09.html`](docs/reports/Sample_Slides/slide-09.html) - Build scripts: [`build-pptx.mjs`](docs/reports/Sample_Slides/build-pptx.mjs), [`build-pptx.cjs`](docs/reports/Sample_Slides/build-pptx.cjs), [`html2pptx.cjs`](docs/reports/Sample_Slides/html2pptx.cjs) --- ## Features | Feature | Description | | ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Pixel-Art Office** | Animated office view with agents walking, working, and attending meetings across 6 departments | | **Workflow Pack Profiles** | Six built-in workflow packs (`development`, `report`, `web_research_report`, `novel`, `video_preprod`, `roleplay`) provide pack-specific routing schema, QA rules, and output templates | | **Office Pack Profiles** | Pack-scoped office profiles apply dedicated department topology, naming/theme presets, and isolated agent/department data per pack (except DB-backed development baseline) | | **Kanban Task Board** | Full task lifecycle — Inbox, Planned, Collaborating, In Progress, Review, Done — with drag-and-drop | | **CEO Chat & Directives** | Direct communication with team leaders; `$` directives support meeting choice plus project path/context routing (`project_path`, `project_context`) | | **Multi-Provider Support** | Claude Code, Codex CLI, Gemini CLI, OpenCode, Kimi Code, Antigravity — all from one dashboard | | **External API Providers** | Connect agents to external LLM APIs (OpenAI, Anthropic, Google, Ollama, OpenRouter, Together, Groq, Cerebras, custom) via Settings > API tab, with official presets for OpenCode Go and Bailian Coding Plan | | **OAuth Integration** | GitHub & Google OAuth with AES-encrypted token storage in local SQLite | | **Real-time WebSocket** | Live status updates, activity feed, and agent state synchronization | | **Active Agent Control** | Active-agent monitor with process/activity/idle metadata and direct kill action for stuck tasks | | **Task Report System** | Completion popup, report history, team report drilldown, and planning-lead consolidated archive | | **Agent Management** | Hire, edit, and delete agents with multilingual names, role/department/provider selection, and personality fields | | **Agent Ranking & XP** | Agents earn XP for completed tasks; ranking board tracks top performers | | **Skills Library** | 600+ categorized skills (Frontend, Backend, Design, AI, DevOps, Security, etc.) with custom skill upload support | | **Meeting System** | Planned and ad-hoc meetings with AI-generated minutes and multi-round review | | **Git Worktree Isolation** | Each agent works in isolated git branches, merged only on CEO approval | | **Multi-Language UI** | English, Korean, Japanese, Chinese — auto-detected or manually set | | **Messenger Integration** | Telegram, Discord, Slack and more — send `$` CEO directives and receive updates through built-in direct channel sessions (OpenClaw optional) | | **PowerPoint Export** | Generate presentation slides from meeting minutes and reports | | **Connectivity QA Scripts** | Built-in `test:comm:*` scripts for CLI/OAuth/API communication validation with retry and evidence logs | | **In-App Update Notice** | Checks GitHub latest release and shows a top banner with OS-specific `git pull` guidance when a newer version is available | | **Department Management** | Planning, Development, Design, QA/QC, DevSecOps, Operations — with dedicated management tab for arrow/drag-and-drop sort order editing | | **Manual Agent Assignment** | Assign specific agents to projects; meetings/delegation respect manual selection, with pre-save safeguards for no-agent or leader-only selections | | **Sprite Registration Safety** | Prevents duplicate sprite-number file overwrite by rejecting conflicting uploads with explicit `409 sprite_number_exists` responses | | **Custom Skill Upload** | Upload `.md` skill files through the UI to train CLI representatives with custom skills, complete with classroom training animation and management interface | --- ## Tech Stack | Layer | Technology | | -------------------- | --------------------------------------------------- | | **Frontend** | React 19 + Vite 7 + Tailwind CSS 4 + TypeScript 5.9 | | **Pixel Art Engine** | PixiJS 8 | | **Backend** | Express 5 + SQLite (zero-config embedded DB) | | **Real-time** | WebSocket (ws) | | **Validation** | Zod 4 | | **Icons** | Lucide React | | **Routing** | React Router 7 | | **Export** | PptxGenJS (PowerPoint generation) | ## AI Installation Guide > This section is for AI coding agents. Execute each step and run verification commands before moving to the next step. ### Step 0: Verify prerequisites ```bash # Node.js 22+ node -v # pnpm (or enable corepack) pnpm -v || corepack enable # git git --version ``` ### Step 1: Clone and run one-click setup ```bash git clone https://github.com/GreenSheep01201/claw-empire.git cd claw-empire git submodule update --init --recursive bash install.sh ``` Windows PowerShell: ```powershell git clone https://github.com/GreenSheep01201/claw-empire.git cd claw-empire git submodule update --init --recursive powershell -ExecutionPolicy Bypass -File .\install.ps1 ``` ### Step 2: Verify setup output macOS/Linux: ```bash # Required files after setup [ -f .env ] && [ -f scripts/setup.mjs ] && echo "setup files ok" # AGENTS orchestration rules installed grep -R "BEGIN claw-empire orchestration rules" ~/.openclaw/workspace/AGENTS.md AGENTS.md 2>/dev/null || true grep -R "INBOX_SECRET_DISCOVERY_V2" ~/.openclaw/workspace/AGENTS.md AGENTS.md 2>/dev/null || true # OpenClaw inbox requirements in .env grep -E '^(INBOX_WEBHOOK_SECRET|OPENCLAW_CONFIG)=' .env || true ``` Windows PowerShell: ```powershell if ((Test-Path .\.env) -and (Test-Path .\scripts\setup.mjs)) { "setup files ok" } $agentCandidates = @("$env:USERPROFILE\.openclaw\workspace\AGENTS.md", ".\AGENTS.md") $agentCandidates | ForEach-Object { if (Test-Path $_) { Select-String -Path $_ -Pattern "BEGIN claw-empire orchestration rules" } } $agentCandidates | ForEach-Object { if (Test-Path $_) { Select-String -Path $_ -Pattern "INBOX_SECRET_DISCOVERY_V2" } } # OpenClaw inbox requirements in .env Get-Content .\.env | Select-String -Pattern '^(INBOX_WEBHOOK_SECRET|OPENCLAW_CONFIG)=' ``` ### Step 3: Start and health-check ```bash pnpm dev:local ``` In another terminal: ```bash curl -s http://127.0.0.1:8790/healthz ``` Expected: `{"ok":true,...}` Messenger channels are configured in Settings UI and persisted to SQLite (`settings.messengerChannels`). `.env` messenger token/channel variables are no longer used. ### Step 4: Optional messenger + inbox verification ```bash curl -s http://127.0.0.1:8790/api/messenger/sessions ``` This returns messenger sessions saved in Settings. ```bash curl -X POST http://127.0.0.1:8790/api/inbox \ -H "content-type: application/json" \ -H "x-inbox-secret: $INBOX_WEBHOOK_SECRET" \ -d '{"source":"telegram","author":"ceo","text":"$README v1.1.6 inbox smoke test","skipPlannedMeeting":true}' ``` Expected: - `200` when `INBOX_WEBHOOK_SECRET` is configured and `x-inbox-secret` matches. - `401` when the header is missing/mismatched. - `503` when `INBOX_WEBHOOK_SECRET` is not configured on the server. ### Step 5: Direct messenger setup (no OpenClaw required) You can run messenger channels directly from Claw-Empire without OpenClaw. 1. Open `Settings > Channel Messages`. 2. Click `Add Chat`. 3. Select a messenger (`telegram`, `whatsapp`, `discord`, `googlechat`, `slack`, `signal`, `imessage`). 4. Fill in session fields: - `Name` (session label) - messenger token/credential - `Channel/Chat ID` (target) - mapped conversation `Agent` 5. Click `Confirm` to save immediately (no extra global save step required). 6. Enable the session, then test: - normal message -> direct agent chat - `$ ...` -> directive flow Notes: - Messenger sessions are persisted in SQLite (`settings.messengerChannels`). - Messenger tokens are encrypted at rest (AES-256-GCM) using `OAUTH_ENCRYPTION_SECRET` (fallback: `SESSION_SECRET`) and decrypted only at runtime. - `.env` messenger variables (`TELEGRAM_BOT_TOKEN`, `DISCORD_BOT_TOKEN`, `SLACK_BOT_TOKEN`, etc.) are not used. - `/api/inbox` + `INBOX_WEBHOOK_SECRET` is only needed for webhook/inbox flows (including OpenClaw bridge). --- ## Quick Start ## Docker Deployment (Quick Start) This repo now ships production-oriented Docker defaults: - Runs as **non-root** user (`app`, uid/gid `10001`) - Includes required CLI/runtime tools (`git`, `bash`, `openssh-client`) - Uses `docker-compose.yml` + `Dockerfile` - Persists runtime data in `./data` (already gitignored) ### 1) Prepare environment files ```bash cp .env.example .env.docker ``` Create `.env.docker.private` for sensitive runtime secrets (keep this file local only): ```bash cat > .env.docker.private <<'EOF' # Claude Code via compatible endpoint ANTHROPIC_BASE_URL=https://api.minimaxi.com/anthropic ANTHROPIC_API_KEY=YOUR_ANTHROPIC_API_KEY EOF chmod 600 .env.docker.private ``` > `.env.docker*` is ignored by git (`.env.*`), so tokens are not committed by default. ### 2) Start ```bash docker compose up -d --build ``` ### 3) Verify ```bash docker ps --filter name=claw-empire docker logs -f claw-empire ``` Open: `http://127.0.0.1:8790` ### Optional: publish image to GHCR ```bash # requires token with package write scope echo "