把 Claude Code、Cursor、Kimi Code 同时开四五个 tab 在桌面跑,本来就是 2026 年下半年 AI 工程师的日常。问题是它们各自重启即消失、改完一处要手动同步到下一处、忘记哪个终端在跑什么、token 烧光才反应过来——这些痛点 Paperclip 给了一次性答案:GitHub 已接近 9.8 万 star 的开源 AI 公司控制平面,把代理们装进「任务 + 组织架构 + 财务」三层控制台,Claude Pro/Max 订阅直接消耗,自心跳、自审稿、自停机。本文是实测,不是单看 README 就开始吹:逐节跑完官方教程,对照本地操作看效果,顺便把每个关键截图都贴出来,把坑也列清楚。

本文所有结论基于实测 2026-10 当时的 paperclipai/paperclip 主分支(API/v2026.1012.0),Claude Code 适配器走 claude_local,订阅登录走 ~/.claude/.config.json 本地凭证。

一、Paperclip 解决了什么:多 Agent 失控的统一控制平面

第一时间打开 Paperclip 看到的公司主页,顶部是公司目标与 KPI,中部是 agent 列表与最近工作产物

桌面同时开着七八个 Claude Code 终端,各自的会话上下文分散在本地。系统一重启,所有 session 一起蒸发——即便每个 agent 干的事都不复杂,整体也拼不回一条可追溯的工作流。Paperclip 的官方定位就是为这种场景而生,README 里写得很直白:「If OpenClaw is an employee, Paperclip is the company」——把每个 agent 从「会话实例」抬升到「公司员工」,配齐组织架构、汇报对象、目标与预算四件套。

实测下来,Paperclip 的产品抽象可以一句话讲清:它是「任务系统 + 组织架构图 + 财务系统」三合一,员工全员 AI,跑在你的机器上而不是某个 SaaS 后面,数据不外发、API 密钥不出本机。三层堆叠之后,所有多 Claude Code 终端协作时的痛点——会话不可见、改完不可追溯、token 不可控——被一次性收编。

二、上手第一步:30 秒从零开始建一家「AI 公司」

主界面:打开 Paperclip 默认的首页 —— 公司目标、组织架构、最近工作产物

Paperclip 提供两种部署形态:本地一台机器跑 all-in-one,或者 VPS 上跑 systemd 服务。我选的是本地单机版,Node 24 已就绪时一条命令拉起:

1
npx paperclipai onboard --yes

首次运行会拉一个 1.4 GB 的内置 PostgreSQL 包,看到进度条长时间不动先别慌——后端在 unzip、initdb、配置 pg_hba,正常要 1–3 分钟。装完浏览器自动开 http://localhost:3100,四步引导:

  1. 填公司名(随便取,后面能改):我填的是「AI 视频工作室」。
  2. 填第一位员工的名:实测填「小程」。
  3. 点 Claude 订阅卡片:Paperclip 自动读取本机 ~/.claude/.config.json 的 login 凭证,无需我手动复制 key。
  4. 出现「小程 ready」绿色提示框 → 进控制台。

公司建好的瞬间,Paperclip 已经替我完成三件事:在内部任务系统生成 AI-1 欢迎任务,初始化「小程」这个 agent,以及建立 CEO = 人、CTO = 小程 的最小化组织架构。第一次打开看到的不是空白仪表盘,而是一个已经在等你下指令的公司——这是 Paperclip 跟传统任务管理工具最大的体感差异。

三、首员工小程:Claude 订阅直连,不烧美元只烧 token 配额

员工详情页:小程的人事档案、汇报对象(董事会 = 你)、模型连接(订阅直连)、状态(空闲)

claude_local 适配器是 Paperclip 当前最稳的一档适配器。员工详情页里能直接看到四件事:「汇报对象 = 董事会(也就是我)」「职位 = 默认 agent」「状态 = 空闲」「订阅连接 = ✓」。绿色对勾那一栏就是凭证状态——只要 .config.json 里有有效登录,Paperclip 不会要求新填 API 密钥。这意味着:

  • Claude Pro / Max 订阅可以直接消耗;
  • 公司账单显示 0 美元,因为它走的是按月订阅;
  • 只在它超过订阅额度时才会提示升级,不会按 token 量加收——这是 Paperclip 对个人/小团队的最大价值。

