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、SpecKitSuperpowers 等均可接入通俗类比公司管理体系——管团队、管预算、管进度、管审计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:80802.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整体方案拆解、技术决策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维度HermesPaperclip层级执行层的个人运行时治理层的管控平台管理对象单个 Agent 的记忆和自动化多个 Agent 和多个项目记忆✅ 三层记忆体系❌预算管控❌✅权限隔离❌✅审计回放❌✅编码能力❌依赖 Claude Code❌依赖下层Paperclip 不能替代 HermesHermes 也不能替代 Paperclip。常见做法是 Paperclip 在上层管控下层接 Hermes 或 Claude Code 执行节点。6.3 Paperclip vs LangGraph维度LangGraphPaperclip产品形态代码级开发框架产品化管理平台面向用户开发者团队管理者核心能力图编排、状态机、工作流组织、调度、预算、权限、审计灵活度高可深度定制相对有限开箱即用治理能力需自己搭建界面、权限、审计开箱自带部署方式作为代码库集成完整 Web 应用独立部署二者不是替代关系关注点不同LangGraph 偏怎么编排——给开发者最大的灵活度Paperclip 偏怎么治理——给团队管理者开箱即用的控制台很多团队两者一起用底层用 LangGraph 保证灵活度上层用 Paperclip 统一治理。七、优势与局限总结优势优势说明组织化管理层级化 Agent 团队模拟真实企业分工全维度治理预算 权限 审计 重试一台管理所有不绑定执行端下层工具按需选择灵活搭配可视化管控Web 仪表盘进度和成本一目了然7×24 运营心跳调度 异常自动处理无人值守局限局限说明无编码能力本身不写代码完全依赖底层执行 Agent部署运维重需服务器、数据库配置和维护成本不小学习成本组织架构、权限、预算策略需要设计小团队降效项目少、Agent 少时平台是负担不是助力一句话总结Paperclip 是顶层治理控制平面负责多 Agent 组织编排、任务调度、预算管控、权限和审计。本身无编码能力必须接入下层执行链路。只有在项目和 Agent 数量起来后才有意义——治理收益必须大于平台成本。
