PaperclipAI

项目概述

Paperclip 是一个面向"AI 代理公司"的开源编排平台。如果说 OpenClaw 是一名"员工"，那么 Paperclip 就是一家"公司"。它由 Node.js 服务端与 React 前端组成，用于调度一组 AI 代理协同完成业务目标。用户可接入自有的代理、分配目标，并在一个仪表板上统一跟踪工作进度与成本开销。

核心理念：四大支柱

要让 AI 代理组织真正产出成果，必须同时解决四个层面的问题，Paperclip 围绕这四个支柱构建：

• 代理任务管理器：声明意图，代理执行，人工核验产出。包含任务、审批关卡、可审计的例行工作流，以及基于 diff、截图与测试的验证机制。
• 代理组织架构图：为人类与代理定义角色、权限与边界，支持混合组织、责任委派、专业化分工、治理策略、隔离的密钥与公司边界。
• 代理员工训练：通过 Skill Studio 与组织级共享技能、评估测试、主动学习回路与质量指标来设计、培训并评估 AI 员工。
• 代理操作系统：作为底层基础设施，跨提供商支持任意模型与代理运行时、沙箱隔离、集成与 MCP 服务端、SSO/GRC/RBAC 与成本控制、数据隐私与内部追踪。

关键特性

• 自带代理：支持任意代理与运行时，只要能接收心跳即可纳入。
• 目标对齐：所有任务向上追溯到公司使命，代理既能理解"做什么"也能理解"为什么"。
• 心跳驱动：代理按计划唤醒、检查工作并执行，委派关系沿组织架构上下流动。
• 成本控制：按代理设置月度预算，达到上限即停止，避免失控。
• 多公司并行：单次部署可承载多家公司，数据完全隔离。
• 工单系统：每次对话与决策均被记录，提供完整的工具调用追踪与不可变审计日志。
• 治理能力：审批招聘、覆盖策略、随时暂停或终止任意代理。
• 组织架构图：层级、角色、汇报线齐全，每个代理拥有上级、头衔与岗位描述。
• 移动端就绪：支持随时随地管理自主业务。

技术架构

Paperclip 服务端由十二个核心子系统组成：身份与访问、组织与代理、工作与任务、心跳执行、工作区与运行时、治理与审批、预算与成本、例程与调度、插件、密钥与存储、活动事件、公司可移植性。代理适配器覆盖 Claude Code、Codex、Cursor/Gemini/bash 等 CLI 代理，以及 OpenClaw 风格的 HTTP/Webhook 机器人。

底层关键能力包括：原子任务签出与预算执行、跨心跳的持久化会话状态、运行时技能注入、审批关卡与可回滚的配置变更、带目标谱系的任务、可导出的公司模板，以及完全公司级的数据隔离。

快速开始

一键安装脚本会自动确保 Node.js 20+ 可用，并安装托管版 CLI：

curl -fsSLO https://paperclip.ing/install.sh
curl -fsSLO https://paperclip.ing/install.sh.sha256
sha256sum -c install.sh.sha256   # 或 shasum -a 256 -c install.sh.sha256
bash install.sh

非交互式安装：

curl -fsSL https://paperclip.ing/install.sh | bash -s -- --no-prompt --no-onboard
paperclipai onboard --yes

零安装试用：

npx --registry https://registry.npmjs.org paperclipai onboard --yes

手动从源码启动：

git clone https://github.com/paperclipai/paperclip.git
cd paperclip
pnpm install
pnpm dev        # 启动 API 服务，监听 http://localhost:3100

要求：Node.js 20+、pnpm 9.15+。内置嵌入式 PostgreSQL，无需手动配置。默认绑定为本地回环以追求最快首次运行；如需认证模式可显式指定 paperclipai onboard --yes --bind lan 或 --bind tailnet。

开发命令

pnpm dev              # 全量开发（API + UI，watch 模式）
pnpm dev:server       # 仅服务端
pnpm dev:mobile       # 移动端 UI（:3101，代理 /api → :3100）
pnpm dev:both         # 同时启动 dev 与 dev:mobile
pnpm build            # 构建全部
pnpm typecheck        # 类型检查
pnpm test             # 轻量测试（仅 Vitest）
pnpm test:e2e         # Playwright 浏览器套件
pnpm db:generate      # 生成数据库迁移
pnpm db:migrate       # 应用迁移

可观测性与遥测

服务内置可选的 OpenTelemetry 自动埋点（仅追踪）。当设置 OTEL_EXPORTER_OTLP_ENDPOINT 时启用，支持 grpc、http/protobuf、http/json，需通过标准 OTEL_EXPORTER_OTLP_PROTOCOL 变量指定协议。遥测默认开启，可在环境变量 PAPERCLIP_TELEMETRY_DISABLED=1、DO_NOT_TRACK=1、CI 环境（自动）或配置文件中关闭。

路线图概览

已完成：插件系统、OpenClaw 风格员工导入、公司级导入导出、AGENTS.md 配置、技能管理、定时例程、强化预算、代理评审与审批、多用户支持、云沙箱代理、工件与工作产物、深度规划、强制结果门禁、MCP 工具网关、密钥管理器、活动日志、自愈运行、代理评估。

进行中：云部署的多租户隔离与公司导入导出。

规划中：记忆与知识库、最大化模式、工作队列、自组织、自动化组织学习、CEO 聊天、桌面应用、自带工单系统（接入 Asana/Linear/Jira）、一键集成应用。

许可证

MIT 协议。