paperclip

快速开始 · 文档 · GitHub · Discord · Twitter · 官网

Paperclip 是用户用来管理工作 AI 代理的应用。

面向 AI 代理团队的开源编排系统。

如果把 OpenClaw 比作一个 员工，那么 Paperclip 就是 公司。

Paperclip 是一个 Node.js 服务器 + React UI，用于编排一支 AI 代理团队来运营业务。自带代理，分配目标，在一个仪表盘中跟踪工作与成本。

它看起来像一个任务管理器。但在底层：组织架构、预算、治理、目标对齐和代理协调。

管理业务目标，而不是 pull request。

	步骤	示例
01	定义目标	"打造排名第一的 AI 笔记应用，实现 100 万美元 MRR。"
02	组建团队	CEO、CTO、工程师、设计师、市场营销人员——任何 bot，任何提供商。
03	审批并运行	审查战略。设定预算。按下启动。在仪表盘上监控。

兼容 生态

OpenClaw

Claude Code

Codex

Cursor

Bash

HTTP

只要能接收心跳信号，就会被录用。

以下情况适合使用 Paperclip

• ✅ 你想构建自主 AI 公司
• ✅ 你需要协调多种不同的代理（OpenClaw、Codex、Claude、Cursor）朝着共同目标前进
• ✅ 你同时开着 20 个 Claude Code 终端，无法跟踪每个人在做什么
• ✅ 你想让代理 7×24 小时自主运行，但仍想审计工作并在需要时介入
• ✅ 你想监控成本并强制执行预算
• ✅ 你想要一种管理代理的流程，用起来像任务管理器
• ✅ 你想通过手机管理你的自主业务

四大支柱

一个 AI 代理组织要真正产出成果，有四件事必须做好：任务、组织、培训和基础设施。Paperclip 正是围绕这四大支柱构建的。

支柱	面向人群	覆盖内容
代理任务管理器 — 声明意图。代理执行。你验证产出。	所有人，日常使用	任务、审批与审查关卡 · 主动式代理同事 · 可审计的例行流程与工作流 · 通过 diff、截图和测试进行验证
代理组织架构图 — 人类和代理的角色、权限与边界。	管理者	混合人机组织架构图 · 职责、委派、专业化 · 治理：谁可以做什么 · 带作用域范围的密钥与公司边界
代理员工培训 — 设计、训练并评估你的 AI 员工。	赋能者	Skill Studio 与全组织共享技能 · 评测与保存的测试运行 · 主动学习闭环与质量指标 · 代理绩效评估
Agentic OS — 让工作运转起来的基础设施。	IT 与平台	跨提供商运行时：任何模型、任何代理 · 沙箱、集成与 MCP 服务器 · SSO、GRC、RBAC 与成本控制 · 数据隐私、内部 trace 采集、数据价值持续累积

功能特性

🔌 自带代理 任何代理、任何运行时，一张组织架构图。只要能接收心跳信号，就会被录用。	🎯 目标对齐 每项任务都回溯到公司使命。代理知道要做什么 以及 为什么做。	💓 心跳机制 代理按计划唤醒、检查工作并采取行动。委派在组织架构图中上下流动。
💰 成本控制 每个代理设置月度预算。触达限额即停止。不会再出现失控成本。	🏢 多公司支持 一次部署，多家公司。完整的数据隔离。一个控制平面管理你的全部业务组合。	🎫 工单系统 每次对话都有迹可循。每个决策都有解释说明。完整的工具调用追踪与不可篡改的审计日志。
🛡️ 治理能力 审批录用、推翻战略、暂停或终止任何代理——随时都可以。	📊 组织架构图 层级、角色、汇报关系。你的代理有上级、有头衔、有职位描述。	📱 移动端支持 随时随地监控和管理你的自主业务。

Paperclip 解决的问题

没有 Paperclip 时	有了 Paperclip 后
❌ 你开着 20 个 Claude Code 标签页，无法追踪哪个在做什么。重启后一切丢失。	✅ 任务基于工单制，对话有线程，会话跨重启持久保留。
❌ 你手动从多个地方收集上下文，提醒你的 bot 你到底在做什么。	✅ 上下文从任务向上流经项目和公司目标——你的代理始终知道要做什么以及为什么。
❌ 代理配置散落在文件夹中杂乱无章，你在重新发明任务管理、通信和代理间协调。	✅ Paperclip 开箱即用提供组织架构图、工单系统、委派和治理——你运营的是一家公司，而不是一堆脚本。
❌ 失控循环浪费数百美元的 token 额度，在你还不知道发生了什么之前就耗尽配额。	✅ 成本追踪展示 token 预算，代理超支时自动限流。管理层通过预算确定优先级。
❌ 你有周期性任务（客户支持、社交媒体、报告），还得记得手动触发。	✅ 心跳机制按计划处理日常工作。管理层负责监督。
❌ 你有个想法，得去找仓库、启动 Claude Code、保持标签页打开、全程盯着。	✅ 在 Paperclip 中添加任务。你的编码代理会一直做到完成。管理层审查他们的工作。

