labelhead-artist-momentum

快速入门 · 文档 · GitHub · Discord · Twitter · 网站

报名加入 Paperclip Cloud 等候名单 →

# Paperclip 是人们用于管理工作中 AI Agent 的应用。

面向 AI Agent 团队的开源编排工具。

如果 OpenClaw 是一名 员工，Paperclip 就是 公司。

Paperclip 是一款 Node.js 服务和 React UI，可编排一支 AI Agent 团队来运营业务。接入你自己的 Agent，分配目标，并在一个仪表板中跟踪工作和成本。为每个 Agent 选择模型和执行框架，同时将团队的任务、技能、权限和历史记录集中管理。

它看起来像一个任务管理器。其底层功能包括：组织架构、预算、治理、目标对齐和 Agent 协调。

管理业务目标，而不是拉取请求。

	步骤	示例
01	定义目标	“打造排名第一的 AI 笔记应用，实现 100 万美元 MRR。”
02	招募团队	CEO、CTO、工程师、设计师、营销人员——任意机器人、任意提供商。
03	审批并运行	审核策略。设置预算。开始运行。从仪表板监控。

自定义进程、HTTP 端点和外部适配器包可扩展支持范围。有关设置和功能，请参阅适配器概览。

## Paperclip 适合你，如果你

• ✅ 想构建自主 AI 组织
• ✅ 需要协调多个不同的 Agent（OpenClaw、Codex、Claude、Cursor），共同实现一个目标
• ✅ 开着 20 个 Claude Code 终端，却搞不清每个人都在做什么
• ✅ 希望 Agent 全天候自主运行，同时仍能审查工作，并在需要时介入
• ✅ 希望监控成本并执行预算
• ✅ 希望管理 Agent 的流程像使用任务管理器一样
• ✅ 希望用手机管理自主运营的业务

四大支柱

要让 AI Agent 组织真正产出，四个方面都必须运作良好：任务、组织、培训和基础设施。Paperclip 正是围绕这四大支柱构建的。

支柱	适用对象	涵盖内容
Agentic 任务管理器 — 明确目标。由 Agent 执行。由你验证结果。	所有人，日常使用	任务、审批与审核关卡 · 主动协作的 Agent 同事 · 可审计的日常流程与工作流 · 通过差异、截图与测试验证
Agent 组织架构图 — 为人类和 Agent 设定角色、权限与边界。	管理者	人类与 Agent 混合的组织架构图 · 职责、委派与专业分工 · 治理：谁能做什么 · 受限的密钥与公司边界 · 连接权限与负责用户身份
Agent 员工培训 — 设计、培训并评估你的 AI 员工。	赋能者	技能工作室与全组织共享技能 · 评估与已保存的测试运行记录 · 主动学习循环与质量指标 · Agent 绩效评估 · 已保存的测试输入 · 技能版本历史与恢复 · 可复用的团队模板
Agentic 操作系统 — 让工作得以运行的基础设施。	IT 与平台团队	跨提供商运行时：支持任意模型、任意 Agent · 沙箱、集成与 MCP 服务 · SSO、GRC、RBAC 与成本控制 · 数据隐私、内部追踪记录与不断累积的数据价值 · 个人与共享应用连接 · 运行历史与自选追踪

## 功能

