一、这个项目解决的是什么问题
我最疯的时候同时开着二十个 Claude Code 终端。哪个在跑、哪个卡在等输入、哪个已经把活干完了,全靠肉眼扫。电脑一重启,二十个标签全没,上下文清零,得挨个重新喂一遍背景。
Paperclip 就是冲这个场景做的。它自己的比喻很到位:如果 OpenClaw 是一个员工,Paperclip 就是一家公司。它不做 agent,它给一堆 agent 配组织架构、任务、预算和审批。装完之后你面对的不是一堆终端,而是一个任务面板,一个组织架构图,一张成本表。
它也不管你用什么模型。Claude Code、Codex、Cursor、Gemini CLI、OpenCode、Kimi Code、Grok、Pi、Hermes,都能招进来。自定义进程、HTTP 端点、外部适配器包也能扩。文档里的原话是:只要能收心跳,就能入职。
二、核心设计机制
第一条是任务即工单。每条工作是一个 issue,带公司、项目、目标、父任务的链接,支持阻塞依赖、评论、文档、附件、交付物、标签、收件箱状态。关键在原子签出:只有一个负责人,配合执行锁,防止两个并发运行抢同一个任务。
第二条是心跳。它不是常驻进程一直烧 token,而是数据库支撑的唤醒队列,带合并。agent 因为被分配了工作、收到跟进消息、或者到了配置的时间表才醒来。每次运行产出日志、用量记录和适配器自己的会话状态。支持的失败有有界恢复,需要人介入的情况会被摆出来。
第三条是目标血缘。任务挂在项目上,项目挂在公司目标上。agent 干活时看到的不只是一个标题,还有它为什么存在。这条是它反复强调的差别:管业务目标,不是管 PR。
第四条是预算与治理。按公司、agent、项目、目标、issue、provider、模型几个维度记 token 和钱,可以设阈值告警和硬停。执行策略里能配评审和审批阶段,配置变更是有版本的,改坏了能回滚。
三、功能拆解
任务管理器这块是日常用的最多的。任务线程把对话、计划、阻塞、文件、运行历史都挂在工作上,可以指派给 agent 也可以指派给人。审批和评审门决定任务算不算完成。
组织架构这块管权限和边界。人和 agent 在同一张图里,有角色、有汇报线、有职责。公司级的作用域检查保证同一个部署里多个组织的数据互相看不见。
技能这块叫 Skill Studio。可以装或者写共享技能,用保存好的输入去测,看结果,还能恢复到历史版本。技能有版本历史,这点比手工管文件夹靠谱。
成本这块值得单独说。它记的是上报的用量,所以硬停不是瞬时的——用量上报和在途工作会让停止延后一点,文档自己写明了这一点。
另外还有例程。cron、webhook、API 三种触发,每次执行建一条被跟踪的 issue 并唤醒负责的 agent,不用人手动踢。并发策略和补跑策略都能配。
四、适合谁,不适合谁
适合同时开着一堆 agent 终端、已经开始分不清谁在干什么的人。适合想让 agent 24/7 跑但又要能审计、能随时插话的人。适合要盯成本、要卡预算的人。也适合想从手机上看一眼自己那摊自动化生意的人。
不适合只用一个 agent 干一件事的人,那是给自己找活。不适合把它当成 agent 框架的人,它明确说自己不教你怎么造 agent。也不适合期待开箱即用、不想配环境的人。
五、几个需要提前知道的限制
第一,它是个服务端。本地跑是单个 Node 进程管一个内嵌 Postgres 和本地文件存储,生产环境要指到你自己的 Postgres。它不是那种下载一个 dmg 双击就完事的桌面应用。
第二,环境要求不低。Node.js 24.11 起,pnpm 9.15 起。要用本地的 Claude 和 Codex 订阅登录,宿主机上还得有 Python 3 和对应的 provider CLI。源码开发时如果要构建原生 Runner,还得装 Rust 工具链,或者用 PAPERCLIP_RUNNER_BINARY 指一个预编译的。
第三,遥测默认开着。它收匿名使用数据,声明不收集个人信息、issue 内容、提示词、文件路径和密钥,私有仓库引用会用每实例的盐做哈希。要关的话有四个办法:PAPERCLIP_TELEMETRY_DISABLED=1、DO_NOT_TRACK=1、CI=true 时自动关、或者在配置文件里写 telemetry.enabled: false。
第四,预算硬停不是保险丝。它靠已记录的用量判断,上报有延迟,在途的活也可能继续跑一段。真要卡死成本,阈值要留余量。
第五,公司导出包不等于备份。导出会省略被引用的密钥值,但普通环境变量值和本地路径可能留在包里,分享前要看一遍。整实例恢复得靠备份。
第六,npm 私有源会撞坑。如果你全局 .npmrc 指向了私有 registry,npx 可能拿不到这个包,报 E404。
六、项目现状
版本 v2026.1117.0,星标 115565,MIT 许可。项目方说自己合并过两千七百多个 PR,路线图上已经勾掉的有插件系统、定时例程、预算、评审审批、多人类用户、云沙箱 agent、MCP 工具网关、密钥管理、活动日志、自愈运行、技能版本历史、文档评论、全公司搜索、多模型多 harness 团队。还标着在做的有记忆与知识、agent 聊天、云部署。没动的有工作队列、自组织、桌面应用、接第三方工单系统。
它带可选的 OpenTelemetry 追踪,只有设了 OTEL_EXPORTER_OTLP_ENDPOINT 才激活;也带可选的 Sentry 错误监控,前后端分别用两个环境变量开。这些都是可选依赖,不装就不生效。
七、常见问题
问:它跟 Claude Code、OpenClaw 是什么关系?
答:它用它们。它不造 agent,它把这些 agent 编排成一家公司,管组织、预算、目标、治理和问责。
问:必须注册账号吗?
答:不用。开源、自托管,不需要它的账号。本地跑起来就是一个进程。
问:agent 是一直在跑吗?
答:不是。它们为被分配的工作和跟进消息醒来,也可以开定时心跳去查活。光在评论里 @ 一下,不会派活也不会唤醒别的 agent。
问:能同时跑几家公司?
答:一个部署可以承载多个组织,数据、agent、权限、活动历史都按公司隔离。
问:数据存在哪?
答:本地默认是内嵌 Postgres 加本地文件存储,也能换成你自己的 Postgres 和 S3 兼容存储。
问:跟直接把 agent 接到 Asana 上有什么区别?
答:谁签出了哪条活、会话怎么续、成本怎么盯、治理怎么落地,这些细节它替你做了。接自己的工单系统还在路线图上。
下载地址
夸克网盘(永久有效):https://pan.quark.cn/s/800c00a62336
本教程由「宝藏星球屋」整理,更多软件、游戏、开源项目都在 https://cbge.top。






















暂无评论内容