唤醒小程有两条路:分配任务(推送 / 评论触发)和心跳定时器(他定期醒过来查 inbox)。实测选的是分配任务:在任务面板填标题与描述,指派给小程,点击创建后弹出的 AI-2 就是他接到的新任务编号。在他的角度,「接到工单」就是被叫醒。

如果你想让他连续休假——比如周末不想被跑活的 agent 打扰——，详情页顶部的 暂停 按钮会把他整体停掉,期间分配的任务自动标 Blocked,不烧一 token。需要恢复时,在任务黄色提示栏点「恢复代理」即可。我用一个测试任务(『测试暂停』)实测:小程停掉后,任务状态秒变 Blocked,等他恢复后又自动重启。这跟 GitHub Actions 的 concurrency 控制是同一思路,但触发权下放到了 agent 维度,适合「让这个 AI 休息,不打扰那个 AI」的精细控制。

四、预算刹车:10 美元上限、80% 警告、100% 强制停机

预算面板:为整个项目设置 10 美元上限,实时显示已花费与剩余比例

如果说第三个亮点是「让员工干得久」,第四个就是「让员工不会失控」。Paperclip README 反复警告过:「一个失控的 agent loop 可以在你发现之前烧掉几百美元的 token」。这不是吓唬人,只要跑过 claude -p 长循环的开发者都被教育过。Paperclip 对应的解药是把预算写成一阶公民:

阈值 行为 适合谁
80% 黄色警告通知 想压低烧钱速度、又不想完全停的人
100% 强制停止当前 run 想兜底防失控的人
自定义 任意金额上限 公司、agent、项目三个层级各自独立设置

实测中我把公司预算设为 10 USD,小程帮我跑批量化选题时,UI 实时显示当前花费与剩余比例。注意这里有一个反直觉的细节:订阅直连模式 下,小程在 Claude 控制台消耗的是「月配额」而不是美元,所以公司账单会一直显示 0 USD——预算数字更像是一个「软上限提示器」,真要兜底还是要靠订阅本身的 quota。但走 API 适配器(如 codex_local 走 OpenAI key)时,这个 10 USD 是真金白银的硬上限,100% 时 Paperclip 会强杀 run。这是设计上「订阅用、控制 API」的折衷。

五、例程(Routines):每天 9 点自动派工,跳过工作日不用学 cron

Routines 面板:每天 9:00 自动派给小程的工作单,带「仅工作日」开关与历史运行记录

纸面配置看起来好玩,但真正能让「AI 公司」自己跑起来的是例程(Routines),可以理解为一条带日历语义的 cron,但比 cron 友好得多。我给小程建了一条 9:00 工作日早选题 的例程:

  • 触发时段:每天 09:00。
  • 目标 agent:小程(CEO=我,员工=小程)。
  • 重复规则:工作日(下拉菜单直接选,不用学 cron 表达式)。
  • 派工内容:自动生成一份「今日待办选题工作单」。
  • 历史运行:每次执行都进 Runs 面板,可点进去看小程具体跑了什么。

实测有两条细节设计让人觉得这产品是真的被自家团队在用:

  1. 重叠跳过:上一次跑没跑完,新的不会堆——这是在大量 cron 致「开机一堆积任务」痛点之后的成熟设计。
  2. 错峰跳过:错过的时间段不会补跑,9 点钟我电脑在休眠,10 点才打开——它不会在这时补一个 9 点的任务。

如果你想立刻验证而不是等明天,在例程面板点 立即运行 即可触发;在历史 Run 里能看到小程写的评论、产物和成本折算。这是 Paperclip 跟 LangGraph / CrewAI 这种「agent framework」最大的体感差异:它是把 agent 当员工看待,所以会有 Runs 历史、可暂停、可重跑——这是框架视角下没有的维度。

CLI 输出:在终端用 paperclipai CLI 查询公司、agent 与成本汇总

喜欢命令行的同学会发现,Paperclip 还提供了一个 paperclipai CLI,用法跟 dev server 的 REST 对齐。下面三条命令基本能覆盖日常管理需求:

1
2
3
4
5
6
7
8
# 查看公司 ID(每个公司有唯一 ULID)
paperclipai companies list

# 用公司 ID 拉所有 agent 详情(JSON)
paperclipai agents list --company <id>

# 查询某公司当月成本汇总
paperclipai costs summary --company <id>