🔌 自带 Agent 任何 Agent、任何运行时，都能纳入同一张组织架构图。只要能接收心跳，就能加入团队。	🎯 目标对齐 将任务和项目关联到组织目标。Agent 会收到其工作背后的目标背景。	💓 心跳 Agent 会在有分配的工作、后续消息或配置的计划时启动。委派工作可沿组织架构上下流转。
💰 成本控制 公司、Agent 和项目的预算。跟踪上报的支出、接收阈值提醒，并在达到配置的限额时暂停工作。	🏢 多组织 一次部署，管理多个组织。每个组织的任务、Agent、权限和活动历史彼此隔离。	🎫 任务讨论串 将对话、计划、阻碍事项、文件和运行历史与工作关联起来。可将任务分配给 Agent 或人员。
🛡️ 治理 配置审核和审批阶段、批准聘用，并在需要时暂停、重新分配或停止工作。	📊 组织架构图 层级、角色、汇报关系。你的 Agent 有上级、头衔和职位描述。	📱 适配移动设备 随时随地监控和管理你的自主业务。
🔗 应用与连接 连接服务，例如 GitHub、Notion 和 Railway，或连接你自己的 MCP 服务。将网关操作设置为“允许”“先询问”或“关闭”。	👥 共享 Agent，个人账户 选择谁可以使用某个连接，以及哪些 Agent 可以访问该连接。由管理的 GitHub 操作可以使用指挥工作的人员账户。	🧠 技能与技能工作室 安装或编写共享技能，使用已保存的输入进行测试、检查结果并恢复到早期版本。
📅 定时例行任务 按计划运行周期性工作，或通过 API 或 webhook 触发。每次运行都有任务、负责人和历史记录。	📎 成果与反馈 查找Agent 生成的文件和文档。预览支持的格式，并针对文档中的特定段落发表评论。	📦 现成团队 预览并安装包含角色、技能、项目和例行任务的团队。选择其运行时，并按需自定义设置。

实验性的 Agent Chat 和 聊天/电子邮件连接器 支持在 Paperclip 中与 Agent 对话，以及通过 Slack、Discord、Telegram 和 AgentMail 等已配置服务进行对话。启用相应的实例设置即可试用。

## Paperclip 解决的问题

不使用 Paperclip	使用 Paperclip
❌ 你打开了 20 个 Claude Code 标签页，却无法追踪每个标签页在做什么。重启后，所有内容都会丢失。	✅ 任务以工单为基础，对话按线程组织，会话在重启后仍会保留。
❌ 你需要从多个地方手动收集上下文，提醒机器人你实际在做什么。	✅ 上下文从任务一路传递到项目和公司目标——你的 Agent 始终知道要做什么以及为什么。
❌ Agent 配置文件夹杂乱无章，你还要重新发明任务管理、沟通和 Agent 协调的方式。	✅ Paperclip 开箱即提供组织架构、工单、委派和治理功能——让你运营一家公司，而不是一堆脚本。
❌ 失控的循环会浪费数百美元的令牌费用，还会在你弄清楚发生了什么之前就耗尽配额。	✅ 支出追踪、预算提醒和自动暂停功能，帮助你控制持续工作的成本。
❌ 你有需要定期处理的工作（客户支持、社交媒体、报告），却必须记得手动启动。	✅ 例行任务会按计划创建已分配的任务，并提供可供检查的输出和运行历史。
❌ 你有了一个想法，却还得找到代码仓库、启动 Claude Code、保持标签页打开并随时看护。	✅ 在 Paperclip 中添加任务。你的编码 Agent 会持续处理，直到任务完成。管理者会审核其工作。

Paperclip 的特别之处

Paperclip 能妥善处理复杂的编排细节。

原子化任务领取。	单一受派人和执行锁可防止多个运行同时领取同一任务。
持久化工作上下文。	任务、评论和文档会保留在 Paperclip 中。支持的适配器可以在多次运行间恢复已保存的会话。
运行时技能注入。	Agent 可以在运行时学习 Paperclip 工作流和项目上下文，无需重新训练。
带回滚的治理。	审批关卡会得到强制执行，配置变更会记录版本，错误变更也可以安全回滚。
可追责的连接。	人员访问权限、Agent 使用资格和网关操作权限是相互独立的控制项。批准一次调用，或保存可撤销的规则。
目标感知执行。	关联的任务和项目会携带目标层级关系，让 Agent 了解“为什么”，而不只是标题。
可移植的公司模板。	导出／导入组织、Agent 和技能时，会清除密钥并处理冲突。
组织边界。	公司范围内的访问检查会在单次部署中隔离各组织的工作、Agent 和活动。

## 底层机制

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    │
   └───────────┘  └───────────┘  └───────────┘  └───────────┘

系统

