Paperclip — 多 Agent 编排管理平台详细介绍

一、产品概述

Paperclip 是开源的多 Agent 组织化管理平台，官方 slogan 为 「open-source orchestrator for zero-human companies」。它管的是组织和治理，已经不是"写代码工具"了。

它可以独立部署成完整 Web 应用，包含前端管理界面、后端服务和数据库存储。部署之后，可以通过 UI 创建 Agent 团队、配置任务、管预算、看审计日志。

工程化理解：单个 Agent 像员工，Paperclip 像公司的管理体系——负责组织架构、任务分派、进度追踪、成本管控和合规审计。

产品形态速览

维度	说明
产品形态	可自部署的多 Agent 管理平台（Web 应用）
所属层级	多 Agent 编排与治理层（工具链第 3 层，最顶层）
核心角色	统一调度、管控多 Agent 与多项目
是否可独立运行	是，需部署后通过 UI/API 使用
是否具备编码能力	无，完全依赖底层执行 Agent
底层兼容性	不绑定执行端，Claude Code、Hermes、SpecKit+Superpowers 等均可接入
通俗类比	公司管理体系——管团队、管预算、管进度、管审计

Paperclip 的角色定位

                    ┌──────────────┐
                    │  Paperclip   │  ← 管理层：调度、预算、权限、审计
                    │ （控制平面）  │
                    └──────┬───────┘
                           │ 调度和管理
          ┌────────────────┼────────────────┐
          ↓                ↓                ↓
   ┌──────────┐    ┌──────────┐    ┌──────────────┐
   │ Hermes   │    │ SpecKit  │    │ Claude Code  │  ← 执行层
   │ + CC     │    │ + Super  │    │ （直接开发）  │
   └──────────┘    └──────────┘    └──────────────┘

Paperclip 是管理者，不写代码；下层是执行干活单元，平台只做调度与治理。

---

二、部署与配置

2.1 环境要求

• Docker 和 Docker Compose
• 服务器资源（CPU、内存、磁盘）用于运行 Web 服务和数据库
• 网络访问（用于对接大模型 API 和执行节点）

2.2 部署步骤

# 第一步：拉取 Paperclip 平台代码
git clone https://github.com/paperclip-org/paperclip-platform
cd paperclip-platform

# 第二步：通过 Docker Compose 一键部署
docker-compose up -d

# 部署内容包括：
# - Paperclip Web 前端管理界面
# - 后端 API 服务
# - 数据库（存储 Agent 配置、任务、日志）

# 第三步：访问后台管理界面
# 浏览器打开：http://localhost:8080

2.3 平台初始化配置

部署后需要在后台 UI 中完成以下配置：

1. 创建组织架构（Agent 团队）

CEO Agent（架构统筹）
 ├── 需求校验 Agent → 绑定 SpecKit
 ├── 开发执行 Agent → 绑定 Hermes + Claude Code + Superpowers
 ├── 测试 Agent     → 绑定测试框架
 └── 审计复盘 Agent → 全链路审计留痕

2. 设置全局治理策略

# 预算管控
global_token_budget: 5000000  # 全局 Token 上限
per_project_budget: 1000000   # 单项目上限
per_agent_budget: 200000      # 单 Agent 上限
over_budget_action: suspend   # 超预算自动暂停

# 权限隔离
agent_permissions:
  architect:    [read_all, create_tasks]
  developer:    [read_code, write_code, run_tests]
  reviewer:     [read_all, approve]
  auditor:      [read_logs, export_reports]

# 审计配置
audit_log: enabled
log_level: full     # 记录所有操作
retention: 90_days   # 日志保留 90 天

---

三、核心能力详解

3.1 组织架构化编排

支持搭建层级化的 Agent 团队，模拟真实企业的组织管理模式：

角色层级	职责	示例
决策层 Agent	整体方案拆解、技术决策	CEO Agent / 架构 Agent
中层 Agent	需求分析、规格管理	需求 Agent（绑定 SpecKit）
执行层 Agent	编码落地、测试执行	开发 Agent（绑定 Hermes + CC + Superpowers）
监督层 Agent	审计复盘、质量把关	审计 Agent

与传统"一个 Agent 干所有事"的区别：

• 权责清晰，任务逐级拆解分派
• 角色隔离，不同 Agent 不同权限
• 并行执行，多个执行 Agent 可同时推进不同子任务

3.2 心跳式任务调度

所有 Agent 基于心跳协议运行，实现 7×24 小时无人值守运营：

触发模式	说明	适用场景
定时触发	按 Cron 表达式定时唤醒 Agent	定期巡检、日报生成
Webhook 触发	外部事件触发（如 Git Push、Issue 创建）	CI/CD 集成
API 触发	通过 REST API 手动/程序化下发任务	灵活调度
心跳唤醒	Agent 定时唤醒，检查是否有待处理任务	持续运营

执行流程：定时唤醒 → 检查任务队列 → 自主推进任务 → 同步进度 → 等待下次心跳。

3.3 全维度治理能力（平台核心价值）

治理维度	能力	解决的问题
预算管控	分级设置 Token 预算（团队/项目/Agent），超支自动停止	成本跑飞，月底收到天价账单
权限隔离	不同角色 Agent 配置不同的系统、文件权限	Agent 误删文件、越权操作
审计回放	全链路任务执行留痕，支持日志回放、问题追溯	出了问题找不到责任环节
异常重试	任务失败自动重试、自动升级（escalation）	半夜任务挂了没人知道

3.4 底层执行工具全兼容

Paperclip 不绑定任何执行端，可以按项目类型灵活搭配：

项目 A（内部工具）  → Hermes + Claude Code 轻量流
项目 B（核心系统）  → SpecKit + Superpowers + Claude Code 规范流
项目 C（数据处理）  → 自定义 Agent + Python 执行器
        ↓
    Paperclip 统一管控

一套平台管理所有类型的项目，上层统一治理，下层按需选择执行流。

---

四、实操 Demo

场景：「用户模块整体重构迭代」——跨角色完整需求调度

第一步：在 Paperclip 后台创建项目任务

项目名称：用户模块整体重构迭代
任务类型：跨角色协作
预算上限：1,000,000 Token

第二步：Paperclip 自动调度执行链路

┌────────────────────────────────────────────────────┐
│ 阶段 1：架构统筹                                   │
│ Paperclip 调度「架构 Agent」                        │
│ → 分析现有用户模块结构                              │
│ → 拆解整体重构方案为子任务                          │
│ → 输出：接口重构、数据迁移、测试覆盖 三个子任务      │
├────────────────────────────────────────────────────┤
│ 阶段 2：需求校验                                   │
│ Paperclip 分发子任务给「需求 Agent」（绑定 SpecKit） │
│ → 为每个子任务生成 Spec 文档                        │
│ → 自动校验 Spec 完整性                             │
│ → Spec 确认后，自动流转到开发阶段                   │
├────────────────────────────────────────────────────┤
│ 阶段 3：编码执行                                   │
│ Paperclip 分发开发任务给「执行 Agent」              │
│ （绑定 Hermes + Claude Code + Superpowers）        │
│ → Superpowers 自动触发 TDD 流程                    │
│ → Claude Code 严格按 Spec 编写代码                 │
│ → 自测通过后自动提交                               │
├────────────────────────────────────────────────────┤
│ 阶段 4：审计复盘                                   │
│ Paperclip 调度「审计 Agent」                        │
│ → 全链路复盘：Spec → 代码 → 测试 → 提交             │
│ → 生成审计报告，记录所有操作日志                    │
├────────────────────────────────────────────────────┤
│ 平台实时监控                                       │
│ → 每个 Agent 的 Token 消耗实时可见                  │
│ → 任务进度可视化                                   │
│ → 操作日志全程留痕                                 │
│ → 任一 Agent 超预算自动暂停任务                     │
└────────────────────────────────────────────────────┘

---

五、适用场景

✅ 最适合的场景

