Paperclip:让AI打工人自己开公司

作者:

!Paperclip 官方网站

你有没有遇到过这样的场景:

打开电脑,发现桌面上有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 Code
  • codex — 连接OpenAI Codex
  • hermes_local — 连接本地Hermes
  • http — 连接任何HTTP服务

就像不同品牌的打印机需要不同的驱动程序一样,不同AI需要不同的Adapter。

11. Routine(例行任务)

类比:定期汇报/周报

Routine 是定期自动执行的任务。比如:

  • 每天早上8点:生成公众号早课
  • 每天中午12点:抓取AI新闻生成午课速报
  • 每周一:生成周报

Routine 可以用 cron 表达式、webhook 或 API 触发。


界面功能介绍:Web UI 详解

Paperclip 有一个漂亮的 Web UI(默认 http://localhost:3100),看起来就像一个现代化的项目管理工具。下面我带你逐个界面看看。

登录页面

!Paperclip 登录页面

打开浏览器访问 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界面。

第二步:创建账号并登录

  1. 打开浏览器访问 http://localhost:3100
  2. 点击”Create one”创建账号
  3. 输入邮箱和密码
  4. 点击”Sign In”登录

第三步:创建公司

登录后,系统会自动创建一家默认公司。你可以在设置中修改公司名称和描述。

第四步:招聘Agent(通过Web界面)

  1. 点击左侧导航栏的”Agents”
  2. 点击”New Agent”按钮
  3. 填写Agent信息:
  • Name:给Agent起个名字,比如”Engineer-Hermes”
  • Role:选择角色,比如”engineer”
  • Adapter:选择适配器,比如”hermes_local”
  1. 点击”Create”完成招聘

重复以上步骤,招聘更多Agent:

  • CTO(技术总监)
  • Engineer-1(前端工程师)
  • Engineer-2(后端工程师)
  • Content-Writer(内容编辑)

第五步:配置Agent

点击某个Agent进入详情页,可以配置:

模型设置

  • 选择Agent使用的AI模型(比如Claude、GPT、Hermes)
  • 设置超时时间
  • 启用会话持久化

心跳设置

  • 启用心跳(Heartbeat)
  • 设置心跳间隔(比如每5分钟)
  • 设置冷却时间(避免频繁触发)

预算设置

  • 设置月度预算上限(比如100美元)
  • 设置警告阈值(比如80%时提醒)

第六步:创建任务(通过Web界面)

  1. 点击左侧导航栏的”Issues”
  2. 点击”New Issue”按钮
  3. 填写任务信息:
  • Title:任务标题,比如”撰写Day32早课:多模态AI入门”
  • Description:任务描述,详细说明要求
  • Priority:选择优先级(Low/Medium/High/Urgent)
  • Assignee:选择指派的Agent
  1. 点击”Create”完成任务创建

第七步:监控任务执行

任务创建后,你可以:

  1. 查看任务状态:在Issue列表中看到任务的状态变化
  2. 查看执行日志:点击任务详情,可以看到Agent的思考过程和工具调用记录
  3. 审核完成结果:当Agent完成任务后,你可以审核结果,批准或要求修改

第八步:设置例行任务

对于需要定期执行的任务,可以设置Routine:

  1. 点击左侧导航栏的”Routines”
  2. 点击”New Routine”按钮
  3. 填写信息:
  • Name:例行任务名称
  • Schedule:执行时间(cron表达式,比如”0 8 * * *”表示每天8点)
  • Issue Template:任务模板
  1. 点击”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

评论

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注