实测在 macOS 上 zsh 补全跑得很顺,JSON 输出可以直接 jq 二次处理。CLI 在调试场景的实用性,主要体现在 CI/CD 流水线里——后续接 GitHub Action 自动巡检 agent 健康度是天然路径。

六、招聘第二位员工肖生:组织架构 + AI 互审,质量自动把关

招聘肖生:在代理页面选 Claude、保留订阅连接、设职位与汇报对象为小程

一个人的公司跑稳以后,该进入「团队协作」了。我又招了第二位员工——肖生,让他向小程汇报。Paperclip 的「汇报对象」字段就是组织架构图的边:第一个员工向董事会(也就是我)汇报,第二个员工向第一个员工汇报,就形成两层管理结构。界面上的调整是一次拖拽,后台是组织图的拓扑变更——这跟 Notion 数据库加一个 select 字段完全不是一回事:Paperclip 把汇报关系当成权限模型的一部分,子 agent 能看到父 agent 的工作产物,反过来则不行。

实测一个非常关键的体验:让肖生回顾 AI-2 的选题。任务不需要我手动搬上下文,肖生会从公司的「内部界面」自己读小程写的评论,然后在自己的工作产物里给反馈。这就把「一个 agent 写、另一个 agent 审」的协作模型跑通了:

肖生的评审输出(摘自 Paperclip Runs 面板):对三个候选主题分别评「✓ 通过 / ✗ 修正」,在评论里给出可执行的修订意见。

这种「AI 同事互审」模式在以下三种场景下是显著优于单人模式的:

  • 涉及事实核查、引用来源验证的「内容生成」任务。
  • 涉及 PR review / 测试覆盖率的「代码 review」任务。
  • 涉及多角度权衡的「方案选型」任务。

只要把任务分配给两个彼此汇报的员工,Paperclip 就会自动派生一轮 review——不需要额外的 workflow 配置。这也是它跟 AutoGen、CrewAI 这种「多 agent 框架」的真正壁垒:Paperclip 不是在「写代码跑 agent」,而是在「管理一支 agent 团队」。

七、本地化 vs 自部署:数据与凭证边界在哪

同事的 Review 评论:肖生在评论里给出主题的可执行修改意见

走完一遍流程,最后想聊的是大家最关心的安全边界。Paperclip 在 README 与官方 docs 里反复强调:

  • 自托管 = 一切跑在你机器上:任务、线程、文档、API 密钥都不出你的硬件。
  • 适配器隔离:Claude 凭证走 claude_local 适配器时,Paperclip 不会写到自己的数据库;订阅登录态来自 ~/.claude/.config.json,会话期间只在内存里存在。
  • 预算硬上限:API 模式下,100% 一定会强杀 run,不靠 agent 自己知道停。

实测订阅模式下,小程消耗 token 是真的从 Anthropic 那边扣月配额,跟直接 claude -p 是一回事——区别是 Paperclip 替你把会话、日志、产物都记下来了。所以从安全角度,Paperclip 是「透明的中间层」,不是「黑盒 SaaS」。对生产数据敏感(医疗 / 法律 / 内部代码)的企业,这个特性比它的功能本身更重要。

八、结论:它适合谁,不值得谁

实测结论很简单:如果你已经在用 Claude Code、Cursor、Kimi Code 中的任意一个跑长任务、又同时苦于多终端协作混乱,Paperclip 是当前 GitHub 上「个人/小团队 AI 公司」抽象最完整的开源实现。它解决的痛点是真的,文档也是真的,本地 30 秒拉起也是真的。

但 Paperclip 也不是银弹,以下三类场景建议你先观望:

场景 建议
个人 side project,只跑单文件改写 太重,直接 claude -p 够了
多 SaaS 模型 + MCP 全栈,要求每秒级低延迟 Paperclip 仍是分钟级任务编排,不适合实时交互场景
想在云端跟团队多人协同 走的是 VPS 自部署 + auth 模式,需要自己运维 Nginx / Let’s Encrypt,不算开箱即用

最后,想自己跑的话最低门槛是:Node.js 24+ + pnpm + Claude Pro/Max 订阅(可选)+ 一台能跑得动 Claude Code 的机器。十分钟内能拉起,有手就能试。

本文结构与功能点对应 Paperclip 主分支 v2026.1012.0,部分截图来自官方 paperclipai/paperclip 仓库与本地实测的操作界面。视频化的步进演示与脚本可以对照文中命令直接复现。

相关阅读: