101k Star！GitHub爆火的多智能体神器，一条命令搭起AI一人公司

阅读全文

⭐⭐⭐ Spring Boot 项目实战	⭐⭐⭐ Spring Cloud 项目实战
《Dubbo 实现原理与源码解析 —— 精品合集》	《Netty 实现原理与源码解析 —— 精品合集》
《Spring 实现原理与源码解析 —— 精品合集》	《MyBatis 实现原理与源码解析 —— 精品合集》
《Spring MVC 实现原理与源码解析 —— 精品合集》	《数据库实体设计合集》
《Spring Boot 实现原理与源码解析 —— 精品合集》	《Java 面试题 + Java 学习指南》

摘要: 原创出处 http://www.iocoder.cn/Fight/paperclip-ai-company/ 「芋道源码」欢迎转载，保留摘要，谢谢！

🙂🙂🙂关注微信公众号：【芋道源码】有福利：

RocketMQ / MyCAT / Sharding-JDBC 所有源码分析文章列表

RocketMQ / MyCAT / Sharding-JDBC 中文注释源码 GitHub 地址

您对于源码的疑问每条留言都将得到认真回复。甚至不知道如何读源码也可以请教噢。

新的源码解析文章实时收到通知。每周更新一篇左右。

认真的源码交流微信群。

桌面上经常同时开着好几个 AI 代理，Claude Code 一个窗口，Cursor 一个标签页，再加一个 Codex CLI。写代码的写代码，跑数据的跑数据，搜素材的搜素材，各干各的，互不搭理。

想让它们协作就得自己当调度，可这些代理之间根本不认识，没有上下级，没有汇报线，预算也是各花各的。Paperclip 就是来管这件事的，它不给代理写代码，它给代理当公司。

Paperclip 官方封面，一人一支代理团队

给代理当公司的那个东西

它本身是一个开源的 Node.js 服务端加一个 React 前端，开发者有句原话说得很准，OpenClaw 是员工，Paperclip 是公司。它自己不写代码，只管人，Claude Code 可以当 CTO，Codex 当工程师，Cursor 当设计师。

职责是给它们定目标、分任务、设预算、盯进度。上级往下派活，下级做完往上交，心跳机制按时叫醒它们，该干干，该汇报汇报。它不管你能不能写代码，只保证这件事有人在盯。

Paperclip 如何调度多个代理

仓库目前十万多 Star，三月开源的，MIT 协议，最近一次提交就在今天。

paperclipai/paperclip 仓库首页

代理要能入职，活才派得下去

能接进来的东西比想象中多，Claude Code、Codex、Cursor、Gemini CLI、bash 脚本、OpenClaw，甚至你自己写的 HTTP 机器人。每个代理有角色、职称、汇报线、预算，适配器官方已经写好了，把接入点配进去就行。真要说，接入这件事被做成了填空，难的是想清楚你要这堆代理干成什么。

开发者那句话挺土但很实在，只要能接收心跳，就能入职。

任务跟公司目标、项目目标、具体工单绑在一起，代理知道自己为什么干这个，不只是看到一个标题。心跳按时间表叫醒代理，检查状态，再把结果往上报。一个目标拆到哪一层、谁负责哪一段，在面板上都能追回去。

目标对齐与心跳调度

预算和审批是它的刹车

每个代理有月度预算，花到上限自动停，不会出现那种跑疯了的循环把额度烧光。雇佣、暂停、终止任何代理都需要审批。

成本控制与治理

操作留审计日志，配置变更带版本控制，改错了能回滚。这一点比看起来重要，没设上限吃过亏的人才知道。代理跑起来之后，你其实很难逐条盯着它做了什么，所以能查、能回滚这两件事必须由系统兜住。

组织架构也是完整的一套。代理有老板、有头衔、有职位描述，工单系统记录每次对话和每次工具调用，任务之间有依赖关系，阻塞项没解决，下游不会启动。上下文从任务往上流到项目和公司目标，代理始终知道自己在干什么。

一个实例可以跑多个公司，数据互相隔离，手机上也能监控。同时折腾几个 side project 的人，这一条能省不少切换的麻烦。

一行命令，本地起一个实例

开源、自己托管、不用注册账号。默认走本地回环，第一次跑最快。

npx paperclipai onboard --yes

想配成局域网或者 Tailscale，加一个参数。

npx paperclipai onboard --yes --bind lan
# 或者走 tailnet
npx paperclipai onboard --yes --bind tailnet

npx 报错多半是私有 npm registry 的问题，强制走公共源就行。

npx --registry https://registry.npmjs.org paperclipai onboard --yes

也可以手动拉源码跑。

git clone https://github.com/paperclipai/paperclip.git
cd paperclip
pnpm install
pnpm dev

API 服务跑在 3100 端口，嵌入式 PostgreSQL 会自动创建，不用手动配。前置要求是 Node.js 20 以上、pnpm 9.15 以上。装的过程没有账号体系要打通，也没有云端控制台要点，整条链路都在本机。

本地跑起来之后的架构

第一次打开，先建公司

首次打开会有一个新手引导页，点新建公司。

新建公司

公司名随便起，填完就进控制面板。这一步其实是把「一家公司」当成一个隔离单位，后面所有的代理、工单、预算都挂在它下面。

填写公司名

面板一开始是空的，得先加至少一个员工。第一个加进去的会自动成为 CEO，也就是总管，建议用你能打的那个模型。

添加第一个员工

接着选适配器。

选择适配器

几个员工按这个模式加完，再配心跳间隔。

配置心跳间隔

然后创建代理。

创建代理

创建完别急着派活。到代理详情页点一下测试环境，确认配置通了。

测试环境

通了之后就能让员工干活了。这是最终仪表盘的样子。

配置完成后的仪表盘

它的功能模块和页面还有很多，这里只截了几张，剩下的自己配一遍就摸清了。值得一提的是，这套流程跑通之后，你再接第二个、第三个代理就快得多，因为适配器和心跳参数都能复用。

它还是个早期项目

同时开多个代理干不同的事，管理成本只会越来越高。Paperclip 把自己定位成公司而不是员工，这个区分很有价值，眼下流行的「一人公司」模式，前提就是得有人把这些 Agent 调度起来。

生态还在长，社区在推插件，仓库的 Star 也还在涨。放在一年前，让几个不同的 AI 代理围绕同一个目标协作，还得自己写调度脚本，现在这件事被收进了一个界面里。

Star 增长曲线

不过它离成熟还有距离。开源才半年多，issue 区还堆着六千多个未关闭的问题，说明坑不少。现阶段它更适合爱折腾、能接受边用边修的人，想找一个装上就零维护的团队工具，还得再等等。

仓库在 https://github.com/paperclipai/paperclip