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 設定為 /home/node/ 下的路徑（例如 /home/node/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	runuser -u node -- codex login --device-auth
Claude Code	runuser -u node -- claude login

注意事項

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

重要事項

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

變更紀錄

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