!Paperclip AI Agent Orchestration
你有没有遇到过这样的场景：
打开电脑，发现桌面上有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 触发。
界面功能介绍
Paperclip 有一个 Web UI（默认 http://localhost:3100），看起来就像一个项目管理工具。
Dashboard（仪表盘）
打开首页，你会看到：
- 公司概览：当前运行的公司、Agent数量、活跃任务数
- Agent状态：每个Agent的工作状态（工作中/空闲/错误/暂停）
- 成本统计：本月已花费的token和金额
- 活动日志：最近的操作记录
Agent管理页面
在这里你可以：
- 查看所有Agent的列表
- 创建新Agent
- 修改Agent配置（模型、预算、心跳频率）
- 暂停/恢复/终止Agent
- 查看Agent的工作历史
Issue管理页面
类似GitHub Issues或Jira：
- 创建新任务
- 分配给Agent
- 设置优先级和依赖
- 跟踪任务状态
- 查看Agent的执行日志
Org Chart页面
可视化展示公司的组织架构：
- 拖拽调整汇报关系
- 查看每个节点的Agent详情
- 设置委派路径（delegation paths）
Activity Log（活动日志）
完整的审计追踪：
- 谁在什么时间做了什么
- 每个决策的依据
- 成本变化记录
- 审批历史
如何将现有的AI Agent加入系统
这是最关键的部分。假设你已经有了一些AI Agent（比如Claude Code、Hermes），现在要把它们接入Paperclip。
第一步：安装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界面。
第二步：查看已有的Agent
`bash
# 获取公司ID
npx paperclipai company list
# 查看当前Agent列表
npx paperclipai agent list -C
`
初始化时系统会自动创建一个CEO Agent。
第三步：创建新Agent
`bash
# 创建一个工程师Agent
npx paperclipai agent create -C –payload-json ‘{
“name”: “Engineer-Hermes”,
“role”: “engineer”,
“adapter”: “hermes_local”
}’
# 创建一个内容编辑Agent
npx paperclipai agent create -C –payload-json ‘{
“name”: “Content-Writer”,
“role”: “content_writer”,
“adapter”: “hermes_local”
}’
`
第四步：配置Agent的模型
`bash
# 设置Agent使用的模型
npx paperclipai agent update –payload-json ‘{
“adapterConfig”: {
“model”: “xiaomi/mimo-v2.5-pro”,
“provider”: “xiaomi”,
“timeoutSec”: 300,
“persistSession”: true
}
}’
`
第五步：设置心跳（Heartbeat）
`bash
# 启用心跳，每5分钟检查一次
npx paperclipai agent update –payload-json ‘{
“runtimeConfig”: {
“heartbeat”: {
“enabled”: true,
“intervalSec”: 300,
“cooldownSec”: 10,
“maxConcurrentRuns”: 5
}
}
}’
`
第六步：设置预算
`bash
# 设置月度预算（单位：分，10000分=100美元）
npx paperclipai agent update –payload-json ‘{
“budgetMonthlyCents”: 10000
}’
`
第七步：连接本地Agent
如果你在其他机器上也有Agent，可以用 local-cli 命令连接：
`bash
npx paperclipai agent local-cli –api-base http://:3100
`
这会在本地启动一个Agent进程，通过API连接到Paperclip服务器。
如何创建任务
任务创建是Paperclip最常用的操作。
方法一：通过CLI创建
`bash
npx paperclipai issue create -C –payload-json ‘{
“title”: “撰写Day32早课：多模态AI入门”,
“description”: “撰写一篇面向零基础学习者的多模态AI教程，包含原理介绍、工具推荐和实操练习。”,
“priority”: “high”,
“assigneeAgentId”: “”
}’
`
方法二：通过Web界面创建
- 打开 http://localhost:3100
- 进入”Issues”页面
- 点击”New Issue”
- 填写标题、描述、优先级
- 选择指派的Agent
- 点击创建
方法三：通过Routine自动创建
`bash
# 创建一个每天早上8点执行的例行任务
npx paperclipai routine create -C –payload-json ‘{
“name”: “早课生成”,
“schedule”: “0 8 * * *”,
“issueTemplate”: {
“title”: “生成今日早课”,
“assigneeAgentId”: “”
}
}’
`
后续使用流程
日常运维
- 查看Agent状态：
`bash
npx paperclipai agent get | grep status
`
- 手动触发心跳（测试用）：
`bash
npx paperclipai agent heartbeat:invoke
`
- 查看活动日志：
`bash
npx paperclipai activity list –limit 20
`
- 暂停/恢复Agent：
`bash
npx paperclipai agent pause
npx paperclipai agent resume
`
故障排除
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
`
多机协作
如果你有多台电脑（比如台式机和笔记本），可以通过VPN（如Netbird）让它们共享一个Paperclip实例：
- 在一台机器上安装Paperclip（服务器）
- 配置为局域网访问模式
- 其他机器通过
local-cli连接
`bash
# 服务器端配置
npx paperclipai onboard –yes –bind lan
# 客户端连接
npx paperclipai agent local-cli –api-base http://:3100
`
一个完整的例子
让我们用一个具体场景来串联所有概念：
场景：你想让AI帮你运营一个公众号，每天发布3篇文章（早课、午课、晚课）。
1. 创建公司
`bash
npx paperclipai onboard –yes
# 系统自动创建”Default Company”和CEO Agent
`
2. 招聘团队
`bash
# 内容编辑
npx paperclipai agent create -C –payload-json ‘{
“name”: “Content-Editor”,
“role”: “editor”,
“adapter”: “hermes_local”
}’
# 新闻研究员
npx paperclipai agent create -C –payload-json ‘{
“name”: “News-Researcher”,
“role”: “researcher”,
“adapter”: “hermes_local”
}’
# 发布专员
npx paperclipai agent create -C –payload-json ‘{
“name”: “Publisher”,
“role”: “publisher”,
“adapter”: “hermes_local”
}’
`
3. 设置例行任务
`bash
# 早课：每天8点
npx paperclipai routine create -C –payload-json ‘{
“name”: “早课生成”,
“schedule”: “0 8 * * *”,
“issueTemplate”: {
“title”: “生成今日早课”,
“assigneeAgentId”: “”
}
}’
# 午课速报：每天12点
npx paperclipai routine create -C –payload-json ‘{
“name”: “午课速报”,
“schedule”: “0 12 * * *”,
“issueTemplate”: {
“title”: “生成今日午课速报”,
“assigneeAgentId”: “”
}
}’
# 晚课：每天17点
npx paperclipai routine create -C –payload-json ‘{
“name”: “晚课生成”,
“schedule”: “0 17 * * *”,
“issueTemplate”: {
“title”: “生成今晚晚课”,
“assigneeAgentId”: “”
}
}’
`
4. 设置预算
`bash
# 每个Agent每月最多花50美元
npx paperclipai agent update –payload-json ‘{
“budgetMonthlyCents”: 5000
}’
`
5. 监控运行
打开 http://localhost:3100，你可以看到：
- 每个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
发表回复