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