从CEO办公桌指挥您的AI代理帝国
一个本地优先的 AI 代理办公室模拟器,可将 CLI、OAuth、API 连接 的提供商(如 Claude Code、Codex CLI、Gemini CLI、OpenCode、Kimi Code、GitHub Copilot、Antigravity)统一编排为自治虚拟公司
快速开始 · AI 安装指南 · 发布说明 · OpenClaw 集成 · 直连消息渠道 · $ 命令逻辑 · 功能特性 · 截图 · 技术栈 · 提供商 · Docker 部署 · 安全性
**仪表板** — 实时 KPI 指标、代理排名和部门状态一览无余
|
**看板** — 支持拖拽的任务管理,可按部门和代理筛选
|
**技能库** — 浏览并分配 600+ 项跨类别的代理技能
|
**多提供商 CLI** — 配置 Claude Code、Codex、Gemini CLI、OpenCode、Kimi Code 并选择模型
|
**OAuth 集成** — 安全的 GitHub 与 Google OAuth,加密令牌存储
|
**会议纪要** — AI 生成的会议摘要,支持多轮审阅与批准
|
**即时通讯集成** — 可配置 Telegram、WhatsApp、Discord、Google Chat、Slack、Signal、iMessage 会话并发送 `$` CEO 指令
|
**设置** — 配置公司名称、CEO 名称、默认提供商偏好(CLI/OAuth/API)和语言偏好
|
**详细报告** — 请求完成后的报告弹窗、报告历史与详细报告查看示例
|
**PPT 生成示例** — 报告请求触发的 PPT 生成结果示例
|
- 文件直链: [`Sample_Img/claw-empire-intro.mp4`](Sample_Img/claw-empire-intro.mp4) ### PPT 示例源码 可通过以下样例快速参考或扩展“报告生成 PPT”的实现。 使用路径: **聊天窗口 > Report Request 按钮**,然后输入你的请求内容。 - 目录: [`docs/reports/Sample_Slides`](docs/reports/Sample_Slides) - 示例演示文稿(`.pptx`): [`docs/reports/PPT_Sample.pptx`](docs/reports/PPT_Sample.pptx) - HTML 幻灯片: [`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-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) --- ## 功能特性 | 功能 | 描述 | | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **像素风格办公室** | 动态办公室视图,代理可在 6 个部门之间行走、工作和参加会议 | | **工作流 Pack 档案** | 内置 `development`、`report`、`web_research_report`、`novel`、`video_preprod`、`roleplay` 六类 Pack,可按 Pack 切换路由结构、QA 规则与输出模板 | | **办公室 Pack 档案** | 支持按 Pack 独立管理部门拓扑、命名/主题种子,以及员工与部门数据(开发 Pack 维持既有 DB 基线行为) | | **看板任务面板** | 完整任务生命周期 — 收件箱、已计划、协作中、进行中、审阅中、已完成 — 支持拖拽操作 | | **CEO 聊天与指令** | 与团队负责人直接沟通;`$` 指令支持会议选择与项目路径/上下文路由(`project_path`、`project_context`) | | **多提供商支持** | Claude Code、Codex CLI、Gemini CLI、OpenCode、Kimi Code、Antigravity — 统一仪表板管理 | | **外部 API 提供商** | 通过设置 > API 选项卡将代理连接到外部 LLM API(OpenAI、Anthropic、Google、Ollama、OpenRouter、Together、Groq、Cerebras、自定义端点),并可直接使用 OpenCode Go / Bailian 官方预设 | | **OAuth 集成** | GitHub 与 Google OAuth,AES 加密令牌本地存储于 SQLite | | **实时 WebSocket** | 实时状态更新、活动动态及代理状态同步 | | **活跃代理控制** | 查看工作中代理的进程/活动/空闲元数据,并可对卡住任务执行强制停止 | | **任务报告系统** | 完成报告弹窗、历史列表、团队报告详情与规划负责人最终汇总归档 | | **员工管理** | 员工招聘、编辑、删除,支持多语言姓名、部门/职级/提供商选择及性格设定 | | **代理排名与经验值** | 代理完成任务可获得经验值,排行榜追踪顶尖表现者 | | **技能库** | 600+ 分类技能(前端、后端、设计、AI、DevOps、安全等),支持自定义技能上传 | | **会议系统** | 支持计划内及临时会议,AI 生成纪要并支持多轮审阅 | | **Git Worktree 隔离** | 每个代理在独立的 git 分支中工作,仅在 CEO 批准后合并 | | **多语言界面** | 英语、韩语、日语、中文 — 自动检测或手动设置 | | **即时通讯集成** | Telegram、Discord、Slack 等 — 通过内置直连频道会话发送 `$` CEO 指令并接收任务更新(OpenClaw 可选) | | **PowerPoint 导出** | 从会议纪要和报告生成演示文稿幻灯片 | | **通信 QA 脚本** | 内置 `test:comm:*` 脚本,可带重试与证据日志验证 CLI/OAuth/API 连通性 | | **应用内更新提示** | 检查 GitHub 最新发布,发现新版本时在顶部显示含 OS 区分 `git pull` 指引和发布说明链接的横幅 | | **部门管理** | 规划、开发、设计、QA/QC、DevSecOps、运营 — 专用管理选项卡支持箭头/拖拽排序编辑 | | **员工手动指派** | 为项目指定特定员工后,会议和任务委派仅针对指定员工运行 | | **精灵注册安全防护** | 通过 `409 sprite_number_exists` 响应防止重复精灵编号文件覆盖 | | **自定义技能上传** | 通过 UI 上传 `.md` 技能文件为 CLI 代表培训自定义技能,配有黑板教室动画和管理界面 | --- ## 技术栈 | 层级 | 技术 | | ---------------- | --------------------------------------------------- | | **前端** | React 19 + Vite 7 + Tailwind CSS 4 + TypeScript 5.9 | | **像素艺术引擎** | PixiJS 8 | | **后端** | Express 5 + SQLite(零配置嵌入式数据库) | | **实时通信** | WebSocket (ws) | | **数据校验** | Zod 4 | | **图标** | Lucide React | | **路由** | React Router 7 | | **导出** | PptxGenJS(PowerPoint 生成) | ## AI 安装指南 > 本节面向 AI 编程代理。请逐步执行,并在每一步运行验证命令后再继续。 ### 第 0 步:检查前置条件 ```bash # Node.js 22+ node -v # pnpm(如缺失则启用 corepack) pnpm -v || corepack enable # git git --version ``` ### 第 1 步:克隆并执行一键安装 ```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 ``` ### 第 2 步:验证安装结果 macOS/Linux: ```bash # 关键文件检查 [ -f .env ] && [ -f scripts/setup.mjs ] && echo "setup files ok" # 检查 AGENTS 编排规则 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 必要 .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 必要 .env 项 Get-Content .\.env | Select-String -Pattern '^(INBOX_WEBHOOK_SECRET|OPENCLAW_CONFIG)=' ``` ### 第 3 步:启动并健康检查 ```bash pnpm dev:local ``` 在另一个终端执行: ```bash curl -s http://127.0.0.1:8790/healthz ``` 期望结果:`{"ok":true,...}` 消息渠道在设置 UI 中配置,并持久化到 SQLite(`settings.messengerChannels`)。`.env` 中的消息令牌/频道变量已不再使用。 ### 第 4 步:可选消息渠道 + inbox 验证 ```bash curl -s http://127.0.0.1:8790/api/messenger/sessions ``` 将返回设置中保存的消息会话列表。 ```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 校验","skipPlannedMeeting":true}' ``` 期望结果: - 服务器已配置 `INBOX_WEBHOOK_SECRET` 且 `x-inbox-secret` 匹配时返回 `200` - 头缺失或不匹配时返回 `401` - 服务器未配置 `INBOX_WEBHOOK_SECRET` 时返回 `503` ### 第 5 步:不依赖 OpenClaw 的消息渠道直连 无需 OpenClaw,也可以仅用 Claw-Empire 直接配置并运行消息渠道。 1. 打开 `Settings > 频道消息`。 2. 点击 `新增聊天`。 3. 选择消息渠道(`telegram`, `whatsapp`, `discord`, `googlechat`, `slack`, `signal`, `imessage`)。 4. 填写会话信息: - `名称`(会话标签) - 渠道 token/凭证 - `Channel/Chat ID`(目标) - 对话 `Agent` 映射 5. 点击 `确认` 即立即保存(不需要额外“全局保存”)。 6. 启用会话并测试: - 普通消息 -> 与映射 Agent 直接对话 - `$ ...` -> 指令流程 说明: - 消息会话会保存到 SQLite(`settings.messengerChannels`)。 - 消息渠道 token 在落库时会使用 AES-256-GCM 加密,密钥优先使用 `OAUTH_ENCRYPTION_SECRET`(未设置时回退到 `SESSION_SECRET`),仅在运行时收发阶段解密。 - `.env` 中的消息渠道变量(`TELEGRAM_BOT_TOKEN`, `DISCORD_BOT_TOKEN`, `SLACK_BOT_TOKEN` 等)不再使用。 - `/api/inbox` + `INBOX_WEBHOOK_SECRET` 仅用于 webhook/inbox 流程(含 OpenClaw bridge)。 --- ## 快速开始 ## Docker 部署(快速) 当前仓库已提供面向生产的 Docker 默认配置: - 默认以**非 root 用户**运行(`app`,uid/gid `10001`) - 内置运行所需工具(`git`、`bash`、`openssh-client`) - 使用标准文件名:`docker-compose.yml` + `Dockerfile` - 运行数据落盘到 `./data`(已加入 git 忽略) ### 1)准备环境变量文件 ```bash cp .env.example .env.docker ``` 创建 `.env.docker.private`(仅本机保存的敏感配置): ```bash cat > .env.docker.private <<'EOF' # Claude Code 兼容端点 ANTHROPIC_BASE_URL=https://api.minimaxi.com/anthropic ANTHROPIC_API_KEY=YOUR_ANTHROPIC_API_KEY EOF chmod 600 .env.docker.private ``` > `.env.docker*` 已被 git 忽略(规则 `.env.*`),默认不会提交 token。 ### 2)启动 ```bash docker compose up -d --build ``` ### 3)验证 ```bash docker ps --filter name=claw-empire docker logs -f claw-empire ``` 访问:`http://127.0.0.1:8790` ### 可选:推送镜像到 GHCR ```bash # 需要 packages write 权限的 GitHub Token echo "