Paperclip 项目调研报告
notes/research/github/paperclip-2026-03-19.md
Port 8777
# Paperclip 项目调研报告
**调研时间**: 2026-03-19
**调研对象**: GitHub - paperclipai/paperclip
**报告类型**: GitHub 项目分析
---
## 📌 项目概览
| 指标 | 数据 |
|------|------|
| **项目名称** | paperclip |
| **完整名称** | paperclipai/paperclip |
| **描述** | Open-source orchestration for zero-human companies（零人工公司的开源编排系统） |
| **主页** | https://paperclip.ing |
| **创建时间** | 2026-03-02 |
| **最后更新** | 2026-03-18 |
| **Stars** | 28,994 ⭐ |
| **Forks** | 3,885 🔱 |
| **开放 Issues** | 768 |
| **主要语言** | TypeScript |
| **许可证** | MIT License |
| **仓库大小** | 9.8 MB |
---
## 🎯 核心定位
**Paperclip 是一个 Node.js 服务器 + React UI 系统，用于编排 AI 代理团队来运营公司。**
> 如果 OpenClaw 是一个员工，Paperclip 就是整个公司
### 核心理念
- **Bring Your Own Agent**: 支持任何 AI 代理（OpenClaw、Claude Code、Codex、Cursor 等）
- **Org Chart First**: 用组织架构图管理代理，而不是聊天窗口
- **Goal-Aligned Execution**: 每个任务都追溯到公司使命
- **Cost Control**: 按代理设置预算，超支自动停止
- **Heartbeat-Driven**: 代理按计划唤醒、检查工作、执行任务
---
## 🏗️ 核心功能
### 1. 组织架构（Org Chart）
- 层次结构、角色、汇报关系
- 代理有老板、职位和岗位描述
- 支持多公司隔离部署
### 2. 目标对齐（Goal Alignment）
```
公司使命 → 项目目标 → 代理目标 → 具体任务
```
- 每个任务都有完整的「为什么」上下文
- 代理始终知道做什么以及为什么做
### 3. 心跳机制（Heartbeats）
- 代理按计划唤醒（如每 4 小时、8 小时、12 小时）
- 自动委派工作流上下流转
- 任务分配可唤醒代理
### 4. 成本控制（Cost Control）
- 每个代理设置月度预算
- 按代理、任务、项目、目标追踪成本
- 超支自动停止，防止 runaway 费用
### 5. 工单系统（Ticket System）
- 结构化任务工单，明确负责人、状态和线程
- 完整追踪：每个工具调用、API 请求、决策点都记录
- 不可变审计日志：只增不改，完全可追溯
### 6. 治理（Governance）
- 用户是「董事会」：审批招聘、覆盖策略、暂停/终止任何代理
- 审批门禁强制执行
- 配置变更版本化，支持安全回滚
### 7. 多公司支持（Multi-Company）
- 单一部署可运行无限家公司
- 完全数据隔离
- 一个控制平面管理整个投资组合
---
## 🚀 快速开始
```bash
# 交互式安装（自动配置数据库和认证）
npx paperclipai onboard --yes
# 或手动安装
git clone https://github.com/paperclipai/paperclip.git
cd paperclip
pnpm install
pnpm dev
```
**要求**: Node.js 20+, pnpm 9.15+
启动后 API 服务器运行在 `http://localhost:3100`，自动创建嵌入式 PostgreSQL 数据库。
---
## 📁 项目结构
```
paperclip/
├── .agents/ # 代理配置
├── .claude/ # Claude 特定配置
├── cli/ # 命令行工具
├── docs/ # 文档
├── packages/ # 多包工作区
├── server/ # API 服务器
├── scripts/ # 脚本工具
├── docker/ # Docker 配置
└── report/ # 报告生成
```
---
## 💡 使用场景
### ✅ 适合使用 Paperclip 的情况
- 想构建自主 AI 公司
- 需要协调多个不同代理（OpenClaw、Codex、Claude、Cursor）朝着共同目标工作
- 同时打开 20 个 Claude Code 终端，难以追踪每个人在做什么
- 希望代理 24/7 自主运行，但仍想审计工作并在需要时介入
- 想监控成本并执行预算
- 想要像使用任务管理器一样管理代理流程
- 想从手机管理自主业务
### ❌ 不适合的情况
- 只有一个代理（可能不需要 Paperclip）
- 只需要单个代理工具
- 只需要代码审查工具
---
## 🆚 与 OpenClaw 的对比
| 维度 | OpenClaw | Paperclip |
|------|----------|-----------|
| **定位** | 个人 AI 助手 | AI 公司编排系统 |
| **规模** | 单代理 | 多代理团队 |
| **管理方式** | 直接对话 | 组织架构 + 工单系统 |
| **成本追踪** | 基础 | 按代理/任务/项目/目标详细追踪 |
| **治理** | 无 | 审批门禁、审计日志、回滚 |
| **心跳** | 可选 | 核心机制 |
> Paperclip 使用 OpenClaw 这样的代理，将它们编排成一个公司——有组织架构、预算、目标和治理。
---
## 🔮 即将推出：Clipmart
- 一键下载和运行整个公司
- 浏览预构建的公司模板（完整组织结构、代理配置和技能）
- 几秒钟内导入到 Paperclip 实例
---
## 📊 技术亮点
1. **原子执行**: 任务签出和预算执行是原子的，避免重复工作和失控支出
2. **持久代理状态**: 代理在心跳之间恢复相同的任务上下文，而不是从头开始
3. **运行时技能注入**: 代理可以在运行时学习 Paperclip 工作流和项目上下文，无需重新训练
4. **可移植公司模板**: 导出/导入组织、代理和技能，支持秘密清理和冲突处理
5. **真正的多公司隔离**: 每个实体都有公司范围，单一部署可运行多家公司
---
## 🔗 相关链接
- **GitHub**: https://github.com/paperclipai/paperclip
- **官方文档**: https://paperclip.ing/docs
- **Discord 社区**: https://discord.gg/m4HZY7xNG3
- **许可证**: MIT License
---
## 📝 总结
Paperclip 是一个极具创新性的项目，它将 AI 代理管理从「单个助手」提升到「整个公司」的层面。通过组织架构、目标对齐、心跳机制、成本控制和治理系统，Paperclip 为大规模 AI 代理协作提供了完整的解决方案。
**核心优势**:
- 🎯 目标驱动的代理执行
- 💰 精细的成本控制和预算 enforcement
- 📋 完整的审计追踪和治理
- 🏢 多公司隔离和可移植模板
- 🔌 与任何代理运行时兼容
**注意事项**:
- 项目非常新（2026 年 3 月创建），但增长极快（17 天近 29k stars）
- 目前开放 Issues 较多（768 个），可能处于快速迭代期
- 适合需要管理多个 AI 代理的高级用户
---
*调研完成时间：2026-03-19 07:35 (Asia/Shanghai)*