场景	原因
多团队多项目并行	人工盯不过来，需要统一调度和监控
Agent 规模化落地	从几个 Agent 到几十个，需要组织化管理
平台级 Agent 运营	需要仪表盘、预算管控、审计追溯
多角色 Agent 协作	架构/开发/测试/审计 Agent 分权分责
7×24 无人值守	心跳调度 + 异常重试 + 自动升级

⚠️ 不适合的场景

场景	原因
单人单项目	平台维护成本 > 治理收益
小团队临时需求	搭平台的时间比写业务还长
2-3 个项目	人肉同步进度和统计成本即可
没有预算/审计需求	平台的核心价值得不到发挥

判断是否上 Paperclip：三个信号

满足两个以上再考虑：

信号	具体表现
项目数量 > 5	人工同步进度和统计成本已明显上升
Agent 角色 > 3	需要分权限、分职责协作
有明确治理需求	预算管控、权限隔离、审计追溯是刚需

反例警示： 有团队两个人两个项目也要搭 Paperclip，结果每周花时间清日志、调权限、看任务状态，真正写业务的时间被挤掉。后来下掉平台，改成 Claude Code + Hermes + Superpowers，交付节奏反而快了。

---

六、与其他工具的关系

6.1 Paperclip vs 下层工具

工具	层级	与 Paperclip 的关系
Claude Code	执行层	Paperclip 调度它写代码
Hermes	运行时层	Paperclip 管 Hermes 的调度和预算
SpecKit	规范层	Paperclip 管 SpecKit 的任务分发
Superpowers	纪律层	Paperclip 管 Superpowers 的启用策略

Paperclip 是管理者，不写代码；下层所有工具都是被管理的执行单元。

6.2 Paperclip vs Hermes

维度	Hermes	Paperclip
层级	执行层的个人运行时	治理层的管控平台
管理对象	单个 Agent 的记忆和自动化	多个 Agent 和多个项目
记忆	✅ 三层记忆体系	❌
预算管控	❌	✅
权限隔离	❌	✅
审计回放	❌	✅
编码能力	❌（依赖 Claude Code）	❌（依赖下层）

Paperclip 不能替代 Hermes，Hermes 也不能替代 Paperclip。 常见做法是 Paperclip 在上层管控，下层接 Hermes 或 Claude Code 执行节点。

6.3 Paperclip vs LangGraph

维度	LangGraph	Paperclip
产品形态	代码级开发框架	产品化管理平台
面向用户	开发者	团队管理者
核心能力	图编排、状态机、工作流	组织、调度、预算、权限、审计
灵活度	高，可深度定制	相对有限，开箱即用
治理能力	需自己搭建（界面、权限、审计）	开箱自带
部署方式	作为代码库集成	完整 Web 应用独立部署

二者不是替代关系，关注点不同：

• LangGraph 偏"怎么编排"——给开发者最大的灵活度
• Paperclip 偏"怎么治理"——给团队管理者开箱即用的控制台

很多团队两者一起用：底层用 LangGraph 保证灵活度，上层用 Paperclip 统一治理。

---

七、优势与局限总结

优势

优势	说明
组织化管理	层级化 Agent 团队，模拟真实企业分工
全维度治理	预算 + 权限 + 审计 + 重试，一台管理所有
不绑定执行端	下层工具按需选择，灵活搭配
可视化管控	Web 仪表盘，进度和成本一目了然
7×24 运营	心跳调度 + 异常自动处理，无人值守

局限

局限	说明
无编码能力	本身不写代码，完全依赖底层执行 Agent
部署运维重	需服务器、数据库，配置和维护成本不小
学习成本	组织架构、权限、预算策略需要设计
小团队降效	项目少、Agent 少时，平台是负担不是助力

一句话总结

Paperclip 是顶层治理控制平面，负责多 Agent 组织编排、任务调度、预算管控、权限和审计。本身无编码能力，必须接入下层执行链路。只有在项目和 Agent 数量起来后才有意义——治理收益必须大于平台成本。