身份与访问 — 支持两种部署模式（受信任的本地模式或经过身份验证的模式），提供人员角色与权限、Agent API 密钥、短期运行 JWT、公司成员资格和邀请流程。责任用户归属信息会随着工作在委派过程中传递，并适用于受支持的托管连接。	组织架构与 Agent — Agent 拥有角色、职称、汇报关系、权限和预算。适配器示例与图表一致：Claude Code、Codex、Cursor/Gemini/bash 等 CLI Agent、OpenClaw 等 HTTP/webhook 机器人，以及外部适配器插件。只要能接收心跳，就可以聘用。
工作与任务系统 — Issue 包含公司/项目/目标/父级关联，支持带执行锁的原子签出、一等阻塞依赖、评论、文档、附件、工作成果、标签和收件箱状态。可搜索各类工作、查看文档修订版本，并添加锚定反馈。	心跳执行 — 基于数据库的唤醒队列，支持合并唤醒、预算检查、工作区解析、密钥注入、技能加载和适配器调用。运行会生成日志、用量记录和适配器专属会话状态。有限的故障恢复机制可处理受支持的故障，并将需要人工处理的情况呈现出来。
工作区与运行时 — 项目代码库与工作区、可选的隔离执行工作区（git worktree、运维人员分支），以及运行时服务（开发服务器、预览 URL）。沙盒提供方可将执行扩展到本地主机之外；具体可用性取决于配置的环境和适配器。	治理与审批 — 看板审批工作流、含审核/审批阶段的执行策略、决策跟踪、预算硬性限制，以及 Agent 暂停/恢复/终止功能。已配置的任务审核决定任务能否完成；连接操作审批则决定能否通过工具网关调用工具。
预算与成本控制 — 按公司、Agent、项目、目标、Issue、提供方和模型跟踪令牌与成本。支持按范围设置预算策略、警告阈值和硬性限制。执行限制时依据已记录的支出；用量报告和正在进行的工作可能会延迟限制生效。	例行任务与计划 — 支持通过 cron、webhook 和 API 触发的周期性任务，并提供并发与补运行策略。每次例行任务执行都会创建一个可跟踪的 Issue，并唤醒指定的 Agent，无需手动启动。
插件 — 实例级插件系统，支持进程外工作进程、受能力控制的宿主服务、作业调度、工具开放和 UI 扩展。无需分叉 Paperclip 即可扩展功能。	密钥与存储 — 公司密钥和个人密钥值、加密凭据存储、本地或兼容 S3 的文件存储、附件和工作成果。密钥引用可向获授权的运行提供凭据，而无需将值复制到普通 Agent 配置中。
活动与事件 — 更改操作、心跳状态变更、成本事件、审批、评论和工作成果都会记录为持久活动，供运维人员审计事件经过及其原因。	公司可移植性 — 预览、导出和导入组织包，其中包含 Agent、技能，以及可选的项目、例行任务、任务和附件。引用的密钥值不会包含在内；分享前请检查软件包，因为纯文本环境变量值和本地路径可能仍会保留。软件包用于共享运行配置；完整实例恢复需使用备份。

## Paperclip 不是什么

不只是聊天机器人。	对话始终与任务、计划、决策和输出关联。实验性的 Agent 聊天功能可以将工作交接给已分配的任务。
不是 Agent 框架。	我们不会告诉你如何构建 Agent，而是告诉你如何运营一家由 Agent 组成的公司。
不只是工作流构建器。	日常流程在组织内运行，并设有角色、目标、预算和治理机制。
不是提示词管理器。	Agent 使用各自的提示词、模型和运行时。Paperclip 管理它们所处的组织。
不局限于单个 Agent。	从一个 Agent 开始，逐步发展为一支拥有共享技能、委派机制和审核流程的团队。
不只用于代码审核。	编码和 PR 审核可与研究、运营、内容创作及其他工作并行开展。

快速入门

开源。可自托管。无需 Paperclip 账号。按照快速入门指南设置你的第一个 Agent。

只需让你的 Agent 安装 Paperclip

将安装指南分享给你的 Agent。

或自行安装

安装 Node.js 24.11 或更高版本后：

npx paperclipai@latest onboard --yes

CLI 从 npm 缓存运行；实例配置和数据会保存在本地。

有关托管安装、固定版本、canary 和 git-ref 安装、更新、回滚、服务管理和卸载，请参阅安装指南。

