claw-empire

Claw-Empire

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

English | 한국어 | 日本語 | 中文

---

What is Claw-Empire?

Claw-Empire transforms your AI coding assistants — connected via CLI, OAuth, or direct API keys — into a fully simulated virtual software company. You are the CEO. Your AI agents are the employees. Watch them collaborate across departments, hold meetings, deliver tasks, and level up — all visualized through a charming pixel-art office interface.

Why Claw-Empire?

• One interface, many AI agents — Manage CLI, OAuth, and API-backed agents from a single dashboard
• Local-first & private — All data stays on your machine. SQLite database, no cloud dependency
• Visual & intuitive — Pixel-art office view makes AI orchestration fun and transparent
• Real autonomous collaboration — Agents work in isolated git worktrees, attend meetings, and produce deliverables

---

Install with AI

Just paste this to your AI coding agent (Claude Code, Codex, Gemini CLI, etc.):

Install Claw-Empire following the guide at:
https://github.com/GreenSheep01201/claw-empire

The AI will read this README and handle everything automatically.

---

Latest Release (v2.0.4)

• Docker deployment is now an officially documented path - the repo now ships a production-oriented Dockerfile, docker-compose.yml, .dockerignore, and container-aware runtime path handling.

• Stale working agents recover automatically after interrupted runs - lifecycle startup and interval sweeps now reset agents that are still marked working without a live in_progress task.

• Settings > API now supports official direct-API presets - OpenCode Go and Bailian Coding Plan presets lock the expected Base URL, seed fallback models immediately, and keep refresh/retry behavior explicit.

• Kimi Code is now supported end to end - Kimi is wired through CLI execution, provider labels, skills learn/unlearn flow, prompt-skill rendering, video-preprod bootstrap, and provider-aware schema/runtime checks.

• API model assignment now starts from the development pack and expands to initialized office packs - development remains the default baseline, and office packs that have already been hydrated through initial setup also appear as assign targets.

• Local E2E validation is safer and cleaner - pnpm run test:e2e now resets the isolated runtime before and after Playwright runs, and existing 8810 servers are no longer reused unless you explicitly opt in.

• Full notes: docs/releases/v2.0.4.md

• API docs: docs/api.md, docs/openapi.json

• Security policy: SECURITY.md

Office Pack Profiles (v2.0.1)

Each office pack applies a different collaboration topology, naming seed, and workflow bias.

Pack Core Focus Representative Structure development (DEV) Default engineering baseline with backward-compatible behavior Planning / Development / Design / QA-QC / DevSecOps / Operations report (RPT) Structured report and document production Editorial Planning, Research Engine, Doc Design, Review Desk web_research_report (WEB) Source collection and citation-first fact validation Research Strategy, Crawler Team, Fact Check novel (NOV) Worldbuilding, narrative flow, and tone consistency Worldbuilding, Narrative Engine, Character Art, Tone QA video_preprod (VID) Concept/script/shot-list/editing-note pre-production Pre-production, Scene Engine, Art & Camera, Cut QA roleplay (RPG) In-character dialogue immersion and role consistency Character Planning, Dialogue Engine, Stage Art, Character QA

Screenshots

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

Video Output Sample

Preview sample intro video output:

• Direct file: 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
• Sample deck (.pptx): docs/reports/PPT_Sample.pptx
• HTML slides: slide-01.html, slide-02.html, slide-03.html, slide-04.html, slide-05.html, slide-06.html, slide-07.html, slide-08.html, slide-09.html
• Build scripts: build-pptx.mjs, build-pptx.cjs, 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