Paperclip：79k 星的 Agent 编排系统，给 AI 员工发工资条和 KPI
Paperclip：79k 星的 Agent 编排系统，给 AI 员工发工资条和 KPI
如果你的 Agent 需要一个 HR 部门，就是这个项目。
Paperclip 的 README 里有句定位语，一句话讲清了它和 OpenClaw 的关系："If OpenClaw is an employee, Paperclip is the company."（如果 OpenClaw 是员工，Paperclip 就是公司。）
这个项目 2026 年 3 月 2 日创建，不到 6 个月冲到 79,143 星、14,502 fork、约 193 个贡献者，MIT 协议，TypeScript 写的自托管 Node.js 服务器 + React UI。它的自我介绍是"大家在工作中管理 Agent 都在用的开源 app"--从数字看这话不算吹。
它解决的问题是每个重度 Agent 用户迟早会撞上的：你开 20 个 Claude Code 标签页，重启全部丢失；一个失控循环烧掉几百美元 token；定时任务要手动触发；Agent 需要人盯着。Paperclip 的答案不是再造一个 Agent，而是编排已有的一群 Agent，把它们组织成一家公司。
本文提纲
- 三步开一家 AI 公司
- 公司隐喻是字面意思：Org Chart、预算、绩效
- 心跳模型：Agent 不是常驻的，是被叫醒的
- 四大支柱与十二个子系统
- 原子执行：不双跑、不超支
- "Paperclip 不是什么"：难得清醒的边界声明
- 上手与近期版本
三步开一家 AI 公司
README 给的使用模型就三步，每步都配了个例子：
| 步骤 | 动作 | 示例 |
|---|---|---|
| 01 | 定义目标 | "做一个 AI 笔记应用，做到 $1M MRR" |
| 02 | 招聘团队 | CEO、CTO、工程师、设计师、市场--任意 bot、任意 provider |
| 03 | 审批并运行 | 审查策略、设预算、按下启动键、仪表盘监控 |
注意第二步的"任意 bot、任意 provider"。Paperclip 的哲学是 Bring Your Own Agent（自带 Agent）：OpenClaw、Claude Code、Codex、Cursor、Gemini、Bash、HTTP/webhook bot 都行。官方口号："If it can receive a heartbeat, it's hired."（能接收心跳的，就录用。）
这个定位很聪明。Agent 框架的竞争已经白热化，每周都有新的 runner 出现--与其押注某一个，不如做它们上面那层。
公司隐喻是字面意思：Org Chart、预算、绩效
大多数产品用"公司"打比方，Paperclip 是字面执行：
- Org Chart：Agent 有老板、有职位、有岗位描述（job description），汇报关系是真实存储的结构
- 预算：每个 Agent 有 token 预算，相当于薪资；预算耗尽自动节流（相当于停发工资）
- 治理：雇佣要审批、策略可被人类覆盖、Agent 可暂停或"解雇"
- 绩效：Skill Studio 做技能培训，agent evals 做考核，甚至有 performance review
- 多公司隔离：一次部署跑多家隔离的"公司"，每个实体都 company-scoped
它的 FAQ 里对"和直接让 Agent 连 Asana/Trello 有什么区别"的回答，暴露了真正在做的事："Agent 编排的微妙之处在于怎么协调谁把工作 checkout 走了、怎么维持会话、怎么监控成本、怎么建立治理--Paperclip 替你做了这些。" 表面是任务管理器，底下是 org chart + 预算 + 治理 + 目标对齐的完整控制平面。
心跳模型：Agent 不是常驻的，是被叫醒的
Heartbeat（心跳）是 Paperclip 的执行核心，值得单独拆开讲。
Agent 不是 7x24 常驻进程，而是按调度或事件触发被唤醒。每次心跳背后是一条完整的流水线：DB 支持的唤醒队列（带合并）、预算检查、按需密钥注入、技能加载、adapter 调用，孤儿运行自动恢复。心跳既驱动定时任务（Routines & Schedules），也是外部 Agent 的接入协议--这就是"能接收心跳就录用"的技术含义。
配合心跳的是持久 Agent 状态：Agent 跨心跳恢复任务上下文，而不是每次重启重来。这条加在一起，才撑得起"加一个任务，Agent 干到完成为止，管理者只看产出"的使用模式。
四大支柱与十二个子系统
Paperclip 把自己组织成四大支柱（Four Pillars）：
- Agentic Task Manager -- 声明意图，Agent 干活，你验证产出（审批、review gate、从 diff/截图/测试验证）
- Org Chart for Agents -- 人类 + Agent 混合组织的角色、权限、边界，密钥按 scope 分发
- Agent Employee Training -- Skill Studio、组织级共享技能、evals、绩效评估
- Agentic OS -- 跨 provider 运行时、沙箱、MCP 服务器、SSO/RBAC/成本控制
README 的架构图是一个 Server 大盒子装着 12 个子系统，四个角上是各种 Agent 接入：
MERMAID_BLOCK_0
代码库结构印证了这个体量：server/（Express REST API，291 个服务模块）、ui/（React + Vite）、packages/db/（Drizzle schema + 迁移）、packages/adapters/（claude-local、codex-local、cursor-local/cloud、gemini-local、grok-local、hermes、kimi-local、openclaw-gateway、opencode-local、pi-local--注意 prime-agent 的 pi 也在列）、cli/。共约 5,400 个文件。
原子执行：不双跑、不超支
工程细节里最值得讲的两条：
原子任务 checkout。单指派任务模型加执行锁--两个 Agent 不会抓到同一个任务。听起来简单，但这是多 Agent 协作最容易翻车的地方：重复劳动、互相覆盖、一个任务被做两遍。
预算硬停。超支自动暂停 Agent 并取消排队的工作。token 烧钱是 Agent 生产化的头号事故源，Paperclip 把成本控制做成了执行层的强制约束，而不是事后报表。
还有几条同样关键的：任务携带完整的目标血缘（goal ancestry）--Agent 不只知道"做什么"，知道"为什么"；公司模板可导出导入，密钥自动清洗；运行时技能注入--Agent 在运行时学会工作流，不用重训。
"Paperclip 不是什么"：难得清醒的边界声明
README 里有一节 "What Paperclip is NOT"，这个坦诚度值得所有产品学习：
| 不是什么 | 原文解释 |
|---|---|
| 不是聊天机器人 | "Agents have jobs, not chat windows." |
| 不是 Agent 框架 | "我们不管你怎么造 Agent，我们管怎么运营一家由它们组成的公司" |
| 不是工作流构建器 | 没有拖拽管道，它建模的是公司 |
| 不是 prompt 管理器 | Agent 自带 prompt、模型、运行时 |
| 不是单 Agent 工具 | "一个 Agent 你大概不需要 Paperclip。二十个--你绝对需要" |
| 不是代码审查工具 | 编排工作，不编排 PR |
另外两个该知道的：遥测默认开启（PAPERCLIP_TELEMETRY_DISABLED=1 或 DO_NOT_TRACK=1 关闭，CI 里自动关）；对接 Asana/Linear/Jira 还在路线图上。
还有个背景故事值得一提：这个仓库本身就是用 Paperclip 管理的 Agent 大量参与开发的--AGENTS.md 里专门写了 agent 贡献者的 issue 规划、工作产物和 company-scoping 规则。吃自己的狗粮吃到这个程度的不多。
上手与近期版本
推荐安装走校验和验证：
curl -fsSLO https://paperclip.ing/install.sh
curl -fsSLO https://paperclip.ing/install.sh.sha256
if command -v sha256sum >/dev/null 2>&1; then
sha256sum -c install.sh.sha256
else
shasum -a 256 -c install.sh.sha256
fi
bash install.sh
零安装试用：npx --registry https://registry.npmjs.org paperclipai onboard --yes。开发部署：git clone 后 pnpm install && pnpm dev，API 在 http://localhost:3100，内嵌 PGlite（嵌入式 Postgres）自动创建，零配置。要求 Node.js 24.11+、pnpm 9.15+。
版本用 CalVer（YYYY.MDD.P）。v2026.817.0（8 月 17 日）是第一个走 canary -> nightly -> beta -> stable 四级通道的稳定版，311 个提交，含 Decisions 工作流和完整的公司导入导出。更早的版本里，v2026.722.0 加了运行绑定的密钥访问（按需取、每次读取审计留痕）、Windows 原生支持；v2026.720.0 加了 Skill Studio 和 Attention 队列；v2026.707.0 加了甘特图式的 Work Timeline 和自定义沙箱镜像。
路线图上已经交付的包括插件系统、OpenClaw agent 员工、定时例程、深度规划与计划审批、强制结果与看门狗、MCP Tool Gateway、密钥管理、自愈运行、agent evals；还在路上的有 Memory/Knowledge、Self-Organization、CEO Chat、桌面应用、自带工单系统。
最后给个适用判断。该用：你同时跑 5 个以上 Agent，被会话管理、成本失控、定时任务折磨。不该用：一两个 Agent 的个人用户--README 自己都说了你不需要它；想要拖拽式工作流编辑器的也不适合，它管的是公司不是管道。
参考文档与链接
- GitHub: paperclipai/paperclip - 79,143 星，MIT，TypeScript，Paperclip Labs 出品
- Paperclip 官网 - 产品与安装入口
- 官方文档 - 完整文档
- Discord 社区 - 实时讨论
- Twitter/X - 官方账号
- awesome-paperclip - 社区插件目录
- OpenClaw - Paperclip 最典型的"员工"Agent
- Drizzle ORM - 数据层 schema 与迁移
- PGlite - 内嵌 Postgres，开发环境零配置的关键
你现在同时跑几个 Agent？失控烧过最多的一次是多少钱？评论区聊聊惨案。觉得"给 Agent 建公司"这个方向对的，点个赞。
作者: itech001
来源: 公众号：AI人工智能时代(the-ai-era)
网站: https://www.theaiera.top/
关注每日最新AI新闻和技术博客，主页有更多的文章的AI 技术参考：https://www.theaiera.top
本文首发于 AI人工智能时代，转载请注明出处。
浙公网安备 33010602011771号