如果要手动测试一个已初始化并配置了 CEO Agent 的独立实例，请使用 test-drive。它会在前台运行，不会安装服务或创建首个任务，并且只有在设置成功后才会打开浏览器：

ANTHROPIC_API_KEY=... npx paperclipai test-drive
OPENAI_API_KEY=... npx paperclipai test-drive --harness codex
OPENROUTER_API_KEY=... npx paperclipai test-drive \
  --harness opencode \
  --model openrouter/anthropic/claude-sonnet-4.5

每次运行时，如果未指定 --data-dir，都会创建一个唯一且保留的临时目录；其绝对路径会在启动时显示。传入 --data-dir 可重复使用某个目录，传入 --no-browser 则不会打开已初始化的实例。从已关联的 Git worktree 中调用时，test-drive 还会启用在该 worktree 中执行任务的功能。有关凭据和重复使用行为，请参阅 test-drive 指南。

故障排除：私有 npm 注册表 .npmrc

如果此操作因 paperclipai（或类似名称）出现 E404 错误而失败，并且你通过全局 ~/.npmrc 使用私有 npm 注册表（例如 GitHub Packages），那么 npx 可能会从该私有注册表而非公共 npm 注册表解析 paperclipai。

诊断：

npm config get registry

解决方法（跨平台；强制此命令使用公共 npm 注册表）：

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

现在，快速入门流程默认采用受信任的本地 loopback 模式，以便尽快完成首次运行。如需改用经过身份验证的私有模式，请明确选择绑定预设：

npx paperclipai@latest onboard --yes --bind lan
# or:
npx paperclipai@latest onboard --yes --bind tailnet

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

或者手动操作：

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

这会在 http://localhost:3100 启动 UI 和 API。系统会自动创建内嵌 PostgreSQL 数据库，无需进行设置。

要求： Node.js 24.11+，pnpm 9.15+

本地 Claude 和 Codex 订阅登录还需要 Paperclip 主机安装 Python 3 和相应的提供商 CLI。Docker 镜像已包含这些组件。

启用源代码开发时，也会构建原生 Paperclip Runner（可自托管模式下的默认设置）。请安装 Rust 工具链，或将 PAPERCLIP_RUNNER_BINARY 设置为兼容的预构建 Runner。

## 常见问题

问：这个项目有人维护，还是只是垃圾代码？

答： Paperclip 由 Paperclip 团队维护。我们已合并超过 2,700 个拉取请求。

问：典型的设置是什么样的？

答： 本地运行时，单个 Node.js 进程会管理嵌入式 Postgres 和本地文件存储。用于生产环境时，可连接到你自己的 Postgres，并按你喜欢的方式部署。配置项目、Agent 和目标，其余工作由 Agent 负责。

如需远程访问，可使用经过身份验证的模式，并绑定到 Tailscale 等专用网络；也可以使用 Docker 部署持久运行的服务。请参阅部署模式和 Docker 指南。

问：我可以运行多家公司吗？

答： 可以。单个部署可以托管多个组织，并提供按公司隔离的数据和访问检查。

问：Paperclip 与 OpenClaw 或 Claude Code 等 Agent 有何不同？

答： Paperclip _使用_这些 Agent。它会将它们编排成一家公司，提供组织架构、预算、目标、治理和责任追踪。

问：为什么要使用 Paperclip，而不是直接让我的 OpenClaw 连接 Asana 或 Trello？

答： Agent 编排涉及许多细节，例如协调谁正在处理哪些工作、如何维持会话、监控成本以及建立治理机制——Paperclip 会替你处理这些。

（自带工单系统已列入路线图）

问：Agent 会持续运行吗？

答： Agent 会在收到分配的工作和后续消息时启动。可选的定时心跳机制可让它们定期检查是否有工作；例程则会按各自的计划创建周期性任务。你还可以连接 OpenClaw 等外部运行的 Agent。仅提及某个 Agent 并不会为其分配工作或唤醒它。

开发

