Paperclip：73k Star 的多智能体调度神器，一条命令组一支 AI 团队
同时开着 Claude Code、Cursor、Codex，却各干各的没法协作？Paperclip 是 GitHub 超 7 万 Star 的开源框架，把多个 AI Agent 编排成一家"公司"——定目标、分任务、设预算、盯进度。本文讲清它是什么、能做什么、怎么一条命令本地跑起来。
先给你结论：如果你同时用多个 AI 编程/执行 Agent、又想让它们朝同一目标协作而不是各干各的，Paperclip 就是那个"把它们管起来"的开源调度层。 它把自己定位成"公司"而不是"员工"——Claude Code 当 CTO、Codex 当工程师、Cursor 当设计师，由 Paperclip 定目标、分任务、设预算、盯进度。项目在 GitHub 已超 7.3 万 Star，本文讲清它是什么、能做什么、怎么本地跑起来。
一句话结论
Paperclip 是一个开源的多智能体协调框架：它本身不写代码，而是把多个 AI Agent 编排进一套"组织架构"里，通过角色、汇报线、心跳调度、预算与工单，让不同 Agent 像一个团队那样朝共同目标协作。装好只需一条命令，数据可本地自托管。
它解决什么问题
你桌面上可能同时开着 Claude Code 写代码、Cursor 改前端、Codex 跑数据——但它们是"各自为战"的：
| 痛点 | Paperclip 的解法 |
|---|---|
| Agent 之间互不认识、无协作 | 建立角色/职称/汇报线的组织架构 |
| 没有统一目标，各干各的 | 任务绑定到项目与公司级目标 |
| 预算各花各的、易跑飞 | 每 Agent 月度预算，到上限自动停 |
| 进度靠人手动盯 | 心跳机制定时叫醒、自动汇报 |
| 出问题难排查 | 操作留审计日志、配置可回滚 |
一句话：它给一群会干活的 Agent，配了一套"公司管理"。
核心能力一览
| 能力 | 说明 |
|---|---|
| 自带 Agent 入职 | Claude Code、Codex、Cursor、Gemini CLI、bash、OpenClaw、HTTP 机器人均可接 |
| 目标对齐 | 任务和项目/公司目标挂钩，Agent 知道"为什么干" |
| 心跳调度 | 按时间表叫醒 Agent、查状态、该干干该汇报 |
| 成本治理 | 月度预算 + 审批雇佣/暂停/终止 |
| 工单系统 | 记录每次对话/工具调用，任务依赖有序 |
| 审计回滚 | 操作留痕，配置版本化，可回滚 |
本地怎么跑起来
方式一：一条命令（推荐先试）
npx paperclipai onboard --yes想绑到局域网或 Tailscale：
npx paperclipai onboard --yes --bind lan
# 或
npx paperclipai onboard --yes --bind tailnet若npx报错（常见是私有 registry 问题），强制走公共源： ``bash npx --registry https://registry.npmjs.org paperclipai onboard --yes``
方式二：拉源码手动跑
git clone https://github.com/paperclipai/paperclip.git
cd paperclip
pnpm install
pnpm dev- API 服务跑在
http://localhost:3100 - 嵌入式 PostgreSQL 自动创建，不用手动配
- 环境要求：Node.js 20+，pnpm 9.15+
首次使用三步
- 新建公司：首次打开有新手引导，点"新建公司"起个名字
- 添加员工：第一个 Agent 会自动设为 CEO（建议放能力最强的模型），再按需加工程师/设计师等，并配置心跳间隔
- 测试跑通：在 Agent 详情页点"测试环境"，看到正常回显说明配置成功
避坑提示
- 先设预算再跑：别让 Agent 裸跑，避免循环把 API 额度烧光
- 明确每个 Agent 的角色与汇报线：架构乱，调度效果就打折
- 从 2-3 个 Agent 起步：先跑通"CEO 派活 + 工程师执行"的最小闭环，再扩展
- 代码/结果要人审：Agent 会一本正经地"完成"任务，关键产出仍需人工把关
小结
Paperclip 抓住了一个真实痛点——多 Agent 各自为战、缺乏统一管理。它用"给 Agent 当公司"的思路，把调度、预算、任务、审计整合起来，适合同时折腾多个 AI Agent 或想做"AI 一人公司"的开发者。是否值得用，取决于你的 Agent 数量和协作复杂度：Agent 多了、要协作了，它就能明显省心；单 Agent 场景则用不上。