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 代理，為企業提供與管理人類員工相同的組織架構，同時將所有資料完全掌握在自己手中。