Paperclip

測試版： Paperclip 仍處於早期開發階段。此模板和軟體可能會有無法預期的問題。

Paperclip 是一個 AI 多代理協調平台，用於協調多個 AI 代理（Claude、Codex、Cursor、OpenClaw 等）自主運營業務。提供 Node.js 伺服器搭配 React UI，管理代理團隊、分配目標、追蹤工作並監控成本。

開始使用

1. 部署模板並等待服務啟動。
2. 開啟 Zeabur 指令（Paperclip 服務）。
3. 建立第一個管理員帳號：

   pnpm paperclipai auth bootstrap-ceo
   

4. 複製輸出的邀請連結，在瀏覽器中開啟並註冊。
5. 登入您偏好的 AI 工具 — Codex 或 Claude Code（請參閱下方 AI 代理認證）。
6. 建立代理時，將 Working directory 設定為 /paperclip/ 下的路徑（例如 /paperclip/workspaces/my-project）。
7. 點擊 Test now 執行適配器環境檢查。成功結果會顯示 hello probe succeeded。
8. 設定完成後，將 Zeabur 環境變數 PAPERCLIP_AUTH_DISABLE_SIGN_UP 設為 true 以禁止未授權的註冊。

AI 代理認證

目前僅支援指令登入。環境變數認證（OPENAI_API_KEY / ANTHROPIC_API_KEY）尚無法使用。

工具	指令登入
Codex	gosu node codex login --device-auth
Claude Code	gosu node claude login

注意事項

• 請務必使用 gosu node 前綴執行指令中的 CLI 工具。以 root 執行會導致權限問題。
• Codex 裝置驗證： 執行登入指令前，請先至 ChatGPT Security Settings 開啟「Enable device code authorization for Codex」。
• OPENAI_API_KEY is not set 警告： 如果您已透過 codex login 驗證，可以安全忽略此警告。

重要事項

• 持久化儲存： 僅 /paperclip/ 下的資料在重啟後保留。其他路徑皆為暫存。
• 工作目錄： 請勿使用 /app——該路徑包含 Paperclip 原始碼，更新時會被覆蓋。請使用 /paperclip/ 下的路徑（持久化）。
• 註冊控管： 建立管理員帳號後，將 PAPERCLIP_AUTH_DISABLE_SIGN_UP 設為 true。需要邀請新使用者時暫時設為 false，完成後再改回 true。

變更紀錄

2026-04-22 — v2026.416.0

• 更新映像至上游版本 v2026.416.0（ghcr.io/paperclipai/paperclip:sha-b8725c5）
• 新增：外部適配器插件系統，支援動態 UI 解析器與宣告式設定 schema
• 新增：議題層級顯示（可摺疊、子任務計數、狀態持久化）
• 新增：回饋投票與評估用的拇指投票流程
• 新增：執行工作區，支援執行階段控制與專案工作區分頁
• 新增：工作區感知的 Routine 執行
• 改進：收件匣郵件客戶端式鍵盤快捷鍵與「今天」分隔線
• 改進：行動版版型、深色模式、適配器覆寫 UI
• 安全性：BETTER_AUTH_SECRET 與 PAPERCLIP_AGENT_JWT_SECRET 啟動時現為必要（本模板已預設）

2026-04-07 — v2026.403.0

• 更新映像至上游版本 v2026.403.0（ghcr.io/paperclipai/paperclip:sha-a072377）
• 從 Docker Hub（zeabur/paperclip）切換至上游 GitHub Container Registry（ghcr.io/paperclipai/paperclip）
• 持久化磁碟路徑由 /home/node/ 改為 /paperclip/
• CLI 指令前綴由 runuser -u node -- 改為 gosu node
• 新增：一級阻礙/依賴關係支援，子任務完成時自動喚醒
• 改進：伺服器 log 中的 Bearer token 遮罩
• 改進：CEO 代理 onboarding 改用相對路徑
• 改進：行內編輯器貼上 markdown 自動格式化
• 多項 UI 路由、側邊欄、worktree 及代理流程的錯誤修正

2026-03-30 — v2026.325.0

• 更新映像至上游版本 v2026.325.0（自 v0.3.1 以來 652 個 commit）
• 新增：收件匣「我的」分頁與封存流程
• 新增：Hermes 適配器支援
• 新增：成本控制面板（帳務、配額、預算管理）
• 新增：Plugin SDK，支援文件 CRUD 與事件匯流排
• 新增：Worktree 支援，提供隔離的代理工作區
• 新增：公司匯入/匯出，含組織圖 SVG
• 改進：代理詳情分頁重整（提示詞、技能、指令）
• 改進：Docker 中嵌入式 Postgres 穩定性
• 多項適配器修正（Codex、Pi、OpenCode、Cursor）

2026-03-16 — 首次發佈

• Paperclip AI 代理協調平台的 Zeabur 模板
• 服務：PostgreSQL 17 + Paperclip（預建映像 zeabur/paperclip，amd64 + arm64）
• 啟動腳本在首次啟動時自動產生 config.json
• 伺服器透過 runuser 以 node 使用者身份執行（Claude Code CLI 所需）
• 單一持久化磁碟掛載於 /home/node/
• 預裝 CLI 工具：claude-code、codex、opencode-ai

連結

• 官方文件
• GitHub