pnpm dev              # Full dev (API + UI, watch mode)
pnpm dev:once         # Full dev without file watching
pnpm dev:server       # Server only
pnpm dev:mobile       # Serve prebuilt UI on :3101 for phones/tablets (proxies /api → :3100)
pnpm dev:both         # Run `pnpm dev` and `pnpm dev:mobile` together
pnpm build            # Build all
pnpm typecheck        # Type checking
pnpm test             # Cheap default test run (Vitest only)
pnpm test:watch       # Vitest watch mode
pnpm test:e2e         # Playwright browser suite
pnpm db:generate      # Generate DB migration
pnpm db:migrate       # Apply migrations

pnpm test 不会运行 Playwright。浏览器测试套件是单独运行的，通常只在处理相关流程或 CI 中运行。

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

路线图

• ✅ 插件系统（例如，添加知识库、自定义追踪、队列等）
• ✅ 引入 OpenClaw / claw 风格的 Agent 员工
• ✅ companies.sh - 导入和导出整个组织
• ✅ 轻松配置 AGENTS.md
• ✅ 技能管理器、技能工作室和技能商店
• ✅ 定时例程
• ✅ 更完善的预算管理
• ✅ Agent 评审与审批
• ✅ 多个人类用户
• ✅ 云端 / 沙盒 Agent（e2b、Cloudflare、Daytona、Modal、Novita、可自托管的 Kubernetes）
• ✅ 工件与工作成果
• ✅ 深度规划（规划模式、带版本的计划、计划审批）
• ✅ 强制执行结果（看门狗、恢复操作、评审关卡）
• ✅ MCP 工具网关与应用（受管控的工具访问）
• ✅ 按 Agent 配置访问权限的密钥管理器
• ✅ 活动日志与操作归属
• ✅ 自我修复运行与自动恢复
• ✅ Agent 评估与反馈
• ✅ 已连接的应用
• ✅ 个人与共享 AI 账户
• ✅ 共享 Agent 使用个人 GitHub 身份
• ✅ 技能版本历史与恢复
• ✅ 文档评论与修订历史
• ✅ 公司范围搜索
• ✅ 多模型与多框架团队
• 🟡 记忆 / 知识
• ⚪ MAXIMIZER MODE
• ⚪ 工作队列
• ⚪ 自我组织
• ⚪ 自动化组织学习
• 🟡 Agent 聊天
• 🟡 云端部署
• ⚪ 桌面应用
• ⚪ 自带工单系统（将 Asana / Linear / Jira 用作接入方式）

这是简短的路线图预览。请在 ROADMAP.md 中查看完整路线图。

社区与插件

在 awesome-paperclip 中查找插件及更多内容

可观测性

Paperclip 为服务端提供可选的 OpenTelemetry 自动检测（仅追踪）。设置 OTEL_EXPORTER_OTLP_ENDPOINT 后即可启用，并通过标准的 OTEL_EXPORTER_OTLP_PROTOCOL 环境变量支持 grpc、http/protobuf 和 http/json。@opentelemetry/api 是服务端的常规依赖；SDK、自动检测和导出器包均为可选的对等依赖，只有需要追踪时才需安装。有关安装命令和完整的环境变量参考，请参阅 doc/observability.md。

Paperclip 还为服务端和浏览器提供可选的 Sentry 错误监控。设置 SENTRY_DSN_FRONTEND 可为浏览器启用监控，设置 SENTRY_DSN_BACKEND 可为服务端启用监控；这两个变量均为可选，旧版变量 SENTRY_DSN 仍可作为任一组件的回退配置。支持的服务端 SDK 版本为 @sentry/[email protected]；它是服务端的可选对等依赖，只有需要错误监控时才需安装。浏览器 SDK @sentry/browser 固定为完全相同的版本。有关安装命令、隐私设置和完整的默认采集项，请参阅 doc/observability.md。

遥测

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

更改所发送遥测事件的贡献者应遵循遥测数据契约。 对于尚未纳入生成契约的第一方事件提案，请遵循遥测工作流。

遥测默认启用，可通过以下任一方式禁用：

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

贡献

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

我们正在招聘

社区

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

许可证

MIT © 2026 Paperclip Labs, Inc

Star 历史

---

_{基于 MIT 协议开源。为想把工作做好，而不是整天照看 Agent 的人打造。}