Claw-Empire：给 AI Agent 开一家虚拟公司

想象一下：清晨 9 点，你坐在 CEO 工位上，打开电脑，不是看邮件，而是审视一整层楼的 AI 员工——它们各自在工位上敲代码、开站会、做 PPT，等你点头批准后出发执行任务。这就是 Claw-Empire 带给你的体验。 Claw-Empire 是一个本地优先的 AI Agent 公司模拟器。它将你的多个 AI 编程助手（Claude Code、Codex CLI、Gemini CLI、OpenCode 等）转化为一家虚拟软件公司的员工，你作为 CEO 从统一的 Web 界面俯瞰全局、分配任务、审批交付物。所有数据存储在本地 SQLite 数据库，不依赖任何云服务，隐私完全可控。 图1：Claw-Empire 项目 Logo

背景：为什么需要一个 AI 员工管理系统？

随着 Claude Code、Codex CLI、Gemini CLI 等命令行 AI 编程工具逐渐普及，开发者面临一个新问题：同时管理多个 AI Agent 变得极其困难。每个 Agent 需要独立终端、上下文隔离、日志分散，想要让它们协作简直是噩梦。 OpenClaw 生态的出现提供了统一标准化的 Agent 接口规范，而 Claw-Empire 则在此基础上更进一步——它不只是一个技术中间件，而是一个完整的工作流可视化层。作者 GreenSheep01201 在 2025 年中创建了该项目，v1.0.5 版本获得了大量关注，经过持续迭代到 v2.0.4，功能已相当成熟。

核心设计：模拟真实软件公司的工作流程

Claw-Empire 的设计哲学是用真实公司的组织结构来管理 AI Agent。系统内置了多个虚拟部门（Engineering、Design、Research、Marketing 等），每个部门配置专门的 Agent 角色。当 CEO（用户）下达任务时，系统自动分析任务类型，将子任务路由到最合适的部门。 以一个典型工作流为例：

1. CEO 派发任务 — 用户在前端用自然语言描述需求，系统自动生成任务卡片
2. 部门主管认领 — 相关部门 Agent 领取子任务，分配给具体成员
3. Agent 执行 — Agent 在隔离的 git worktree 中运行，不污染主仓库
4. 站会同步 — 定时轮询所有 Agent 状态，生成团队进度简报
5. CEO 审批 — 所有交付物经过审核流程，CEO 最终批准或要求返工 图2：Claw-Empire Dashboard 面板，实时显示各 Agent 工作状态

多 Agent 接入：支持 7 种主流 AI 编程工具

Claw-Empire 支持通过三种方式接入 AI Agent：

• CLI 模式：直接调用本地安装的 CLI 工具（Claude Code、Codex CLI、Gemini CLI、OpenCode）
• OAuth 模式：通过 OAuth 授权网页版 Agent（Claude.ai、GitHub Copilot）
• API Key 模式：直连厂商 API（Gemini、Kimi、Antigravity） 图3：CLI 模式 Agent 配置界面，支持检测本地已安装的 Agent 工具 系统内置 Agent 检测机制（detectAllCli），能自动发现机器上已安装的 AI CLI 工具，配置流程大大简化。

技术架构：Express + React + SQLite 的务实选择

从源码结构来看，Claw-Empire 采用典型的前后端分离架构：

• 后端：Node.js + Express + TypeScript，通过 WebSocket 实时推送状态更新
• 前端：React + Vite，像素风 UI，完整的办公室可视化场景
• 数据层：SQLite，本地持久化，无外部依赖
• 安全层：CSRF Token 保护、Session Cookie 认证、IP 来源白名单验证
• 通信层：WebSocket（ws 库）+ REST API，支持 Webhook 回调（Discord、Telegram、飞书等） 图4：Kanban 看板视图，追踪每个 Agent 的任务进度 后端核心模块划分清晰：server/modules/ 下有 lifecycle.ts（生命周期管理）、workflow.ts（工作流编排）、routes/（API 路由）、bootstrap/（数据库初始化和安全审计工具）。数据库采用 SQLite 的 node:sqlite 原生驱动，并实现了重试逻辑（busy timeout + jitter）应对并发写入。 特别值得关注的是 security/auth.ts 中的安全设计：除了标准 CORS + CSRF 保护外，还实现了 loopback 请求识别和 origin 白名单匹配，能够防御常见的 WebSocket 劫持攻击。

OpenClaw 集成：标准化的 Agent 接口

Claw-Empire 深度集成了 OpenClaw 生态。OpenClaw 定义了一套标准化的 Agent 接口规范，使不同厂商的 AI CLI 工具能够以统一方式被调用和管理。项目 topics 包含 openclaw、openclaw-agent、openclaw-extension、openclaw-plugin，说明它是 OpenClaw 生态的一等公民。 这也意味着 Claw-Empire 不仅能管理现有 Agent，未来任何遵循 OpenClaw 规范的插件都能无缝接入。 图5：OAuth 授权流程，支持网页版 Agent 的安全接入

部署体验：Docker 一键启动，门槛极低

项目提供了完整的容器化部署方案（Dockerfile + docker-compose.yml）：

• 基础镜像：node:22-bookworm-slim
• 预装 Agent：Claude Code、Codex CLI、Gemini CLI、OpenCode 已在镜像中全局安装
• 非 root 运行：创建 app 用户（UID/GID 10001）运行应用，符合容器安全最佳实践
• 数据持久化：SQLite 数据库和日志目录通过 Docker volume 挂载宿主机
• 端口映射：容器内 8790 端口暴露到宿主机 图6：Skills 管理界面，配置 Agent 的技能集和行为约束 本地开发模式也提供了 install.sh 和 install.ps1 脚本，自动化环境配置。predev 脚本会自动执行数据库迁移，开发体验考虑周到。

上手难度与局限

优点：

• 开箱即用的 Web UI，视觉效果出色（像素风办公室）
• 本地优先，数据完全私有
• 支持 Agent 类型丰富，覆盖主流工具
• Docker 部署方案成熟，生产可用 局限：
• 实质上是一个管理层，Agent 的实际编程能力取决于底层工具的表现
• 复杂任务的多 Agent 协作仍依赖 prompt 工程质量，自动路由并非万能
• 像素风 UI 偏娱乐化，可能不适合追求效率优先的专业团队
• 尚无原生 macOS M 系列芯片优化（虽然 Rosetta 兼容可运行）

行业意义：Agent 编排的轻量化范式

Claw-Empire 代表了一种轻量化 Agent 编排的设计思路。与 LangGraph、AutoGen 等重型框架不同，它不需要写代码，只需要配置和点击。对于想体验 AI Agent 协作但不想陷入技术细节的开发者来说，这是一个极具吸引力的入口。 结合 OpenClaw 生态的快速演进，Claw-Empire 的定位很清晰：做一个好看的壳，把复杂的 Agent 管理工作包装成普通用户也能理解的开公司隐喻。这是用户体验设计上的成功，也是它能在短时间内积累 1200+ stars 的核心原因。