1. 项目定位与用途
Paperclip 是开源编排系统，专为零人工干预的 AI 公司设计。它充当企业操作系统，整合各类 AI 代理（员工）形成团队，通过统一仪表板管理目标、预算与工作流。定位为‘如果 OpenClaw 是员工，Paperclip 就是公司’，旨在让自主企业运营像使用任务管理器一样直观。核心用途包括定义业务目标、雇佣并配置代理、批准策略与预算、实时监控活动与成本，并支持从手机进行管理。
项目档案应用项目
Paperclip 开源平台：零人工 AI 公司编排系统 | 多代理协调、成本控制与实时监控
Paperclip 是构建自主 AI 企业的开源编排平台，集成 Node.js 后端与 React 前端，支持 OpenClaw、Claude、Codex 等多代理协调，提供目标管理、预算控制与心跳机制。本文详解其功能、安装步骤与使用方式。
AI 总结
Paperclip 是开源零人工 AI 公司编排平台，通过 Node.js 后端与 React 前端统一协调多 AI 代理团队，实现目标管理、成本控制与自主运营。
中文项目介绍
Paperclip 是一个用于构建和运营零人工干预 AI 公司的开源平台。它提供 Node.js 服务器和 React 用户界面，能够编排多个 AI 代理（如 OpenClaw、Claude、Codex、Cursor）共同完成复杂业务目标。用户可定义公司使命、雇佣代理团队、设置预算与心跳 schedule，并通过统一仪表板监控工作进度与成本，实现类似任务管理器的代理协调体验。
该项目解决多代理协同混乱、成本超支及缺乏审计的问题，使自主企业能 24/7 运行同时保留人工干预能力。适用场景包括构建自主 AI 公司、协调异构代理、监控多终端工作、控制 AI 支出以及移动端管理。
技术层面，Paperclip 采用 monorepo 架构（pnpm workspaces），全栈 TypeScript 开发，包含 server、ui、db、adapters、shared、mcp-server 和 cli 等核心模块。数据库使用 PostgreSQL（从 .env.example 可见），支持插件化代理适配器，并提供完整的开发、测试、数据库迁移与发布流程。
详细信息与使用说明
2. 解决的核心问题
Paperclip 解决多 AI 代理协同的三大痛点：一是协调混乱，当同时运行多个代理（如 20 个 Claude Code 终端）时难以跟踪状态与责任，它通过组织架构与任务分解实现清晰 delegation；二是成本失控，缺乏预算机制导致 AI 服务费用不可预测，它提供每月 per-agent 预算，超限自动停止；三是审计与干预困难，代理自主运行时难以审计或介入，它通过心跳机制、工作记录与仪表板实现透明监控与随时干预。此外，它统一了异构代理（不同提供商、运行时）的接入与管理。
3. 典型适用场景
Paperclip 适用于：1）构建完全自主的 AI 公司，从设定 MRR 目标到执行营销与开发全流程自动化；2）协调多种 AI 代理（OpenClaw、Codex、Claude、Cursor 等）向共同目标工作，尤其适合代理数量多、来源杂的团队；3）需要 24/7 自主运行但保留人工审计与干预能力的业务，如自动化客户支持或内容生成；4）严格监控 AI 使用成本的场景，预算控制功能防止意外支出；5）偏好任务管理器式界面、希望从移动端管理代理的用户；6）希望导入预建公司模板（Clipmart，即将推出）快速启动的场景。
4. 安装与配置步骤
基于仓库提供的脚本与环境模板，安装步骤如下：首先确保环境满足 Node.js >=20 和 pnpm 包管理器（版本 9.15.4，见 package.json engines 与 packageManager 字段）；其次运行 pnpm install 安装 monorepo 依赖；然后复制 .env.example 为 .env 并配置必要变量，如数据库连接（默认 PostgreSQL）、服务端口、UI 开关及认证密钥；最后执行 pnpm dev 启动开发服务器（该命令过滤 @paperclipai/server 包运行开发脚本）。生产部署需运行数据库迁移（pnpm --filter @paperclipai/db migrate）并构建（pnpm -r build）。注意：具体部署细节未在 README 中详述，建议参考官方文档。
5. 基本使用流程
使用 Paperclip 的核心流程为：1）在 React UI 仪表板定义公司目标（如‘打造年收入 1M 的 AI 笔记应用’）；2）雇佣团队，添加 CEO、CTO、工程师、设计师、营销人员等代理角色，支持任何能接收心跳的代理（通过适配器集成）；3）批准策略与预算，审查代理提出的计划，设置每月预算上限；4）启动运行，代理按心跳 schedule 唤醒、检查工作、执行任务， delegation 沿组织架构上下流动；5）从仪表板或手机实时监控任务进度、成本消耗与代理状态，必要时介入调整。公司模板（Clipmart）将支持一键导入完整配置。
6. 架构与实现特点
Paperclip 采用 monorepo 架构，使用 pnpm workspaces 管理多个包，通过 tsconfig.json 的 references 实现 TypeScript 跨包类型检查。技术栈为全栈 TypeScript：后端（server 包）提供 API、业务逻辑、代理协调与公司可移植性服务；前端（ui 包）为 React 应用，实现仪表板、组织架构管理与实时监控；数据库（db 包）处理 Schema、迁移与持久化；适配器（adapters 包）为 claude-local、codex-local、cursor-local、openclaw-gateway 等提供统一接口，体现‘任何能接收心跳的代理即可雇佣’的插件化设计；共享（shared 包）包含类型定义、验证器与工具；此外还有 mcp-server（模型上下文协议服务器）扩展模型交互能力，以及 cli（命令行工具）提供终端操作。开发脚本涵盖测试（vitest、Playwright）、数据库备份、发布流程与文档服务，体现工程化成熟度。
思维导图
Paperclip
核心服务
server (Node.js API & 业务逻辑)
cli (命令行工具与脚本)
前端界面
ui (React 仪表板与移动端适配)
数据与存储
db (PostgreSQL 迁移与 Schema)
shared (跨包类型与工具)
代理适配器
claude-local
codex-local
cursor-local
openclaw-gateway
其他适配器 (droid, opencode, pi)
扩展协议
mcp-server (模型上下文协议)
开发与测试
scripts (开发、构建、发布)
tests (Vitest & Playwright)
常见问题
Paperclip 是什么？它主要用来做什么？
Paperclip 是开源编排平台，用于构建和运营零人工干预的 AI 公司。它通过 Node.js 服务器和 React UI 协调多个 AI 代理团队，实现业务目标定义、任务分配、成本监控与自主运行，让管理 AI 企业像使用任务管理器一样简单。
如何本地安装和运行 Paperclip？
安装需满足 Node.js >=20 和 [email protected]。步骤：1）运行 pnpm install 安装依赖；2）复制 .env.example 并配置 DATABASE_URL、PORT 等变量；3）执行 pnpm dev 启动开发服务器。生产环境需先运行数据库迁移（pnpm --filter @paperclipai/db migrate）。详细部署请参考官方文档。
Paperclip 支持哪些 AI 代理？如何集成？
Paperclip 支持任何能接收心跳的代理，已提供适配器包括 OpenClaw、Claude Code、Codex、Cursor、Bash、HTTP 等（见 README 表格）。集成通过 adapters 目录下的插件化适配器实现，如 claude-local、codex-local 等，也可自定义适配器接入新代理。
如何控制 AI 代理的使用成本？
Paperclip 提供 per-agent 每月预算设置。当代理达到预算限制时自动停止工作，防止成本超支。预算与使用情况可在仪表板实时监控，确保自主运行下的财务可控性。
是否支持管理多个 AI 公司？
README 提到 Multi-Company 功能（描述不完整），从现有信息可见 Paperclip 设计支持单实例多公司部署，但具体操作方式未在仓库中明确给出，建议查阅官方文档或等待 Clipmart 模板功能上线。