Paperclip 的独特之处

Paperclip 正确处理了那些困难的编排细节。

原子化执行。	任务检出和预算执行都是原子性的，因此不会重复劳动，也不会失控花钱。
持久化代理状态。	代理在心跳之间恢复相同的任务上下文，而不是从头重新开始。
运行时技能注入。	代理可以在运行时学习 Paperclip 工作流和项目上下文，无需重新训练。
带回滚的治理机制。	审批关卡强制执行，配置变更留档可追溯，坏变更可以安全回滚。
目标感知执行。	任务携带完整的目标血缘关系，因此代理始终能看到"为什么"，而不只是一个标题。
可移植的公司模板。	支持导出/导入组织、代理和技能，带有密钥擦除和冲突处理。
真正的多公司隔离。	每个实体都限定在公司范围内，因此一次部署可以运行多家公司，数据和审计轨迹完全分离。

底层架构

Paperclip 是一个完整的控制平面，而不是一个包装器。在你自己构建这些东西之前，请知道它已经存在了：

┌──────────────────────────────────────────────────────────────┐
│                       PAPERCLIP SERVER                       │
│                                                              │
│  ┌───────────┐  ┌───────────┐  ┌───────────┐  ┌───────────┐  │
│  │Identity & │  │  Work &   │  │ Heartbeat │  │Governance │  │
│  │  Access   │  │   Tasks   │  │ Execution │  │& Approvals│  │
│  └───────────┘  └───────────┘  └───────────┘  └───────────┘  │
│                                                              │
│  ┌───────────┐  ┌───────────┐  ┌───────────┐  ┌───────────┐  │
│  │ Org Chart │  │Workspaces │  │  Plugins  │  │  Budget   │  │
│  │ & Agents  │  │ & Runtime │  │           │  │ & Costs   │  │
│  └───────────┘  └───────────┘  └───────────┘  └───────────┘  │
│                                                              │
│  ┌───────────┐  ┌───────────┐  ┌───────────┐  ┌───────────┐  │
│  │ Routines  │  │ Secrets & │  │ Activity  │  │  Company  │  │
│  │& Schedules│  │  Storage  │  │ & Events  │  │Portability│  │
│  └───────────┘  └───────────┘  └───────────┘  └───────────┘  │
└──────────────────────────────────────────────────────────────┘
         ▲              ▲              ▲              ▲
   ┌─────┴─────┐  ┌─────┴─────┐  ┌─────┴─────┐  ┌─────┴─────┐
   │  Claude   │  │   Codex   │  │   CLI     │  │ HTTP/web  │
   │   Code    │  │           │  │  agents   │  │   bots    │
   └───────────┘  └───────────┘  └───────────┘  └───────────┘

系统组成

身份与访问 — 两种部署模式（可信本地模式或认证模式）、看板用户、代理 API 密钥、短期运行的 JWT、公司成员关系、邀请流程和 OpenClaw 引导。每个变更请求都追溯到具体操作者。	组织架构图与代理 — 代理具有角色、头衔、汇报关系、权限和预算。适配器示例与上图对应：Claude Code、Codex、CLI 代理（如 Cursor/Gemini/bash）、HTTP/webhook bot（如 OpenClaw）以及外部适配器插件。只要能接收心跳信号，就会被录用。
工作与任务系统 — Issue 携带公司/项目/目标/父任务链接、带执行锁的原子检出、一流的阻塞依赖、评论、文档、附件、工作产出物、标签和收件箱状态。不会重复劳动，也不会丢失上下文。	心跳执行 — 基于数据库的唤醒队列，支持合并、预算检查、工作区解析、密钥注入、技能加载和适配器调用。每次运行都产生结构化日志、成本事件、会话状态和审计轨迹。恢复机制自动处理孤儿运行。
工作区与运行时 — 项目工作区、隔离的执行工作区（git worktree、operator 分支）和运行时服务（开发服务器、预览 URL）。代理每次都在正确的目录、正确的上下文中工作。	治理与审批 — 看板审批流程、带审查/审批阶段的执行策略、决策追踪、预算硬停、代理暂停/恢复/终止，以及完整的审计日志。没有你的签署，什么都不会发布。
预算与成本控制 — 按公司、代理、项目、目标、issue、提供商和模型追踪 token 与成本。带作用域范围的预算策略，支持警告阈值和硬停。超支时自动暂停代理并取消排队中的工作。	例行流程与计划 — 支持 cron、webhook 和 API 触发的周期性任务。支持并发和补跑策略。每次例行执行都会创建一个可追踪的 issue 并唤醒分配的代理——无需手动触发。
插件系统 — 实例级插件系统，支持进程外 worker、按能力授权的宿主服务、任务调度、工具暴露和 UI 扩展。无需 fork 即可扩展 Paperclip。	密钥与存储 — 实例级和公司级密钥、加密的本地存储、基于提供商的对象存储、附件和工作产出物。敏感值不会出现在 prompt 中，除非作用域范围内的运行明确需要。
活动与事件 — 变更操作、心跳状态变化、成本事件、审批、评论和工作产出物都会记录为持久化活动，让运维人员可以审计发生了什么以及为什么。	公司可移植性 — 导出和导入整个组织——代理、技能、项目、例行流程和 issue——支持密钥擦除和冲突处理。一次部署，多家公司，完全的数据隔离。

