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

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

一、产品概述

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

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

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

产品形态速览

Paperclip 的角色定位

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

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

二、部署与配置

2.1 环境要求

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

2.2 部署步骤

# 第一步：拉取 Paperclip 平台代码gitclone https://github.com/paperclip-org/paperclip-platformcdpaperclip-platform# 第二步：通过 Docker Compose 一键部署docker-composeup-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:enabledlog_level:full# 记录所有操作retention:90_days# 日志保留 90 天

三、核心能力详解

3.1 组织架构化编排

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

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

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

3.2 心跳式任务调度

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

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

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

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 超预算自动暂停任务 │ └────────────────────────────────────────────────────┘

五、适用场景

✅ 最适合的场景

⚠️ 不适合的场景

判断是否上 Paperclip：三个信号

满足两个以上再考虑：

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

六、与其他工具的关系

6.1 Paperclip vs 下层工具

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

6.2 Paperclip vs Hermes

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

6.3 Paperclip vs LangGraph

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

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

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

七、优势与局限总结

优势

局限

一句话总结

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