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”创建账号。

官方文档首页

!Paperclip 官方文档

Paperclip 的官方文档非常完善，包含 Quickstart、Working Day-to-day、Your Org & Agents、Projects & Workflow 等多个章节。文档地址：https://docs.paperclip.ing

Org Chart（组织架构图）

!Paperclip Org Chart 界面

Org Chart 是 Paperclip 最直观的功能之一。从截图可以看到：

• 层级化架构：顶层是CEO、CMO、CTO等管理层，下层是Frontend Eng、Backend Eng等执行层
• 预算监控：每个Agent旁边都显示预算使用情况，比如”$5 / $15″表示已用5美元，总预算15美元
• 成本追踪：实时显示每个Agent的花费

这个界面让你一眼就能看清”谁向谁汇报”、”谁花了多少钱”。

Goal Alignment（目标对齐）

从截图可以看到，Paperclip 的目标对齐系统是层层递进的：

`

MISSION（使命）

→ PROJECT GOAL（项目目标）

→ AGENT GOAL（Agent目标）

→ TASK（具体任务）

`

比如：

• 使命：做出月入百万的AI笔记应用
• 项目目标：上线协作功能
• Agent目标：实现实时同步
• 具体任务：编写WebSocket处理器

每个任务都能追溯到公司使命，Agent在执行时知道”为什么要做这件事”。

Heartbeats（心跳调度）

心跳调度是 Paperclip 的核心机制：

• 定时唤醒：Agent按计划自动醒来，检查工作
• 自动流转：任务在组织架构里自动传递
• 工单触发：分配工单时自动唤醒对应Agent
• 跨团队协作：请求会被分配给最合适的Agent

Cost Control（成本控制）

!Paperclip Cost Control 界面

从截图可以看到成本控制界面：

• 表格视图：显示每个Agent的预算使用情况
• 进度条：直观展示预算消耗比例
• 金额追踪：比如CEO用了$0/$40，CMO用了$8/$10
• 总计汇总：底部显示总预算使用情况

每个Agent都有硬性月度预算限制，一旦达到上限，系统会自动停止该Agent，防止成本失控。

Ticket System（工单系统）

工单系统记录了所有与Agent的交互：

• 完整追溯：每条指令、每个响应、每次工具调用都被记录
• 审计日志：所有操作都有完整的历史记录
• 透明执行：没有”暗箱操作”，所有决策都有据可查

Governance（治理/审批）

治理功能让你成为AI团队的”董事会”：

• 招聘审批：新Agent入职需要你批准
• 策略签署：Agent的执行策略需要你签字
• 随时干预：你可以暂停任何Agent、重新分配任务、调整预算
• 最终决策权：你授予Agent自主权，但始终保持最终控制权

---

实战教程：用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