一、项目定位Paperclip 是一个 AI Agent 公司的运营控制平面Control Plane。用一句话概括如果 OpenClaw/Claude Code 是员工Paperclip 就是公司。它不是 Agent 框架不是聊天机器人不是工作流引擎——它是一个让你像管理公司一样管理一组 AI Agent 的操作系统组织架构、任务分配、预算控制、审批治理、成本追踪全部在一个 Dashboard 里完成。二、解决什么问题痛点Paperclip 的解法20 个 Claude Code 终端同时开分不清谁在干什么任务工单化会话线程化跨重启持久化手动拼凑上下文提醒 Agent 做什么上下文从任务→项目→公司目标自动向上流动Agent 配置散落各处重复造轮子组织架构、工单、委派、治理开箱即用Agent 跑飞了几百美元 token 费用没了成本追踪 预算硬止损 超支自动暂停定期任务要手动触发Heartbeat 定时唤醒 定例调度没有审批Agent 直接上线审批门控 治理流程 变更审计三、四大支柱支柱服务对象覆盖范围Agentic Task Manager— 声明意图Agent 执行你验收所有人日常使用任务、审批与评审门控 · 主动 Agent 协作 · 可审计的例行工作流 · 通过 diff/截图/测试验证产出Org Chart for Agents— 角色、权限与边界管理者人Agent 混合组织架构 · 职责划分与委派 · 治理谁能做什么 · 限定范围的密钥与公司边界Agent Employee Training— 设计、训练与评估 AI 员工赋能者Skill Studio 与组织级共享技能 · 评估与测试运行 · 主动学习循环与质量指标 · Agent 绩效评审Agentic OS— 让工作运转的基础设施IT 与平台跨 Provider 运行时 · 沙箱、集成与 MCP 服务器 · SSO/GRC/RBAC 与成本控制 · 数据隐私与追溯四、技术架构4.1 技术栈层技术后端Node.js Express TypeScript数据库Drizzle ORM PostgreSQL开发用嵌入式 PGlite前端React 19 Vite Tailwind v4CSS 自定义属性 Token 体系测试Vitest单元 PlaywrightE2E Storybook视觉回归包管理pnpm monorepo部署Docker / 本地自托管4.2 Monorepo 结构paperclip-master/ ├── server/ # Express REST API 编排服务 │ └── src/routes/ # 58 个路由模块agents, issues, goals, costs... ├── ui/ # React Vite 前端 │ └── src/pages/ # 133 个页面组件 ├── packages/ │ ├── db/ # Drizzle schema 迁移111 张表 │ ├── shared/ # 共享类型、常量、校验器 │ ├── adapters/ # Agent 适配器实现 │ │ ├── claude-local/ # Claude Code 本地适配 │ │ ├── codex-local/ # Codex 本地适配 │ │ ├── cursor-local/ # Cursor 本地适配 │ │ ├── cursor-cloud/ # Cursor 云端适配 │ │ ├── gemini-local/ # Gemini 本地适配 │ │ ├── grok-local/ # Grok 本地适配 │ │ ├── hermes/ # Hermes 适配 │ │ ├── hermes-gateway/ # Hermes Gateway 适配 │ │ ├── openclaw-gateway/# OpenClaw Gateway 适配 │ │ ├── opencode-local/ # OpenCode 本地适配 │ │ └── pi-local/ # Pi 本地适配 │ ├── adapter-utils/ # 适配器共享工具 │ ├── plugins/ # 插件系统 │ ├── skills-catalog/ # 应用内置技能目录 │ └── teams-catalog/ # 应用内置团队目录 ├── cli/ # paperclipai CLI 包 ├── skills/ # 运行时/运维技能 ├── .agents/skills/ # 20 个 Agent 技能 └── doc/ # 产品与运维文档4.3 代码规模指标数值TypeScript 源文件1,333 个不含 node_modules总代码行数~111 万行数据库表111 张API 路由模块58 个UI 页面组件133 个Agent 适配器11 种内置 Agent 技能20 个五、核心系统详解5.1 十二大子系统系统职责Identity Access双模式部署可信本地/认证模式、Board 用户、Agent API Key、短期运行 JWT、公司成员、邀请流Org Chart AgentsAgent 角色/职级/汇报线/权限/预算适配多种 Agent 运行时Work Task System任务带公司/项目/目标/父级链接原子 checkout 执行锁阻塞依赖评论/文档/附件/工作产出Heartbeat Execution数据库唤醒队列 合并预算检查工作空间解析密钥注入技能加载适配器调用孤立运行自动恢复Workspaces Runtime项目工作空间隔离执行空间git worktree运行时服务dev server、preview URLGovernance ApprovalsBoard 审批流执行策略 审批阶段决策追踪预算硬止损Agent 暂停/恢复/终止Budget Cost Control按公司/Agent/项目/目标/任务/Provider/模型追踪 Token 和成本告警阈值 硬止损超支自动暂停Routines SchedulesCron/Webhook/API 触发的定例任务并发与补赶策略每次执行创建追踪任务并唤醒 AgentPlugins实例级插件系统进程外 Worker能力门控宿主服务Job 调度工具暴露UI 贡献Secrets Storage实例和公司密钥加密本地存储Provider 对象存储敏感值不出现在 Prompt 中除非明确需要Activity Events变更操作、Heartbeat 状态变化、成本事件、审批、评论、工作产出全部记录为持久化活动Company Portability导入/导出整个组织Agent、技能、项目、定例、任务密钥脱敏冲突处理5.2 Agent 适配器体系Paperclip 的核心设计理念是Bring Your Own Agent——任何能接收 Heartbeat 的 Agent 都可以被雇佣Agent 适配器架构 ┌─────────────────────────────────────────────┐ │ Paperclip Server │ │ │ │ 统一适配器接口 │ │ ├── heartbeat() ← 定时唤醒 │ │ ├── assignTask() ← 分配任务 │ │ ├── checkStatus() ← 检查状态 │ │ └── collectResult() ← 收集结果 │ │ │ └──────────┬──────────────────────────────────┘ │ ┌─────┴─────┬──────────┬──────────┬──────────┐ │ │ │ │ │ ┌───┴───┐ ┌───┴───┐ ┌──┴───┐ ┌──┴───┐ ┌──┴───┐ │Claude │ │Codex │ │Cursor│ │Gemini│ │OpenClaw│ │Code │ │ │ │ │ │ │ │ │ └───────┘ └───────┘ └──────┘ └──────┘ └───────┘ 本地CLI 本地CLI 本地/云 本地CLI Gateway5.3 Heartbeat 机制Heartbeat 是 Paperclip 的核心调度模式数据库维护唤醒队列按调度时间排序到时间后唤醒 Agent合并同一 Agent 的多个唤醒请求检查预算 → 解析工作空间 → 注入密钥 → 加载技能 → 调用适配器运行产生结构化日志、成本事件、会话状态、审计轨迹孤立运行crash 后无人认领自动恢复六、设计理念6.1 核心设计原则原子执行任务 checkout 和预算执行是原子的不会重复工作不会失控花费持久化 Agent 状态Agent 跨 Heartbeat 恢复同一任务上下文而非从头开始运行时技能注入Agent 可以在运行时学习 Paperclip 工作流和项目上下文无需重训练治理与回滚审批门控强制执行配置变更有版本坏变更可以安全回滚目标感知执行任务携带完整目标链Agent 始终看到为什么而不仅是标题可移植公司模板导入/导出组织、Agent、技能密钥脱敏冲突处理真正的多公司隔离每个实体都限定在公司范围内一个部署可运行多个公司6.2 UI 设计系统Token-only 规则所有颜色、间距、圆角、字号、阴影、动效值来自ui/src/index.css的 Token 层三层 Token 体系语义层shadcn 核心→ 品牌层Agent 渐变/状态色→ 领域层匹配芯片/标注高亮操作面板定位每个屏幕回答三个问题发生了什么需要我吗我该做什么密度服务于扫描而非美学Lint 门控check-token-gates脚本在提交前拒绝任何硬编码值七、与同类项目对比维度PaperclipOpenClawClaude CodeCursor定位Agent 公司运营控制平面AI 编码 AgentAI 编码 AgentAI 编码 IDE类比公司员工员工工位管理多个 Agent✅ 核心能力❌ 单 Agent❌ 单会话❌ 单窗口组织架构✅ 原生支持❌❌❌预算控制✅ 原生支持❌❌❌审批治理✅ 原生支持❌❌❌定时调度✅ Heartbeat❌❌❌成本追踪✅ 多维度❌❌❌Agent 框架❌ 不是✅ 是✅ 是✅ 是编码能力依赖接入的 Agent✅ 核心能力✅ 核心能力✅ 核心能力八、项目成熟度评估维度状态说明代码规模⭐⭐⭐⭐⭐111 万行 TS111 张数据库表工程量巨大功能完整度⭐⭐⭐⭐⭐四大支柱全部实现20 已完成里程碑架构设计⭐⭐⭐⭐⭐Monorepo 清晰适配器体系解耦Token 体系规范Agent 生态⭐⭐⭐⭐11 种适配器覆盖主流 Agent可扩展测试覆盖⭐⭐⭐⭐单元(Vitest) E2E(Playwright) 视觉回归(Storybook)文档⭐⭐⭐⭐⭐SPEC/DESIGN/AGENTS/DEVELOPING/DATABASE 等齐全社区⭐⭐⭐MIT 开源Discord 社区插件生态起步生产就绪⭐⭐⭐支持 Docker 自托管但云部署仍在进行中九、总结Paperclip 是目前少见的从公司运营视角而非Agent 开发视角构建的 AI Agent 编排平台。它的核心价值不是教你怎么造 Agent而是教你怎么管 Agent 组成的公司——组织架构、任务分配、预算控制、审批治理、成本追踪、定期调度这些是 20 个 Agent 同时运行时真正需要的东西。技术上有三个亮点值得借鉴适配器体系BYOABring Your Own Agent设计任何能接收 Heartbeat 的 Agent 都可接入11 种适配器覆盖主流 AgentHeartbeat 调度数据库驱动的唤醒队列 原子 checkout 预算检查 自动恢复解决了多 Agent 协调的核心问题Token 设计系统严格的 CSS 变量 Token 体系 Lint 门控确保 UI 一致性和可维护性来自微信公众号LLMAgent技术分享