emperorclaw/emperorclaw

EmperorClaw – AI代理人的自托管控制中心

是什么 – 一个单一的 Node.js/Next.js 应用程序（支持 Docker 安装），位于人员与您运行的任何基于 LLM 的代理之间。它提供 Web 仪表板和 API，使代理能够注册、领取任务、交换消息并存储结果，而人类用户则可以查看看板式面板、知识库、文件存储、聊天记录和审计日志。

为何存在 – 当您拥有多个自主代理时，很快就会失去可见性：您不知道哪个代理在做什么，任务是否失败，输出存储在哪里，或者应用了哪些规则。EmperorClaw 将所有状态记录在 PostgreSQL 中，并通过 UI 展示，为您提供与管理人类团队相同的组织工具。

核心功能

功能	提供的价值
任务看板	看板视图、负责人、状态、审批节点
客户目录	每个客户独立的上下文、文件和知识
公司大脑	针对公司、项目、客户或代理范围的维基式知识库
安全存储	分层文件存储（默认本地，可选 Bunny CDN 或 S3 兼容后端）
团队聊天	持久化、可路由的人类与代理之间的对话
工作流	可重复、可视化的流程，包含审批步骤和完整审计日志
代理生命周期	注册、心跳、自动重试、事件标记
访问控制	邀请制注册、基于角色的权限、公司级 API 密钥
自托管	在任何支持 Docker、PostgreSQL 16、Node ≥20 的 VPS/VM 上运行；无云锁定

适合谁使用 – 代理机构、会计事务所、咨询公司、电商或软件公司、招聘公司，以及任何希望拥有可审计、集中管理的 AI 后台的小型企业。

快速上手 – 仓库自带一行式 Docker 安装脚本：

# mac/linux
curl -fsSL https://raw.githubusercontent.com/emperorclaw/emperorclaw/main/install.sh | bash
# windows (PowerShell)
irm https://raw.githubusercontent.com/emperorclaw/emperorclaw/main/install.ps1 | iex

该脚本会创建 PostgreSQL 容器，运行迁移，生成密钥，并在 http://localhost:3000 启动 Web 应用。注册后，您可以：

1. 雇佣一个代理（选择角色，提供 LLM API 密钥）。
2. 通过简单的“Hello”消息验证代理是否在线。
3. 创建项目，添加任务，分配任务，并在看板上观察进度。

可扩展性 – EmperorClaw 通过通用的 MCP API 与代理通信。它自带以下适配器：

• OpenClaw（原生桥接）
• Hermes（浏览/爬取运行时）
• 任何您构建的 MCP 兼容运行时。

安全与隐私 – 密码使用 Argon2 哈希，JWT 会话，SHA-256 哈希的 API 密钥，存储的 LLM 凭据使用主密钥加密，存储路径防遍历，速率限制，以及“最后管理员保护”防止被锁死。

许可证 – Fair-Source License (FSL-1.1)，允许自托管、修改和商业使用，但禁止将产品作为竞争性托管服务转售。发布两年后，代码将自动重新许可为 Apache 2.0。

了解更多 –

• 文档：https://github.com/emperorclaw/emperorclaw（包含安装指南、首个代理入门教程和架构细节）
• 讨论区：https://github.com/emperorclaw/emperorclaw/discussions
• Render 上的托管演示：https://render.com/deploy?repo=https://github.com/emperorclaw/emperorclaw

---

总结 – EmperorClaw 是一个真正的、生产就绪的平台，用于协调、追踪和审计多个 AI 代理，为企业提供与管理人类员工相同的组织架构，同时将所有数据完全掌控在自己手中。