Paperclip 不是什么

不是聊天机器人。	代理有工作，而不是聊天窗口。
不是代理框架。	我们不教你如何构建代理。我们教你如何运营一家由代理组成的公司。
不是工作流构建器。	没有拖拽式流水线。Paperclip 建模的是公司——包含组织架构图、目标、预算和治理。
不是 prompt 管理器。	代理自带 prompt、模型和运行时。Paperclip 管理的是它们所在的组织。
不是单代理工具。	这是为团队准备的。如果你只有一个代理，可能不需要 Paperclip。如果你有二十个——那绝对需要。
不是代码审查工具。	Paperclip 编排的是工作，而不是 pull request。请自带审查流程。

快速开始

开源。自托管。无需 Paperclip 账号。

curl -fsSLO https://paperclip.ing/install.sh
curl -fsSLO https://paperclip.ing/install.sh.sha256
if command -v sha256sum >/dev/null 2>&1; then
  sha256sum -c install.sh.sha256
else
  shasum -a 256 -c install.sh.sha256
fi
bash install.sh

安装程序会确保 Node.js 20 或更高版本可用，在 ~/.paperclip/cli 下安装一个受管的 Paperclip CLI，并启动交互式引导流程。在受支持的 Linux 和 macOS 系统上，它还可以将 Paperclip 安装为后台服务。校验和可以检测传输或发布错误，但它与脚本来自同一源；当你需要独立托管的来源时，请使用基于 release-tag 或 commit 固定的 GitHub 副本。

如需非交互式托管安装：

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

管道方式要求系统已具备受支持的 Node.js、npm 和 npx。如果需要进行 Node.js 引导，请先下载并审查 install.sh 再运行，避免通过管道接受任何特权依赖安装命令。

若想不永久安装任何东西试用 Paperclip：

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

故障排查：私有 npm registry .npmrc

如果因为 paperclipai（或类似包）的 E404 错误而失败，且你通过全局 ~/.npmrc 使用了私有 npm registry（例如 GitHub Packages），npx 可能正在将 paperclipai 解析到该私有 registry，而不是公共 npm registry。

诊断方法：

npm config get registry

解决方法（跨平台；为该命令强制使用公共 npm registry）：

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

该快速开始路径现在默认使用可信的本地回环模式，以获得最快的首次运行体验。若要以认证/私有模式启动，请显式选择绑定预设：

paperclipai onboard --yes --bind lan
# 或：
paperclipai onboard --yes --bind tailnet

如果你已经配置过 Paperclip，重新运行 onboard 会保留现有配置。使用 paperclipai configure 编辑设置。

有关固定版本、canary 和 git-ref 安装、更新、回滚、服务管理和卸载，请参阅 doc/INSTALLING.md。

或者手动安装：

git clone https://github.com/paperclipai/paperclip.git
cd paperclip
pnpm install
pnpm dev

这会在 http://localhost:3100 启动 API 服务器。系统会自动创建内嵌的 PostgreSQL 数据库——无需任何配置。

环境要求： Node.js 20+，pnpm 9.15+

常见问题

典型的部署方式是什么样的？ 本地环境中，单个 Node.js 进程管理内嵌 Postgres 和本地文件存储。生产环境则接入你自己的 Postgres，按你喜欢的方式部署即可。配置好项目、代理和目标——剩下的交给代理处理。

如果你是独立创业者，可以用 Tailscale 在移动中访问 Paperclip。之后需要时再部署到例如 Vercel 上。

我可以运行多家公司吗？ 可以。一次部署可以运行无限数量的公司，数据完全隔离。

Paperclip 与 OpenClaw 或 Claude Code 这类代理有什么区别？ Paperclip 使用 这些代理。它把它们编排成一家公司——包含组织架构图、预算、目标、治理和问责机制。

