01

什么是 Paperclip?

想象你雇了 20 个 AI 员工,但他们互不认识、没有目标、会乱花你的钱——Paperclip 解决的就是这个问题

你打开了 20 个 Claude Code 窗口

这是很多 AI 重度用户的真实处境:一个窗口在写代码,一个在回邮件,一个在做市场分析,一个在运行客服……

问题随之而来:哪个窗口在做什么?它们之间如何协调?花了多少钱?如果你重启电脑,所有上下文都消失了。

⚠️
没有 Paperclip 的世界

你的 AI 员工各自为战,没有共同目标,没有预算约束,一个死循环就能烧掉几百美元的 token 费用,你还不知道。

Paperclip 是"AI 公司的操作系统"

Paperclip 的定位非常清晰:它不是一个 AI,而是管理 AI 的平台。就像公司需要 HR 系统、财务系统、项目管理工具,你的 AI 团队也需要一套管理基础设施。

🏢
OpenClaw/Claude = 员工

实际执行工作的 AI 代理,能接受任务、使用工具、产出结果

📋
Paperclip = 公司管理层

负责分配任务、追踪进度、控制预算、治理决策——让 AI 员工有组织地工作

👤
你 = 董事会

设定战略目标,批准重要决策,监督整体方向,随时可以暂停或终止任何代理

Paperclip 解决了什么问题?

🎯

目标对齐

每个任务都自动携带"为什么做这件事"——从公司使命到具体任务,AI 始终知道 why

💰

成本可控

每个 AI 代理有月度预算上限,超额自动暂停,不会出现"账单惊喜"

📚

持久记忆

任务跨越多次"心跳"(唤醒周期)持续进行,重启不丢失上下文

🛡️

治理机制

重要决策需要你批准,所有操作有完整审计日志,任何时刻可回滚

启动方式:一行命令

Paperclip 的设计哲学是零摩擦。整个平台本地自托管,内置 内嵌 PostgreSQL 数据库,无需额外配置:

CODE

# 方法一:最快启动(npx 直接运行)
npx paperclipai onboard --yes

# 方法二:手动安装
git clone https://github.com/paperclipai/paperclip.git
pnpm install
pnpm dev
            
PLAIN ENGLISH

npx 是"临时运行一个工具"的命令,不需要事先安装

onboard 是入职向导,--yes 跳过所有确认提示,使用默认配置

如果想自己管理代码,可以 git clone 下载源码

pnpm install 安装所有依赖包(类似安装所需的零件)

pnpm dev 启动开发服务器,API 监听 3100 端口

02

组织架构系统

Paperclip 如何用"公司 + 项目 + 代理"三层结构组织 AI 团队

真实公司的三层结构

Paperclip 的数据模型直接映射了真实公司的组织方式。想一想你熟悉的公司结构——

公司层 (Company)

🏢
AI 笔记应用公司

项目层 (Project)

📁
核心产品
📢
市场推广

代理层 (Agent)

👔
CTO (Claude)
💻
工程师 (OpenClaw)
🎧
客服 (Bot)
点击任意组件,了解它的职责

代理不只是"AI 实例"——它有身份

在 Paperclip 里,每个 代理 都有完整的"工作档案":

role 职位描述:它做什么(例如:"负责前端开发的高级工程师")
adapter 使用哪个 AI 工具:Claude Code、OpenClaw、Codex、HTTP bot 等
reports_to 汇报给谁:定义了授权委托链,任务可以向上或向下流动
monthly_budget 每月 token 预算上限(以美元计),超额后自动暂停
skills 运行时注入的技能文档,告诉 AI 代理如何使用 Paperclip 特定工作流

AI 公司的"对话"

看看当 CEO 代理收到一个用户需求时,组织内部是如何流转的——

组织架构知识测试

CEO 代理需要把一个技术任务委派给 CTO 代理。Paperclip 里哪个属性决定了这种层级委派关系?

03

心跳执行引擎

AI 代理不是时刻都在运行的——它们按"心跳"节律唤醒,这是 Paperclip 最精妙的设计之一

AI 代理像什么?不是一直在线的服务员

很多人以为 AI 代理是"永远在线的机器人"。Paperclip 的设计更聪明:代理是按需唤醒的

更准确的比喻是一位随叫随到的值班医生:有人呼叫(心跳触发),医生起来处理,处理完继续休眠,等待下次呼叫。这样既省资源,又能持续可用。

💓
为什么不让代理一直运行?

持续运行意味着持续消耗 token,成本失控。心跳模式让代理只在有工作时消耗资源——就像按需打车,不是包月雇司机。

一次心跳执行的完整流程

当 Paperclip 决定唤醒一个代理时,内部走过了 9 个步骤。让我们一步步追踪:

调度器
🔒
执行控制
🤖
代理适配器
点击"下一步"追踪一次心跳执行

持久会话:跨心跳的记忆

Paperclip 最重要的特性之一:会话状态持久化。代理不会每次唤醒都"忘了上次做了什么"。

