Paperclip
測試版: Paperclip 仍處於早期開發階段。此模板和軟體可能會有無法預期的問題。
Paperclip 是一個 AI 多代理協調平台,用於協調多個 AI 代理(Claude、Codex、Cursor、OpenClaw 等)自主運營業務。提供 Node.js 伺服器搭配 React UI,管理代理團隊、分配目標、追蹤工作並監控成本。
開始使用
- 部署模板並等待服務啟動。
- 從 Zeabur Networking 分頁開啟 Paperclip 網域。
- 點擊 Sign in / Create account,使用電子郵件和密碼註冊。第一位註冊的使用者會自動成為執行個體管理員。
- 設定完成後,將 Zeabur 環境變數
PAPERCLIP_AUTH_DISABLE_SIGN_UP 設為 true 以禁止未授權的註冊。
- 設定 AI 代理認證(請參閱下方 AI 代理認證)。
- 建立代理時,將 Working directory 設定為
/paperclip/ 下的路徑(例如 /paperclip/workspaces/my-project)。
- 點擊 Test now 執行適配器環境檢查。成功結果會顯示
hello probe succeeded。
替代方式: 也可以透過 Zeabur 指令建立第一個管理員:gosu node pnpm paperclipai auth bootstrap-ceo
AI 代理認證
方式一:環境變數(推薦)
在 Zeabur 環境變數中設定:
| 工具 | 環境變數 |
|---|
| Claude Code | ANTHROPIC_API_KEY |
| Codex | OPENAI_API_KEY |
方式二:指令登入
開啟 Zeabur 指令並執行:
| 工具 | 指令登入 |
|---|
| Claude Code | gosu node claude login |
| Codex | gosu node codex login --device-auth |
注意事項
- 請務必使用
gosu node 前綴執行指令中的 CLI 工具。指令以 root 執行,但憑證需儲存在 node 使用者主目錄(/paperclip/)下以持久化並供伺服器存取。
- Codex 裝置驗證: 執行登入指令前,請先至 ChatGPT Security Settings 開啟「Enable device code authorization for Codex」。
重要事項
- 持久化儲存: 僅
/paperclip/ 下的資料在重啟後保留。其他路徑皆為暫存。
- 工作目錄: 請勿使用
/app——該路徑包含 Paperclip 原始碼,更新時會被覆蓋。請使用 /paperclip/ 下的路徑(持久化)。
- 註冊控管: 建立管理員帳號後,將
PAPERCLIP_AUTH_DISABLE_SIGN_UP 設為 true。需要邀請新使用者時暫時設為 false,完成後再改回 true。
變更紀錄
2026-06-05 — v2026.529.0
- 更新映像至上游版本
v2026.529.0(ghcr.io/paperclipai/paperclip:sha-911a1e8)
- 簡化啟動:init.sh 現委託映像原生
docker-entrypoint.sh
- 新增:瀏覽器端首位管理員認領 — 無需終端即可設定首位管理員
- 新增:文件內嵌註解與按修訂版本的留言串
- 新增:企業技能 CLI 與目錄管理
- 新增:從側邊欄隱藏專案和代理(使用者級資源成員)
- 新增:Claude 模型即時探索
- 新增:Grok Build 作為一等本地執行環境
- 新增:Modal 沙箱供應商外掛(與 E2B、Cloudflare、Daytona 並列)
- 新增:工作區差異檢視器外掛
- 新增:Routine 密鑰,優先順序
agent < project < routine
- 新增:本地 Cloud Upstream 同步
- 新增:來源範圍的停滯工作復原操作
- 新增:Blocked Inbox 檢視用於分診阻塞任務
- 新增:透過
paperclipai plugin init 的本地外掛開發流程
- 新增:文件鎖定以確保代理間安全交接
- 新增:i18n 基礎(i18next、地區設定驗證)
- 改進:ACPX-Claude 適配器開箱即用
- 改進:有範圍的代理權限與指派控制
- 改進:看板縮放,支援緊湊卡片與可摺疊欄位
- 改進:從側邊欄暫停/恢復代理、虛擬化聊天串
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
連結