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