你有没有遇到过这样的场景:
打开电脑,发现桌面上有20个Claude Code标签页,每个都在干不同的活。有的在写代码,有的在修bug,有的在做文档——但你完全搞不清楚谁在干嘛,谁干完了,谁卡住了。更要命的是,重启电脑之后,所有上下文全丢了,每个AI都像失忆了一样,你得重新解释一遍”我们要做什么”。
这就像你开了一家公司,雇了20个员工,但没有HR、没有项目经理、没有打卡系统、没有工资单。员工们都很能干,但公司一团糟。
Paperclip 就是来解决这个问题的。
如果把AI Agent(智能体)比作一个员工,那 Paperclip 就是一家公司的管理系统——有组织架构、有任务分配、有预算控制、有审批流程。它不管你的AI有多聪明,它管的是”怎么让一群AI协同工作”。
什么是Paperclip?
Paperclip 是一个开源的AI Agent编排平台(Orchestration Platform),GitHub上有70.7k星标,采用MIT许可证。
用大白话说:它是一个”AI公司模拟器”。你可以在里面创建一家虚拟公司,招聘AI员工(Agent),给他们分配职位、设定目标、管理预算,然后看着他们自主工作。
一句话定义:如果 OpenClaw 是一个员工,那 Paperclip 就是一家公司。
它不是聊天机器人,不是代码框架,不是工作流工具。它是一个组织管理系统——用管理公司的方式管理AI。
核心概念:AI公司的”部门架构”
第一次打开 Paperclip,你会看到一堆术语。别慌,我们用开公司的方式来理解:
1. Company(公司)
类比:你的创业公司
Company 是最顶层的组织单位。一个 Paperclip 实例可以运行多家公司,每家公司完全隔离——就像一个控股集团下面有多个子公司。
比如你可以创建:
- “攀岩者科技” — 负责公众号和网站运营
- “开源项目部” — 负责GitHub开源项目
- “客户服务部” — 负责处理用户反馈
2. Agent(智能体/代理)
类比:你的AI员工
Agent 是能接收任务并执行的AI。Paperclip 支持接入各种AI:
- Claude Code — Anthropic的编程AI
- Codex — OpenAI的代码AI
- Cursor — AI编程编辑器
- Hermes — Nous Research的AI助手
- OpenClaw — 开源AI Agent框架
- 任何HTTP服务 — 只要能接收”心跳”,就能入职
用 Paperclip 官方的话说:”If it can receive a heartbeat, it’s hired.”(只要能接收心跳,就能被雇佣。)
3. CEO(首席执行官)
类比:你的AI总经理
当你初始化 Paperclip 时,系统会自动创建一个 CEO Agent。这个CEO负责:
- 理解公司目标
- 分解任务
- 分配给下面的Agent
- 监督工作进度
就像真正的CEO一样,它不一定亲自干活,但它知道公司要往哪走。
4. Org Chart(组织架构图)
类比:公司的组织架构
Org Chart 定义了Agent之间的汇报关系。比如:
`
CEO(总经理)
├── CTO(技术总监)
│ ├── Engineer-1(前端工程师)
│ └── Engineer-2(后端工程师)
├── CMO(市场总监)
│ └── Content-Writer(内容编辑)
└── CFO(财务总监)
└── Accountant(会计)
`
每个Agent都有自己的职位、权限、预算和汇报对象。任务可以从上往下分配,也可以从下往上请求。
5. Heartbeat(心跳)
类比:员工的”打卡+查收任务”
Heartbeat 是 Paperclip 最核心的机制之一。每个Agent都会定期”醒来”(比如每5分钟),检查:
- 有没有新任务?
- 之前的任务完成得怎么样?
- 需要向谁汇报?
这就像员工每天早上打开电脑,先看看邮箱里有没有新邮件,再继续昨天的工作。
为什么叫”心跳”? 因为它就像心脏跳动一样,定期触发,保持Agent”活着”。没有心跳的Agent就像睡着了的员工——能力再强也不会主动干活。
6. Issue(任务/工单)
类比:项目管理中的”任务卡”
Issue 是分配给Agent的具体工作。每个Issue包含:
- 标题:要做什么
- 描述:具体要求
- 指派人:哪个Agent负责
- 优先级:紧急/高/中/低
- 关联目标:这个任务服务于哪个公司目标
- 阻塞依赖:哪些任务必须先完成
Issue 有原子化执行锁——同一个任务不会被两个Agent同时认领,避免重复工作。
7. Goal(目标)
类比:公司的OKR/KPI
Goal 是公司或团队的长期目标。比如:
- “在3个月内将公众号粉丝增长到1万”
- “完成开源项目的v2.0发布”
- “将客户满意度提升到95%”
每个Issue都应该关联到某个Goal,这样Agent在执行任务时知道”为什么要做这件事”。
8. Budget(预算)
类比:部门经费
每个Agent都有月度预算限制(按token或金额计算)。当预算用完时,Agent会自动停止工作,不会产生额外费用。
这就像给每个员工发了一张信用卡,额度用完就不能再刷了。再也不用担心AI”跑飞了”烧掉你几千美元。
9. Governance(治理/审批)
类比:公司的审批流程
Governance 定义了哪些操作需要人工审批:
- 招聘新Agent
- 修改公司战略
- 执行高风险操作
- 超出预算的请求
就像公司里大额支出需要老板签字一样,Paperclip 确保AI不会在你不知情的情况下做出重大决策。
10. Adapter(适配器)
类比:员工的”工牌+工位”
Adapter 是连接不同AI的接口。每种AI需要不同的Adapter:
claude_code— 连接Claude Codecodex— 连接OpenAI Codexhermes_local— 连接本地Hermeshttp— 连接任何HTTP服务
就像不同品牌的打印机需要不同的驱动程序一样,不同AI需要不同的Adapter。
11. Routine(例行任务)
类比:定期汇报/周报
Routine 是定期自动执行的任务。比如:
- 每天早上8点:生成公众号早课
- 每天中午12点:抓取AI新闻生成午课速报
- 每周一:生成周报
Routine 可以用 cron 表达式、webhook 或 API 触发。
界面功能介绍:Web UI 详解
Paperclip 有一个漂亮的 Web UI(默认 http://localhost:3100),看起来就像一个现代化的项目管理工具。下面我带你逐个界面看看。
登录页面
打开浏览器访问 http://localhost:3100,首先看到的是登录页面。界面简洁现代,深色背景,有Email和Password两个输入框,以及”Sign In”按钮。
如果是第一次使用,点击”Create one”创建账号。
Dashboard(仪表盘)
登录后进入Dashboard,这是你的”公司总控台”。在这里你可以看到:
- 公司概览:当前运行的公司数量、Agent总数、活跃任务数
- Agent状态卡片:每个Agent的实时状态(工作中/空闲/错误/暂停)
- 成本统计:本月已花费的token和金额,图表展示
- 活动日志:最近的操作记录,谁在什么时间做了什么
Dashboard 就像公司的”作战指挥室”,一眼就能看清全局。
Agent管理页面
点击左侧导航栏的”Agents”,进入Agent管理页面。这里列出了所有已招聘的AI员工:
- Agent列表:显示每个Agent的名称、角色、状态、Adapter类型
- 创建新Agent:点击”New Agent”按钮,填写信息即可招聘新员工
- Agent详情:点击某个Agent,可以查看它的工作历史、配置信息、成本统计
在这个页面,你可以:
- 修改Agent的模型(比如从Claude换成GPT)
- 调整心跳频率(比如从5分钟改成10分钟)
- 设置月度预算上限
- 暂停或恢复Agent的工作
Issue管理页面
点击”Issues”,进入任务管理页面。这里就像GitHub Issues或Jira:
- Issue列表:显示所有任务,包括标题、状态、优先级、指派人
- 创建新Issue:点击”New Issue”,填写标题、描述、选择指派的Agent
- Issue详情:点击某个Issue,可以看到完整的执行日志、Agent的思考过程、工具调用记录
每个Issue都有状态流转:
open→ 新建,等待Agent认领in_progress→ Agent正在处理review→ 完成,等待人工审核done→ 审核通过,任务完成
Org Chart页面
点击”Org Chart”,可以看到公司的组织架构图。这是一个可视化的树状图:
- 拖拽调整:可以直接拖拽Agent节点,调整汇报关系
- 查看详情:点击节点,弹出Agent的详细信息
- 委派路径:设置任务如何从CEO层层下发到具体执行者
Org Chart 让你一目了然地看到”谁向谁汇报”,就像公司的组织架构图一样。
Activity Log(活动日志)
点击”Activity”,可以看到完整的操作审计记录:
- 时间线:按时间顺序列出所有操作
- 操作详情:谁在什么时间做了什么决策
- 成本变化:每次操作消耗了多少token
- 审批历史:哪些操作被批准,哪些被拒绝
Activity Log 是合规审计的重要依据,也是排查问题的利器。
实战教程:用Web界面创建你的AI公司
理论讲完了,现在我们来实操。下面我手把手教你用Web界面创建一家AI公司。
第一步:安装并启动Paperclip
`bash
# 安装Node.js(需要20+版本)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install 20
# 安装pnpm
npm install -g pnpm@latest
# 安装Paperclip
npm install -g paperclipai@latest
# 初始化(创建嵌入式数据库、CEO Agent)
npx paperclipai onboard –yes
# 启动服务
npx paperclipai run
`
启动后访问 http://localhost:3100 就能看到Web界面。
第二步:创建账号并登录
- 打开浏览器访问 http://localhost:3100
- 点击”Create one”创建账号
- 输入邮箱和密码
- 点击”Sign In”登录
第三步:创建公司
登录后,系统会自动创建一家默认公司。你可以在设置中修改公司名称和描述。
第四步:招聘Agent(通过Web界面)
- 点击左侧导航栏的”Agents”
- 点击”New Agent”按钮
- 填写Agent信息:
- Name:给Agent起个名字,比如”Engineer-Hermes”
- Role:选择角色,比如”engineer”
- Adapter:选择适配器,比如”hermes_local”
- 点击”Create”完成招聘
重复以上步骤,招聘更多Agent:
- CTO(技术总监)
- Engineer-1(前端工程师)
- Engineer-2(后端工程师)
- Content-Writer(内容编辑)
第五步:配置Agent
点击某个Agent进入详情页,可以配置:
模型设置:
- 选择Agent使用的AI模型(比如Claude、GPT、Hermes)
- 设置超时时间
- 启用会话持久化
心跳设置:
- 启用心跳(Heartbeat)
- 设置心跳间隔(比如每5分钟)
- 设置冷却时间(避免频繁触发)
预算设置:
- 设置月度预算上限(比如100美元)
- 设置警告阈值(比如80%时提醒)
第六步:创建任务(通过Web界面)
- 点击左侧导航栏的”Issues”
- 点击”New Issue”按钮
- 填写任务信息:
- Title:任务标题,比如”撰写Day32早课:多模态AI入门”
- Description:任务描述,详细说明要求
- Priority:选择优先级(Low/Medium/High/Urgent)
- Assignee:选择指派的Agent
- 点击”Create”完成任务创建
第七步:监控任务执行
任务创建后,你可以:
- 查看任务状态:在Issue列表中看到任务的状态变化
- 查看执行日志:点击任务详情,可以看到Agent的思考过程和工具调用记录
- 审核完成结果:当Agent完成任务后,你可以审核结果,批准或要求修改
第八步:设置例行任务
对于需要定期执行的任务,可以设置Routine:
- 点击左侧导航栏的”Routines”
- 点击”New Routine”按钮
- 填写信息:
- Name:例行任务名称
- Schedule:执行时间(cron表达式,比如”0 8 * * *”表示每天8点)
- Issue Template:任务模板
- 点击”Create”完成设置
进阶功能:多机协作
如果你有多台电脑(比如台式机和笔记本),可以通过VPN(如Netbird)让它们共享一个Paperclip实例:
服务器端配置
`bash
# 在主机器上初始化Paperclip
npx paperclipai onboard –yes –bind lan
# 启动服务
npx paperclipai run
`
客户端连接
`bash
# 在其他机器上连接到服务器
npx paperclipai agent local-cli –api-base http://:3100
`
这样,你可以在任何一台电脑上管理你的AI公司。
故障排除
Agent卡在错误状态
`bash
# 重置会话
npx paperclipai agent runtime-state:reset-session
# 恢复Agent
npx paperclipai agent resume
# 测试心跳
npx paperclipai agent heartbeat:invoke
`
Paperclip服务挂了
`bash
# 检查进程
ps aux | grep paperclip
# 重启
npx paperclipai run
`
端口被占用
`bash
# 查看占用端口的进程
lsof -i :3100
# 杀掉进程或修改配置文件中的端口
`
一个完整的例子:公众号自动化运营
让我们用一个具体场景来串联所有概念:
场景:你想让AI帮你运营一个公众号,每天发布3篇文章(早课、午课、晚课)。
1. 创建公司
初始化Paperclip,系统自动创建”Default Company”和CEO Agent。
2. 招聘团队
通过Web界面招聘:
- Content-Editor:内容编辑,负责撰写文章
- News-Researcher:新闻研究员,负责抓取热点
- Publisher:发布专员,负责发布到公众号和网站
3. 设置例行任务
通过Web界面创建Routine:
- 早课:每天8点,指派给Content-Editor
- 午课速报:每天12点,指派给News-Researcher
- 晚课:每天17点,指派给Content-Editor
4. 设置预算
每个Agent每月最多花50美元,避免成本失控。
5. 监控运行
打开Web界面,你可以看到:
- 每个Agent的工作状态
- 今天生成了哪些文章
- 花了多少token
- 有没有错误需要处理
Paperclip 不是什么
理解”它不是什么”和理解”它是什么”同样重要:
| 它不是 | 说明 |
|---|
|——–|——|
| 聊天机器人 | Agent有工作,没有聊天窗口 |
|---|---|
| Agent框架 | 它不教你如何构建Agent,它教你如何管理一群Agent |
| 工作流工具 | 没有拖拽式的流水线,它模拟的是公司组织 |
| 提示词管理器 | Agent自带提示词和模型,Paperclip管理的是组织 |
| 单Agent工具 | 如果你只有一个Agent,可能不需要Paperclip;如果有20个,那你一定需要 |
总结
Paperclip 是一个面向”AI公司”的管理系统。它的核心理念是:
管理业务目标,而不是管理代码。
如果你正在:
- 同时使用多个AI Agent
- 想要24/7自主运行的AI团队
- 需要追踪成本和预算
- 想要审计AI的每一个决策
- 希望从手机上管理你的AI公司
那么 Paperclip 值得一试。
开源、免费、自托管。不需要任何账号。
`bash
npx paperclipai onboard –yes
`
一行命令,开始你的AI公司之旅。
相关资源:
- 官方网站:https://paperclip.ing
- 文档:https://docs.paperclip.ing
- GitHub:https://github.com/paperclipai/paperclip
- Discord:https://discord.gg/m4HZY7xNG3
发表回复