logo
icon

Paperclip

AI 多代理协调平台，用于管理多个 AI 代理自主运营业务。提供团队管理、目标分配、工作追踪和成本监控的集中仪表板。

template cover
部署次数360 次
发布者zeaburZeabur
创建于2026-03-15
源码查看源码
标签
AIAgent

模版内的服务

service icon

postgresql

postgres:17-alpine
service icon

paperclip

ghcr.io/paperclipai/paperclip:sha-911a1e8

Paperclip

测试版： Paperclip 仍处于早期开发阶段。此模板和软件可能会有无法预期的问题。

Paperclip 是一个 AI 多代理协调平台，用于协调多个 AI 代理（Claude、Codex、Cursor、OpenClaw 等）自主运营业务。提供 Node.js 服务器搭配 React UI，管理代理团队、分配目标、追踪工作并监控成本。

开始使用

  1. 部署模板并等待服务启动。
  2. 从 Zeabur Networking 分页打开 Paperclip 域名。
  3. 点击 Sign in / Create account，使用邮箱和密码注册。第一位注册的用户会自动成为实例管理员。
  4. 设置完成后，将 Zeabur 环境变量 PAPERCLIP_AUTH_DISABLE_SIGN_UP 设为 true 以禁止未授权的注册。
  5. 配置 AI 代理认证（请参阅下方 AI 代理认证）。
  6. 建立代理时，将 Working directory 设置为 /paperclip/ 下的路径（例如 /paperclip/workspaces/my-project）。
  7. 点击 Test now 执行适配器环境检查。成功结果会显示 hello probe succeeded。

替代方式： 也可以通过 Zeabur 命令创建第一个管理员：gosu node pnpm paperclipai auth bootstrap-ceo

AI 代理认证

方式一：环境变量（推荐）

在 Zeabur 环境变量中设置：

工具环境变量
Claude CodeANTHROPIC_API_KEY
CodexOPENAI_API_KEY

方式二：命令登录

打开 Zeabur 命令并执行：

工具命令登录
Claude Codegosu node claude login
Codexgosu 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

链接