Paperclip 项目介绍

Paperclip 项目介绍

项目定位

如果 OpenClaw 是一个员工，Paperclip 就是这家公司。

Paperclip 是一个开源的 AI Agent 公司控制平面（Control Plane），它将多个 AI Agent（Claude Code、Codex、Cursor、OpenClaw 等）编排为有组织架构、目标对齐、预算约束和治理审批的完整公司。

核心能力

• 自带 Agent（BYOA）：支持 Claude Code、Codex、Cursor、OpenClaw、Gemini、Grok 等多种 Agent 运行时，通过统一的 Adapter 协议接入
• 组织架构（Org Chart）：定义 CEO、CTO、工程师等角色和汇报关系，形成严格的树形组织
• 目标对齐（Goal Alignment）：每项任务都追溯到公司目标，Agent 始终知道”为什么做”
• 心跳执行（Heartbeat）：DB 驱动的唤醒队列，支持定时触发、事件触发和手动触发，Agent 按需唤醒
• 预算控制（Budget Control）：按 Agent/项目/公司设置月度预算，超限自动暂停
• 治理审批（Governance）：董事会审批流程，控制招聘、战略变更、预算调整等关键决策
• 多公司隔离（Multi-Company）：一次部署，多家公司，完全数据隔离
• 插件系统（Plugins）：进程外 Worker 隔离的插件运行时，可扩展工具、环境驱动、数据库命名空间等

技术栈

层级	技术
运行时	Node.js 20+, TypeScript, ESM
后端	Express.js REST API
前端	React + Vite
数据库	PostgreSQL + Drizzle ORM（开发模式嵌入 PGlite）
包管理	pnpm workspaces（monorepo）
测试	Vitest + Playwright（e2e）
构建	esbuild + TypeScript

架构概览

快速体验

# 方式一：一行命令启动（最快路径）
npx paperclipai onboard --yes

# 方式二：从源码启动
git clone https://github.com/paperclipai/paperclip.git
cd paperclip
pnpm install
pnpm dev
# 服务启动在 http://localhost:3100

教程导读

本项目的教程分为两个方向：

AI 应用知识（5 章）：从 Paperclip 出发，教授控制平面设计、Adapter 模式、心跳执行模型、多租户数据隔离和预算治理等通用知识。

编程核心知识（5 章）：聚焦 Paperclip 的具体工程实践，包括 monorepo 架构、事件驱动服务、Drizzle ORM 数据模型、插件运行时和 React 仪表盘工程。

类别	章节数	核心内容
AI	5 章	心跳执行模型、Adapter 协议、多公司隔离、预算治理、目标对齐任务树
Dev	5 章	Monorepo 架构、插件 SDK 设计、事件驱动架构、Drizzle 迁移策略、React 仪表盘工程