Paperclip 是什么:把一群 Agent 当公司来管

Paperclip 是一个自己部署的 Node.js 服务加网页面板,用来管理一整队 AI Agent:Claude Code、Codex、Cursor、OpenCode、Gemini CLI 都能挂进来,按组织架构分工、领任务、记花费。MIT 开源,GitHub 上已有 11 万多星。11 月 13 日我们对照仓库 README、官方文档和 v2026.1106.0 发布页整理了它的用法和边界。
它是什么
一句话:给同时跑很多个 Agent 的人用的任务和组织管理后台。界面看着像任务管理工具,底下是组织架构、预算、审批流和心跳调度。官方的说法是:单个 Agent 像一名员工,Paperclip 是公司。
| 仓库 | github.com/paperclipai/paperclip |
|---|---|
| 作者 | Paperclip 团队(paperclipai) |
| 许可证 | MIT |
| 热度 | GitHub 113,479 星(GitHub API,2026-11-13 15:15 北京时间);npm 包 paperclipai 上周下载 67,160 次(11-05 至 11-11) |
| 运行要求 | Node.js 24.11+;macOS / Linux 本机,或 Docker;可用自带的嵌入式 PostgreSQL,也可接自己的库 |
| 最新版本 | v2026.1106.0(发布于 2026-11-07 06:31,北京时间),含 515 个提交 |
解决什么问题
README 里列的痛点很具体:开着二十个 Claude Code 终端,记不清哪个在干什么,一重启全没了;每次都得手动给 Agent 补背景;Agent 跑进死循环,几百美元的 token 烧完才发现;周报、客服这类重复活还得自己记着去触发。
Paperclip 的对应做法:
- 任务化:每件事是一张工单,对话、计划、文件和运行记录都挂在工单上,重启后会话还在。
- 目标往下传:任务关联到项目和公司目标,Agent 领活时能看到「为什么做」。
- 原子领取:一个任务同一时间只有一个负责人,执行锁防止两个 Agent 抢同一张单。
- 预算和审批:公司、Agent、项目三级预算,到阈值告警,到上限自动暂停;招新 Agent、改策略要经过审批。
- 定时例行:Routines 按计划或 API、Webhook 触发,每次运行生成一张有负责人、有记录的任务。
| 对比项 | Paperclip | 单个 Agent CLI | 并行工作台(如 Paradev) |
|---|---|---|---|
| 管理单位 | 公司、项目、工单 | 一个会话 | 一个 worktree 工作区 |
| 多 Agent 协作 | 组织架构、上下级派活 | 无 | 并排运行,人来协调 |
| 花费控制 | 三级预算,到线自动暂停 | 看各家账单 | 不代理调用,不管花费 |
| 上手成本 | 要起服务、配 Agent 和预算 | 装上即用 | 装桌面应用 |
怎么用
先确认 Node 版本,再一条命令完成初始化。默认绑定本机回环地址,只有自己能访问:
node --version # 需要 v24.11.0 或更高
npx paperclipai@latest onboard --yes
想在局域网或 Tailscale 里用,换成带认证的模式:
npx paperclipai@latest onboard --yes --bind lan
# 或
npx paperclipai@latest onboard --yes --bind tailnet
只想先看看效果,可以用 test-drive 起一个带 CEO Agent 的临时实例,它在前台运行,不装后台服务:
ANTHROPIC_API_KEY=... npx paperclipai test-drive
OPENAI_API_KEY=... npx paperclipai test-drive --harness codex
官方「五分钟路径」分三步:建公司并写目标,招第一个 CEO Agent,等它第一次心跳。CEO 读完目标会提交一份策略,进审批队列;你批准后,它开始在看板上建任务。之后可以让 CEO 申请招更多 Agent,或者直接把任务派给某个 Agent。要长期跑,用 npx paperclipai install 装到 ~/.local/bin,支持一键更新、回滚和注册成后台服务。
用 claude_local 适配器的话,同一台机器上要先装好 Claude Code;用 codex_local 则准备 OpenAI 的 key。
核验记录
- 版本:v2026.1106.0 把 Paperclip Runner 设为新 Agent 的默认运行方式,新建的 Claude、Codex、OpenCode、Pi Agent 在 macOS 和 Linux x64 上直接走 Runner;GitHub Copilot 成为原生支持的 harness。
- 新功能:项目绑定的 GitHub 仓库会被自动当作 Skill 来源,每五分钟检查一次分支,每次运行固定当时的 Skill 版本;可选用 OpenRouter 上的模型在工具结果进入 Agent 前做提示词注入检测,默认关闭。
- 不兼容变更:Pipelines 实验功能被移除,旧数据保留;运行失败默认不再上报 Sentry;运行历史接口默认只返回 200 条。
- 联网:README 写明默认收集匿名使用统计,不含提示词、任务内容、文件路径和密钥,私有仓库名会加盐哈希;环境变量
PAPERCLIP_TELEMETRY_DISABLED=1、DO_NOT_TRACK=1或配置里telemetry.enabled: false都能关闭,CI=true时自动关闭。
Paperclip 管的是谁领了哪张单、花了多少钱、谁批准的,代码和文字还是各家 Agent 自己写。
适合谁,不适合谁
适合:已经同时养着好几个 Agent、开始管不过来的人;想让 Agent 定时跑周报、客服、内容这类重复工作,又要留审计记录的小团队;需要按人、按项目控制模型花费的团队。
不适合:只偶尔让 Agent 改几行代码的个人开发者,一个终端加 worktree 习惯就够了;Node 版本被锁在 22 以下的环境;没打算设预算就想让 Agent 全天自动跑的人。
最后
先用 test-drive 起一个临时实例,给 CEO 写一个小目标,并把公司预算设成 5 美元,看它提交的第一份策略和建出来的任务靠不靠谱,再决定要不要正式安装。