架构设计

// 心跳 #1(周一下午)
agent.execute({
  task: "实现用户登录功能",
  session_state: null  // 首次运行
})
// 运行 45 分钟后,心跳时间到
saveSessionState({ progress: "JWT 已完成,还需要 refresh token" })

// 心跳 #2(周一晚上)
agent.execute({
  task: "实现用户登录功能",
  session_state: { progress: "JWT 已完成,还需要 refresh token" }
})  // 从上次进度继续
            
PLAIN ENGLISH

第一次心跳:代理从零开始处理这个任务

传入的 session_state 为空,代理不知道之前做了什么

运行了 45 分钟,心跳周期到了,自动暂停

暂停前保存进度:"我完成了 JWT 部分,下次从 refresh token 继续"

第二次心跳:同样的任务被重新启动

这次携带了上次保存的进度,代理可以从断点继续,不用重新开始

心跳机制知识测试

网络卡顿导致一次心跳执行卡住没有正常结束。你担心下次心跳触发时,同一个代理会同时运行两个实例。Paperclip 哪个机制防止这种情况?

04

预算与治理

AI 代理失控的两大原因——花钱太多、做错决策。Paperclip 如何用系统解决这两个问题

AI 失控的两种方式

使用 AI 代理的人都遇到过这两个噩梦:

💸

失控循环

代理进入死循环,每隔几秒调用一次 API,一夜之间消耗几百美元。你醒来才发现账单已经爆炸。

🚫

越权决策

代理"自主"删除了生产数据库的一个表,或者发布了你没审查过的代码。无法回滚。

Paperclip 用两套系统同时解决这两个问题:预算控制治理审批

多层预算系统

Token 消耗被 Paperclip 在五个维度上追踪和限制:

公司级预算 整个公司所有代理的总月度上限——最终防线
代理级预算 每个代理独立的月度上限,超额后该代理自动暂停
项目预算 某个项目下所有代理的合并上限
警告阈值 达到 80% 时触发警告通知,让你提前介入
硬停止 达到 100% 时立即停止,不接受新工作,已排队的也取消
💡
原子预算检查

预算检查是"原子性"的——检查和扣减是不可分割的一个操作,保证即使两个代理同时查询,也不会同时读到"还有余额"然后都超支。就像银行转账,要么全部成功,要么全部失败。

治理审批:你才是最终决策者

有些操作太重要了,不能让 AI 独立决定。Paperclip 的治理系统给你设置一道"人工审查关卡":

1
代理触发审批请求

代理想执行某个需要审批的操作(如发布代码到生产),暂停并等待

2
你收到通知

Paperclip 通知你(通过 UI 或移动端),展示代理的计划和影响

3
你决策

批准则代理继续执行;拒绝则代理收到反馈,需要调整方案

4
决策记录在案

你批准了什么、何时、基于什么理由——全部写入不可篡改的审计日志

预算与治理知识测试

你的客服 AI 代理因 bug 进入了处理循环,短时间内大量调用 API。你想确保最坏情况下它能造成的费用损失可控。最直接的解决方法是?

05

构建你的 AI 公司

从系统理解到实际落地——如何用 Paperclip 的架构思路设计你自己的 AI 团队

Paperclip 的完整技术架构

现在你了解了各个部分,让我们把它们拼在一起——Paperclip 服务器的 12 个子系统:

核心系统

🔑
身份与权限
📋
工作与任务
💓
心跳执行
🛡️
治理与审批

基础设施

💻
工作区运行时
💰
预算成本控制
🔒
Secrets 与存储
🔌
插件系统
点击任意系统,查看详细说明

为什么 Paperclip 不只是另一个任务管理工具

很多人第一反应:把 AI 指向 Asana 或者 Linear 不就行了吗?这忽略了代理协调的核心难题:

普通任务工具的问题

// 问题 1:谁在处理这个任务?
// Asana 没有"代理正在运行"的概念
// 两个代理可能同时开始同一个任务

// 问题 2:代理能"读"任务但能做什么?
// 没有内置的 Secrets 注入
// 代理需要自己找 API 密钥

// 问题 3:花了多少钱?
// Asana 不知道代理调用了多少 token
// 没有预算约束机制
            
PLAIN ENGLISH

Paperclip 通过原子锁解决:同一任务同一时刻只有一个代理可以"检出"执行

Paperclip 内置 Secrets 管理:代理运行时自动从加密存储注入需要的 API 密钥

Paperclip 追踪每次运行的 token 消耗,汇总到多层预算体系,实时控制

综合测试:你懂 Paperclip 了吗?

你用 Paperclip 为客户 A 搭建了一套完整的 AI 公司架构(含 CEO/CTO/工程师代理、所有项目配置)。现在客户 B 想要类似的架构。你希望复用而不是从零开始,应该用 Paperclip 的哪个功能?

你希望客服代理每小时自动检查一次新的用户工单,不需要你手动触发。应该配置什么?