EmperorClaw

社区

为使用 AI 代理运营的公司打造的自托管平台。

分类: 其他第 179 / 230
Stars: ★ 515 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js 20+ · Docker
凭据: 需要 API Key / 凭据
许可证: 其他 / 未声明
最近提交: 6 天前

45FMRS · D

EmperorClaw 为管理 AI 代理运营提供了一个全面的自托管平台，具有运行时独立性、持久任务租约、知识管理、管道和人工审批等功能。它非常适合希望为多代理工作流建立可靠、可审计记录的组织，但需要有基础设施来运行长期 Node.js 进程和 PostgreSQL。

最强项 · 安装易用性 12/20 最弱项 · 可靠性 6/20

可靠性

6/20

安全与权限

7/20

维护活跃度

8/20

文档质量

12/20

安装易用性

12/20

查看各项评分依据

可靠性 6/20: 无法验证服务器是否能干净启动或完成MCP初始化和工具列表握手，因为未提供服务器清单。README声明了广泛的MCP API，但没有提供实际工具列表或测试证据。存在CI工作流和测试的迹象，但没有具体细节。扣分是因为缺乏可验证的执行证据和明确的MCP工具表面。
安全与权限 7/20: 代码库似乎包含正常的认证机制（NextAuth、Argon2、JWT、Bearer令牌），以及AES-256-GCM加密和文件路径清理的提及。然而，没有发现关键安全漏洞，但作为审查者，我无法检查代码，因此权限和确认机制不够明确。由于安全边界和危险操作确认的不可见性，给出7分。
维护活跃度 8/20: 项目活跃，有275星、0个未解决问题、常规提交和清晰的治理模型。许可证为FSL-1.1-Apache-2.0，这限制了竞争性托管服务，但允许分叉和修改。更新机制和备份脚本已经存在。扣分是因为缺少SECURITY.md和依赖管理细节的可见性。
文档质量 12/20: README提供了全面的概述、安装说明、架构细节、功能矩阵和配置参考。然而，缺少具体的MCP工具定义、参数、限制和故障排除指南。文档没有明确列出所有MCP工具及其参数，这限制了可操作性。扣分是因为MCP细节覆盖不足。
安装易用性 12/20: 安装步骤清晰，支持一键Docker安装、手动设置和手动安装，提供配置示例和部署约束说明。然而，由于无法验证安装脚本，且需要PostgreSQL和长期运行进程，安装步骤假设性较大。基础设施要求记录清楚，但基于静态审查，可能需要在真实环境调整。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件访问网络连接数据库

适合谁

使用 AI 代理运营并需要持久运营状态的数字代理机构
需要客户隔离知识和审计跟踪的会计和记账公司
需要结构化工件存储和审批流程的咨询公司
运营 AI 代理后端的电商公司
需要多代理工作流协调的软件公司

不适合谁

正在寻找聊天机器人或提示包装器的人
需要完全无服务器部署而不使用持久 WebSocket 连接的用户
寻求开源许可（非 Fair Source）的团队
寻找轻量级任务管理工具而非运营平台的用户

所需权限

需要访问 PostgreSQL 数据库以存储状态
需要能够维持持久 WebSocket 连接
可能需要本地文件系统或外部存储后端（如 Bunny CDN）存储工件
需要环境变量中的秘密（如 NEXTAUTH_SECRET、EMPEROR_CLAW_MASTER_KEY）

风险与副作用

自托管：如果未正确配置，存在数据丢失风险；需要定期备份
不是开源许可（Fair Source），限制将其作为竞争性商业产品/服务提供
需要 Node.js 20+ 和 PostgreSQL 16 作为要求
不支持无服务器平台；需要长期运行的进程，如 VPS 或专用服务器

安装接入

准备工作

运行环境：Node.js 20+ · Docker

POSTGRES_CONNECTION_STRING 必填密钥 PostgreSQL 16 数据库连接字符串，必需。

NEXTAUTH_SECRET 必填密钥会话加密密钥，可用 openssl rand -base64 32 生成，必需。

EMPEROR_CLAW_MASTER_KEY 可选密钥用于AES-256-GCM加密集成密钥，推荐设置，可用 openssl rand -hex 32 生成。

其他可选配置项（7 个）

DEPLOYMENT_MODE 可选部署模式：self-hosted（默认）或 cloud。

STORAGE_BACKEND 可选存储后端：local（默认）或 bunny。

DRIVE_SYNC_ENABLED 可选启用Google Drive镜像发现，需要可选的 drive Compose profile。

DRIVE_RCLONE_REMOTE 可选 rclone远程名称，默认 gdrive。

DRIVE_ROOT 可选 Drive目标文件夹，默认 Emperor-Claw。

SMTP_HOST 可选 SMTP服务器，用于邀请和密码重置邮件，未设置则禁用。

EMPEROR_PLATFORM_ADMIN_EMAILS 可选逗号分隔的邮箱列表，授予 /ops 平台管理权限。

使用 curl -fsSL https://raw.githubusercontent.com/emperorclaw/emperorclaw/main/install.sh | bash 命令运行一键安装脚本，或使用适用于 Windows 的 PowerShell 脚本。
打开 http://localhost:3000 并创建管理员账户。或者，手动克隆仓库，复制 .env.example 为 .env，填写必需的环境变量，运行 npm install、npm run db:migrate、npm run build 和 npm start。

验证是否装好

安装后打开 http://localhost:3000 创建管理员账号，在 Settings → Tokens 生成MCP token，配置agent后观察其注册、心跳和任务认领情况即证明连接成功。

常见排障

确保 Node.js 版本 >= 20
检查 PostgreSQL 连接字符串是否正确
确认迁移已通过 `npm run db:migrate` 运行
验证 WebSocket 连接未被防火墙阻止
检查是否有看门狗进程在运行（通过 PostgreSQL 咨询锁确保）

试试这样问

连接成功后，可以直接对 AI 助手这样说：

让agent通过MCP API注册并认领一个任务
查看当前在线的agent状态和心跳
为项目创建一个新任务并分配给agent
在Company Brain里查找关于这个客户的知识条目

使用场景

为 AI 代理工作流程创建持久的、可审计的运营记录

协调多个客户的项目和任务，并带有租约和审批关卡

在代理执行前，通过作用域知识（Company Brain）向代理提供上下文

通过任务租约、重试和死信机制跟踪任务生命周期

通过管道注册和运行报告，可视化并监控 AI 工作流

详细介绍

EmperorClaw 是一个自托管、运行时中立的运营平台，用于协调 AI 代理、客户、项目、知识、工件、审批和事件。它提供持久化的工作流程状态，作为整个员工队伍（人类和 AI 代理）的单一记录系统。它不执行代理逻辑或调用 LLM，而是围绕代理执行提供协调、记录和可见性。它利用 PostgreSQL 存储状态，通过 WebSocket 实现实时功能，并包括一个看门狗进程用于租约过期和死信处理。