【GitHub项目推荐--Paperclip:AI代理公司编排平台】⭐⭐⭐⭐⭐


简介
Paperclip 是一个革命性的Node.js服务器和React UI平台,专门用于编排AI代理团队来运营完整的业务公司。如果说OpenClaw是一个员工,那么Paperclip就是整个公司。这个平台允许用户自带AI代理、设定业务目标,并通过统一的仪表板跟踪代理的工作和成本。它看起来像一个任务管理器,但在底层实现了组织结构图、预算控制、治理机制、目标对齐和代理协调等完整的企业管理功能。
核心定位:Paperclip的核心价值在于管理业务目标而非代码提交。在当今AI代理爆炸式增长的时代,许多开发者同时运行数十个AI代理(如OpenClaw、Claude Code、Codex、Cursor等),却难以跟踪每个代理在做什么、成本如何控制、目标是否对齐。Paperclip解决了这一痛点,提供了一个集中化的平台来协调多个AI代理,让它们像真实公司员工一样协同工作,实现复杂的业务目标。
技术架构:Paperclip采用现代化的技术栈构建,包括Node.js后端、React前端、PostgreSQL数据库,支持Docker容器化部署。平台通过“心跳”机制管理代理的生命周期,支持任何能够接收心跳信号的AI代理。最新版本(2026年3月)增加了对GPT-5.4模型的支持、Cursor本地适配器、OpenClaw Docker UI烟雾测试等增强功能。
主要功能
1. 自带任意代理的灵活架构
Paperclip采用开放的架构设计,支持任何AI代理、任何运行时环境。只要代理能够接收心跳信号,就可以被“雇佣”到Paperclip平台中。这种设计让用户能够自由选择最适合的AI工具,无论是OpenClaw、Claude Code、Codex、Cursor还是自定义的Bash脚本或HTTP服务,都可以无缝集成到统一的组织结构中。
2. 目标对齐与任务追溯
平台确保每个任务都能追溯到公司的核心使命。代理不仅知道“做什么”,更理解“为什么做”。通过完整的任务上下文传递,AI代理能够基于业务目标做出更明智的决策,而不是孤立地执行指令。这种目标对齐机制显著提高了工作的连贯性和战略一致性。
3. 心跳驱动的自主运行
代理按照预定计划通过心跳机制唤醒,检查工作进展并采取行动。委托流程在组织结构图中上下流动,确保任务分配和执行的高效性。心跳机制支持定期工作(如客户支持、社交媒体发布、报告生成)的自动化执行,无需人工干预。
4. 精细化成本控制
Paperclip为每个代理设置月度预算限制,当达到预算上限时自动停止工作,防止成本失控。成本跟踪功能实时显示令牌使用情况,管理层可以基于预算优先级进行决策。这种机制特别重要,因为AI代理的失控循环可能在不经意间消耗数百美元的令牌配额。
5. 多公司管理与数据隔离
单一Paperclip部署可以运行无限数量的公司,每个公司都有完全的数据隔离。这种设计让用户能够从一个控制平面管理整个投资组合,同时确保不同业务之间的数据安全和隐私保护。真正的多公司隔离意味着每个实体都是公司作用域的,具有独立的审计跟踪。
6. 票据系统与完整审计
每个对话都被追踪,每个决策都有解释。平台提供完整的工具调用追踪和不可变的审计日志,确保所有活动都有记录可查。票据系统将工作组织成可管理的任务,支持线程化对话和跨重启的会话持久性。
7. 企业级治理机制
用户作为董事会,拥有完全的治理权限:批准雇佣决策、覆盖战略、随时暂停或终止任何代理。审批门控被强制执行,配置更改被版本化,不良更改可以安全回滚。这种治理结构确保了人类对AI运营的最终控制权。
8. 组织结构图与角色定义
平台提供完整的组织结构图功能,包括层级关系、角色定义和报告线。每个代理都有上司、职位和职位描述,模拟真实企业的管理结构。这种组织设计有助于理清责任边界和协作关系。
9. 移动端就绪
Paperclip设计为移动友好,允许用户从任何地方监控和管理自主业务。无论身在何处,都可以通过手机查看代理进展、批准决策或调整战略,实现了真正的随时随地管理。
10. 运行时技能注入
代理可以在运行时学习Paperclip工作流程和项目上下文,无需重新训练。这种动态技能注入能力让代理能够适应不断变化的业务需求,而无需频繁的模型更新或重新部署。
安装与配置
环境要求
Paperclip需要Node.js 20+和pnpm 9.15+作为基础运行环境。平台内置嵌入式PostgreSQL数据库,无需额外设置,简化了本地开发环境的搭建。对于生产部署,可以连接到自己的PostgreSQL实例以获得更好的性能和可靠性。
快速安装(一键式)
最简单的启动方式是使用npx命令:npx paperclipai onboard --yes。这个命令会自动处理所有依赖安装和初始配置,为用户提供最简化的入门体验。
手动安装步骤
对于希望更多控制权的用户,可以按照以下步骤手动安装:
- 克隆仓库:
git clone https://github.com/paperclipai/paperclip.git - 进入目录:
cd paperclip - 安装依赖:
pnpm install - 启动开发服务器:
pnpm dev
Docker快速启动
Paperclip提供完整的Docker支持,包括Dockerfile和docker-compose配置。使用Docker Compose可以快速启动所有服务:docker-compose -f docker-compose.quickstart.yml up。这种方式特别适合希望快速体验或部署到容器化环境的用户。
生产环境部署
对于生产环境,建议进行以下配置:
- 外部数据库:将内置的嵌入式PostgreSQL替换为专用的数据库实例
- 环境变量配置:通过
.env文件配置API密钥、数据库连接等敏感信息 - 反向代理:配置Nginx或类似的反向代理处理SSL和负载均衡
- 监控与日志:集成监控工具跟踪系统性能和错误
配置代理集成
Paperclip支持多种AI代理的集成配置:
- OpenClaw:通过Docker容器或本地安装集成
- Claude Code:配置API密钥和端点
- Codex:设置模型参数和访问权限
- Cursor:配置本地适配器或云服务
- 自定义代理:通过HTTP端点或Bash脚本集成
多公司配置
在单一部署中运行多个公司时,需要确保:
- 数据隔离:每个公司有独立的数据空间
- 资源配额:为不同公司分配计算资源和预算
- 访问控制:设置基于角色的权限管理
- 审计分离:保持每个公司的审计日志独立
如何使用
典型工作流程
Paperclip的使用遵循一个直观的三步流程,模拟真实公司的运营:
第一步:定义业务目标
在Paperclip中创建新公司时,首先需要定义清晰的业务目标。例如:“构建排名第一的AI笔记应用,达到100万美元月度经常性收入。”这个目标将成为所有代理工作的北极星指标,确保每个任务都与最终目标对齐。
第二步:组建AI团队
基于业务目标,雇佣合适的AI代理担任不同角色:CEO负责战略规划,CTO负责技术架构,工程师负责编码实现,设计师负责用户体验,营销人员负责用户获取。每个代理都有明确的职位描述和预算限制。Paperclip支持任何能够接收心跳的代理,用户可以根据需要混合搭配不同供应商的AI工具。
第三步:审批与监控
作为董事会,用户需要审查代理制定的战略、设定预算,然后启动运营。一旦公司开始运行,可以通过仪表板实时监控进展:查看任务完成情况、成本消耗、代理效率等关键指标。用户可以随时介入,批准重要决策、调整方向或暂停特定代理的工作。
任务管理与执行
Paperclip的票据系统将工作组织成可管理的任务:
- 任务创建:用户或管理代理创建新任务,指定目标、优先级和截止日期
- 任务分配:系统根据代理的技能和可用性自动分配任务,或由管理层手动分配
- 任务执行:代理领取任务后开始工作,定期通过心跳报告进展
- 任务审查:管理层审查完成的工作,提供反馈或批准交付
- 任务归档:完成的任务进入历史记录,供未来参考和审计
心跳调度与自动化
心跳是Paperclip的核心协调机制:
- 定时心跳:代理按照预定计划(如每小时、每天)自动唤醒并检查工作
- 事件触发:任务分配、@提及等事件可以立即触发代理响应
- 连续运行:对于需要持续关注的代理(如OpenClaw),可以配置为连续运行模式
- 状态恢复:代理在心跳间隔期间保持任务上下文,重启后可以从断点继续
成本监控与预算控制
Paperclip提供精细化的成本管理:
- 预算设置:为每个代理、每个项目或整个公司设置月度预算
- 实时跟踪:仪表板实时显示令牌消耗和成本预测
- 自动节流:当代理接近预算限制时,系统自动降低其工作频率或暂停任务
- 成本分析:提供详细的成本分解,帮助优化代理使用策略
治理与干预
用户作为董事会拥有完全的控制权:
- 审批流程:重要决策需要人工批准,防止AI做出不当选择
- 紧急停止:任何时候都可以暂停或终止任何代理的运行
- 战略覆盖:管理层可以直接修改代理的战略方向
- 版本回滚:配置更改被版本化,可以安全回滚到之前的状态
移动端管理
通过响应式设计的Web界面,用户可以在手机或平板电脑上:
- 查看公司整体状态和关键指标
- 审批待处理的任务和决策
- 与代理进行沟通和指导
- 调整预算和资源配置
- 接收重要通知和警报
应用场景实例
实例1:AI初创公司从零到一
场景描述:一位独立创业者希望创建一个AI驱动的笔记应用,但缺乏完整的团队来执行产品开发、设计、营销等多项任务。传统方式需要雇佣多人团队,成本高昂且管理复杂。
解决方案:创业者使用Paperclip创建“智能笔记公司”,设定目标为“构建排名第一的AI笔记应用,达到100万美元月度经常性收入”。他雇佣了多个AI代理:一个CEO代理负责整体战略,一个CTO代理负责技术架构,两个工程师代理(使用Claude Code)负责前端和后端开发,一个设计师代理负责UI/UX设计,一个营销代理负责用户获取。每个代理都有明确的职责和月度预算限制。
实施效果:CEO代理制定了详细的产品路线图和商业模式,CTO代理选择了合适的技术栈和架构,工程师代理开始编写代码,设计师代理创建了用户界面原型,营销代理制定了上市策略。创业者作为董事会,每周审查进展,批准关键决策。系统自动跟踪每个代理的成本,确保不超预算。三个月后,产品推出了MVP版本,获得了第一批用户。Paperclip的协调机制确保了所有代理朝着同一目标努力,避免了工作重复或方向偏离。
实例2:电商企业的自动化客户服务
场景描述:一家中型电商企业面临客户服务压力,每天需要处理数百个客户咨询,包括订单查询、退货处理、产品咨询等。人工客服团队成本高且难以扩展,特别是在高峰时段。
解决方案:企业在Paperclip中创建“客户服务部门”,雇佣多个专门的AI客服代理。每个代理负责特定类型的查询:订单状态代理处理物流查询,退货处理代理管理退货流程,产品咨询代理回答产品相关问题。设置心跳机制,让代理每15分钟检查一次新任务。配置预算控制,确保客服成本可预测。
实施效果:AI客服代理24/7处理客户咨询,响应时间从平均2小时缩短到5分钟。复杂问题自动升级到人工客服。系统自动学习历史对话,不断提高回答准确性。成本比全职人工客服团队降低70%,同时客户满意度从85%提升到92%。企业还可以根据销售数据预测客服需求,动态调整代理数量。
实例3:内容创作工作室的规模化生产
场景描述:一个内容创作工作室需要为多个客户持续产出高质量的内容,包括博客文章、社交媒体帖子、视频脚本等。传统方式依赖有限的创作人员,难以同时满足多个客户的需求,且质量不一致。
解决方案:工作室在Paperclip中创建“内容工厂”,雇佣不同类型的创作代理:研究代理负责主题调研,写作代理负责内容创作,编辑代理负责质量审核,发布代理负责多平台分发。为每个客户创建独立的“内容流水线”,配置不同的风格指南和质量标准。
实施效果:内容产出效率提升300%,从每月50篇增加到200篇。质量一致性显著提高,所有内容都符合客户的品牌声音和风格指南。成本可预测,按项目或按字数计费。工作室可以同时服务更多客户,营收增长150%。AI代理还帮助发现了新的内容趋势和话题,提升了内容的时效性和相关性。
实例4:软件外包公司的项目管理
场景描述:一家软件外包公司同时管理多个客户项目,每个项目都有不同的技术栈、时间线和交付要求。项目经理难以跟踪所有项目的进展,资源分配不均衡,有时出现项目延期或质量不达标。
解决方案:公司在Paperclip中为每个客户项目创建独立的“项目公司”。每个项目公司有自己的AI团队:项目经理代理负责进度跟踪,技术主管代理负责架构决策,开发代理负责编码,测试代理负责质量保证。母公司层面设置一个监督代理,监控所有项目的健康状况和资源使用。
实施效果:项目透明度大幅提升,客户可以实时查看进展。资源分配更加均衡,系统自动识别瓶颈并重新分配开发资源。交付质量提高,测试代理在开发过程中持续进行代码审查和测试。项目延期率从25%降低到5%,客户满意度从78%提升到95%。公司可以同时管理更多项目,营收增长80%。
实例5:个人投资者的研究自动化
场景描述:一位个人投资者需要跟踪数十家公司的财务表现、行业趋势和市场新闻,以做出投资决策。传统方式需要花费大量时间阅读报告、分析数据,且容易错过重要信息。
解决方案:投资者在Paperclip中创建“投资研究公司”,雇佣专门的研究代理:财务分析代理负责分析财报数据,行业研究代理负责跟踪行业动态,新闻监控代理负责扫描市场新闻,风险评估代理负责识别潜在风险。设置每日心跳,让代理每天早上提供最新研究报告。
实施效果:研究效率提升500%,投资者每天只需花30分钟审查AI生成的研究报告,而不是之前的3小时手动研究。投资决策更加数据驱动,AI代理发现了多个被忽视的投资机会和风险。投资组合回报率从年化12%提升到18%。系统还可以根据投资者的风险偏好自动调整研究重点,提供个性化的投资建议。
GitHub地址
官方仓库地址:https://github.com/paperclipai/paperclip
项目状态:活跃开发中 - 最新提交于2026年3月6日,持续增加新功能
关键信息:
- 项目名称:Paperclip - AI代理公司编排平台
- 核心定位:将AI代理组织成公司结构,实现目标对齐、成本控制和治理
- 最新版本:持续活跃开发,最新功能包括GPT-5.4支持、Cursor本地适配器、OpenClaw Docker集成
- 技术栈:Node.js后端、React前端、PostgreSQL数据库、TypeScript开发
- 开源协议:MIT许可证,允许商业使用和修改
- 社区状态:活跃的开发和问题讨论,接受贡献
仓库结构:
- 核心组件:
server/目录包含API服务器,ui/目录包含React前端 - CLI工具:
cli/目录提供命令行界面 - 适配器:
packages/目录包含各种AI代理的适配器实现 - 技能库:
skills/目录包含代理可以学习的Paperclip工作流程 - 文档:
docs/目录包含详细的使用指南和API文档 - Docker配置:完整的容器化部署方案
快速开始资源:
- 一键启动:
npx paperclipai onboard --yes - 手动安装:克隆仓库后运行
pnpm install && pnpm dev - Docker启动:使用提供的docker-compose文件快速部署
- 开发指南:详细的开发环境设置和贡献指南
路线图与未来计划:
项目有明确的未来发展计划:
- OpenClaw集成优化:简化OpenClaw的入门和配置流程
- 云代理支持:完善Cursor、e2b等云代理的集成
- ClipMart市场:购买和销售完整的AI代理公司模板
- 配置简化:提供更易理解的代理配置界面
- 工具链支持:改进工具链工程体验
- 插件系统:支持知识库、自定义追踪、队列等扩展
- 文档完善:提供更全面的使用文档和教程
开发与贡献:
项目欢迎社区贡献:
- 开发命令:
pnpm dev启动完整开发环境,pnpm test:run运行测试 - 数据库管理:
pnpm db:generate生成迁移,pnpm db:migrate应用迁移 - 类型检查:
pnpm typecheck确保类型安全 - 构建命令:
pnpm build构建所有组件 - 贡献指南:遵循标准的GitHub工作流,提交清晰的拉取请求
社区与支持:
- 问题反馈:通过GitHub Issues报告问题或提出功能建议
- 讨论交流:社区围绕AI代理编排的最佳实践进行活跃讨论
- 商业应用:项目完全开源,支持商业用途,无需许可费用
- 持续更新:团队定期发布新功能和改进,保持项目与时俱进
愿景与使命:Paperclip代表了AI代理协作的未来方向——将分散的AI能力组织成有结构、有目标、可管理的业务实体。随着AI代理能力的不断增强,如何有效协调多个代理、控制成本、确保目标对齐将成为关键挑战。Paperclip提供了一个框架来解决这些挑战,让个人和小团队也能运营复杂的AI驱动业务。通过开源协作和社区反馈,Paperclip将继续进化,降低AI公司运营的门槛,让更多人能够利用AI创造价值。