为什么我应该用 Paperclip，而不是直接把我的 OpenClaw 接到 Asana 或 Trello 上？ 代理编排在协调谁检出了哪项工作、如何维护会话、监控成本、建立治理机制等方面有很多微妙之处——Paperclip 帮你处理好了这些。

（自带工单系统已在路线图中）

代理是持续运行的吗？ 默认情况下，代理按计划心跳和基于事件的触发（任务分配、@提及）运行。你也可以接入 OpenClaw 这类持续运行的代理。你自带代理，Paperclip 负责协调。

开发

pnpm dev              # 完整开发环境（API + UI，watch 模式）
pnpm dev:once         # 完整开发环境，不带文件监听
pnpm dev:server       # 仅服务器
pnpm dev:mobile       # 在 :3101 提供预构建 UI，面向手机/平板（代理 /api → :3100）
pnpm dev:both         # 同时运行 `pnpm dev` 和 `pnpm dev:mobile`
pnpm build            # 构建全部
pnpm typecheck        # 类型检查
pnpm test             # 轻量默认测试运行（仅 Vitest）
pnpm test:watch       # Vitest watch 模式
pnpm test:e2e         # Playwright 浏览器测试套件
pnpm db:generate      # 生成数据库迁移
pnpm db:migrate       # 应用迁移

pnpm test 不会运行 Playwright。浏览器套件保持独立，通常只在涉及这些流程或 CI 时运行。

完整的开发指南请参阅 doc/DEVELOPING.md。

路线图

• ✅ 插件系统（例如添加知识库、自定义追踪、队列等）
• ✅ 接入 OpenClaw / claw 风格的代理员工
• ✅ companies.sh——导入和导出整个组织
• ✅ 简单的 AGENTS.md 配置
• ✅ 技能管理器、Skill Studio 与技能商店
• ✅ 定时例行流程
• ✅ 更完善的预算功能
• ✅ 代理审查与审批
• ✅ 多人类用户
• ✅ 云 / 沙箱代理（e2b、Cloudflare、Daytona、Modal、Novita、自托管 Kubernetes）
• ✅ 工件与工作产出物
• ✅ 深度规划（规划模式、可修订的计划、计划审批）
• ✅ 强制结果（看门狗、恢复操作、审查关卡）
• ✅ MCP 工具网关与应用（受治理的工具访问）
• ✅ 带代理级访问控制的密钥管理器
• ✅ 活动日志与操作归因
• ✅ 自愈运行与自动恢复
• ✅ 代理评测与反馈
• ⚪ 记忆 / 知识
• ⚪ MAXIMIZER 模式
• ⚪ 工作队列
• ⚪ 自组织
• ⚪ 自动组织学习
• ⚪ CEO 聊天
• 🟡 云部署（多租户隔离与公司导入/导出已发布）
• ⚪ 桌面应用
• ⚪ 自带工单系统（Asana / Linear / Jira 作为入口）
• ⚪ 连接应用（一键集成，例如 Vercel）

这是简短的路线图预览。完整路线图请参阅 ROADMAP.md。

社区与插件

在 awesome-paperclip 查找插件和更多内容。

可观测性

Paperclip 为服务器提供可选开启的 OpenTelemetry 自动插桩（仅 traces）。当设置了 OTEL_EXPORTER_OTLP_ENDPOINT 时激活，并通过标准的环境变量 OTEL_EXPORTER_OTLP_PROTOCOL 支持 grpc、http/protobuf 和 http/json。@opentelemetry/* 包是可选的对等依赖——仅在你想要追踪功能时安装。安装命令和完整的环境变量参考请参阅 doc/observability.md。

遥测

Paperclip 收集匿名的使用遥测数据，以帮助我们了解产品使用方式并持续改进。绝不会收集个人信息、issue 内容、prompt、文件路径或密钥。私有仓库引用在发送前会使用每次安装的独立盐值进行哈希处理。

修改遥测事件的贡献者应遵循 遥测数据契约。 对于尚未出现在生成契约中的拟议第一方事件，请遵循 遥测工作流。

遥测默认开启，可通过以下任一方式关闭：

方法	如何操作
环境变量	PAPERCLIP_TELEMETRY_DISABLED=1
标准约定	DO_NOT_TRACK=1
CI 环境	当 CI=true 时自动关闭
配置文件	在 Paperclip 配置中设置 telemetry.enabled: false

贡献

欢迎贡献。详情请参阅贡献指南。

社区

• Discord — 加入社区
• Twitter / X — 关注更新和公告
• GitHub Issues — 提交 bug 和功能请求
• GitHub Discussions — 想法和 RFC

许可证

MIT © 2026 Paperclip Labs, Inc

Star 历史

---

MIT 开源。为那些想真正完成工作、而不是盯着代理的人而构建。