英文原文正文为项目原始 README(英文),本站后续会翻译为中文,当前仅剔除图片与无关章节并统一排版。
快速开始 · 文档 · GitHub · Discord · 推特 · 网站
Paperclip 是人们用来管理工作中 AI 代理的应用程序。
用于 AI 代理团队的开源编排工具。
如果 OpenClaw 是一名 员工,那么 Paperclip 就是那家公司。
Paperclip 是一个 Node.js 服务器和 React 用户界面,用于编排一组 AI 代理来运营业务。自己带来代理,分配目标,并从一个仪表板跟踪工作和成本。为每个代理选择模型和工具,同时将团队的任务、技能、权限和历史记录集中在一个地方。
它看起来像一个任务管理器。实际上:组织结构图、预算、治理、目标对齐和代理协作。
管理业务目标,而不是拉取请求。
| 步骤 | 示例 | |
|---|---|---|
| 01 | 定义目标 | "打造№1 AI 笔记应用,实现每月收入 100 万美元。" |
| 02 | 招募团队 | CEO、CTO、工程师、设计师、市场人员——任何机器人,任何供应商。 |
| 03 | 批准并执行 | 审查策略。设定预算。开始执行。从仪表板监控。 |
| 适用于 与 |
开爪 |
克劳德代码 |
编解码器 |
光标 云 |
双子座CLI |
OpenCode |
Pi |
赫尔墨斯 网关 |
Grok Build |
Kimi Code |
自定义流程、HTTP 端点和外部适配器包扩展了列表。有关设置和功能,请参见 适配器概述。
如果 Paperclip 适合你
- ✅ 你想建立 自主 AI 组织
- ✅ 你 协调许多不同的代理(OpenClaw、Codex、Claude、Cursor)以实现共同目标
- ✅ 你有 20 个同时运行的 Claude 代码终端 并且跟不上每个人在做什么
- ✅ 你希望代理 全天候自主运行 24/7,但仍想审核工作并在需要时介入
- ✅ 你想 监控成本 并执行预算
- ✅ 你想要一种管理代理的流程,感觉像在使用任务管理器
- ✅ 你想从手机上管理你的自主业务 **
四大支柱
一个由人工智能代理组成的组织要真正产生成果,必须四方面协同运作:任务、组织、培训和基础设施。Paperclip 正是围绕这四个支柱构建的。
| 支柱 | 构建目的 | 涵盖内容 |
|---|---|---|
| 代理任务管理器 — 声明意图。代理执行工作。你验证输出。 | 所有人,每日 | 任务、审批与审核门槛 · 主动代理同事 · 可审计的例行程序与工作流程 · 从差异、截图与测试中验证 |
| 代理组织结构图 — 人类与代理的角色、权限与边界。 | 管理者 | 混合人类代理组织结构图 · 职责、委派、专业化 · 治理:谁可以做什么 · 范围化的机密与公司边界 · 连接权限与责任用户身份 |
| 代理员工培训 — 设计、培训与评估你的 AI 员工。 | 促进者 | 技能工作室与全组织共享技能 · 评估与已保存的测试运行 · 主动学习循环与质量指标 · 代理绩效评审 · 已保存的测试输入 · 技能版本历史与恢复 · 可重用团队模板 |
| 代理操作系统 — 让工作运行的基础设施。 | IT 与平台 | 跨提供商运行时:任意模型,任意代理 · 沙箱、集成与 MCP 服务器 · 单点登录、GRC、RBAC 与成本控制 · 数据隐私、内部追踪收集、复合数据价值 · 个人与共享应用连接 · 运行历史与自愿追踪 |
功能
🔌 自带代理任何代理,任何运行时,一个组织架构。如果它能接收心跳信号,它就被雇佣了。 |
🎯 目标对齐将任务和项目与您的组织目标关联起来。员工可以了解其工作背后的目标背景。 |
💓 心跳代理人会在分配的工作、跟进消息或配置的日程中醒来。委派在组织结构图上上下流动。 |
💰 成本控制公司、代理和项目预算。跟踪报告支出,获取阈值警报,并在设定的限制处暂停工作。 |
🏢 多组织一次部署,多个组织。为每个组织分别管理任务、代理、权限和活动历史记录。 |
🎫 任务线程将对话、计划、阻碍、文件和运行历史附加到工作中。将任务分配给代理或人员。 |
🛡️ 治理Configure the review and approval stages, approve recruitment, and suspend, reassign, or stop work if necessary. |
📊 组织结构图层级、角色、汇报线路。你的代理人有一个上司、一个职位和一份工作描述。 |
📱 移动端就绪随时随地监控和管理您的自主业务。 |
🔗 应用与连接连接服务,例如 GitHub、Notion 和 Railway,或您自己的 MCP 服务器。将网关操作设置为 允许、先询问 或 关闭。 |
👥 共享代理,个人账户选择 谁可以使用连接以及哪些代理可以访问它。托管的 GitHub 操作可以使用指导工作人的账户。 |
🧠 技能与技能工作室安装或编写共享技能,使用已保存的输入进行测试,检查结果,并恢复早期版本。 |
📅 计划例程按计划运行定期工作,或通过 API 或 webhook 触发它。每次运行都有一个任务、一个所有者和一个历史记录。 |
📎 文物与反馈查找代理生成的文件和文档。预览支持的格式,并在文档的特定段落上留下评论。 |
📦 现成团队预览并安装团队,包括角色、技能、项目和例行任务。选择它们的运行时并自定义设置。 |
实验性 Agent Chat 和 聊天/电子邮件连接器 可在 Paperclip 中以及通过配置的服务(如 Slack、Discord、Telegram 和 AgentMail)与代理进行对话。启用相关的实例设置即可尝试它们。
Paperclip 解决的问题
| 无回形针 | 有回形针 |
|---|---|
| ❌ 你打开了 20 个 Claude Code 标签页,却无法追踪每个标签页具体的功能。重启后你会失去所有内容。 | ✅ 任务基于工单,聊天是线程化的,重启后会话仍然保留。 |
| ❌ 你需要从多个地方手动收集上下文来提醒你的机器人你实际上在做什么。 | ✅ 上下文从任务到项目再到公司目标流动——你的代理总是知道该做什么以及为什么这么做。 |
| ❌ 代理配置文件夹混乱,你不断重新发明任务管理、沟通和代理之间的协调方法。 | ✅ Paperclip 提供组织结构图、工单、委派和治理功能——让你经营公司,而不仅仅是一堆脚本。 |
| ❌ 无控制的循环消耗数百美元的 tokens,并在你甚至不知道发生了什么之前就用尽配额。 | ✅ 支出跟踪、预算提醒和自动暂停帮助你控制持续工作的成本。 |
| ❌ 你有定期任务(客户支持、社交、报告),必须记得手动启动它们。 | ✅ 日常工作按计划分配任务,可查看输出和运行历史记录。 |
| ❌ 你有一个想法,需要找到你的代码库,启动 Claude Code,保持一个标签页打开并看护它。 | ✅ 在 Paperclip 中添加任务。你的编码代理会完成任务,管理者可以审核他们的工作。 |
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、公司成员资格以及邀请流程。责任用户归属通过委派工作和支持的管理连接来跟踪。 | **组织架构图与代理** — 代理具有角色、职称、汇报关系、权限和预算。适配器示例与图表匹配:Claude Code、Codex、CLI 代理如 Cursor/Gemini/bash、HTTP/webhook 机器人如 OpenClaw,以及外部适配器插件。只要它能接收心跳信号,就算被雇佣。 |
| **工作与任务系统** — 问题包含公司/项目/目标/父级链接,具有执行锁的原子签出,一级阻塞依赖、评论、文档、附件、工作产出、标签和收件箱状态。在工作中进行搜索,审查文档修订,并留下锚定反馈。 | **心跳执行** — 基于数据库的唤醒队列,具有合并、预算检查、工作区解析、秘密注入、技能加载和适配器调用功能。运行过程会生成日志、使用记录和适配器特定的会话状态。受限的恢复机制处理已知故障,并呈现需要人工干预的情况。 |
| **工作区与运行时** — 项目仓库和工作区,可选的隔离执行工作区(git 工作树、操作分支)以及运行时服务(开发服务器、预览 URL)。沙箱提供者将执行扩展到本地主机之外;可用性取决于配置的环境和适配器。 | **治理与审批** — 董事会审批工作流、带有审核/审批阶段的执行政策、决策跟踪、预算硬性限制,以及代理的暂停/恢复/终止。配置的任务审核管理完成情况;连接操作审批通过工具网关管理呼叫。 |
| **预算与成本控制** — 按公司、代理、项目、目标、问题、供应商和模型跟踪代币和成本。具有警告阈值和硬性停止的范围预算政策。执行依赖于已记录的支出;使用报告和进行中的工作可能会延迟停止。 | **常规与日程** — 可通过 cron、webhook 和 API 触发的重复任务。并发与追赶策略。每次常规执行都会创建一个被跟踪的问题,并唤醒指定的代理 — 无需手动启动。 |
| **[插件](https://docs.paperclip.ing/administration/plugins/)** — 面向整个实例的插件系统,具有进程外工作者、基于能力的主机服务、任务调度、工具暴露和用户界面贡献功能。无需分叉即可扩展 Paperclip。 | **秘密与存储** — 公司机密和每个人的秘密值,加密的凭证存储,本地或兼容 S3 的文件存储,附件和工作成果。秘密引用向授权运行提供凭证,而无需将值复制到普通代理配置中。 |
| **活动与事件** — 变更操作、心跳状态变化、成本事件、审批、评论和工作成果都会被记录为持久活动,以便操作员可以审计发生了什么以及原因。 | **[公司可移植性](https://docs.paperclip.ing/guides/power/export-import/)** — 预览、导出和导入包含代理、技能以及可选项目、例程、任务和附件的组织包。引用的秘密值会被省略;在共享之前请检查包,因为普通的环境值和本地路径可能仍然存在。包共享操作设置;完整实例恢复使用备份。 |
Paperclip 不是什么
| 不仅仅是聊天机器人。 | 对话会与任务、计划、决策和结果相关联。实验性代理聊天可以将工作移交给指定的任务。 |
| 不是代理框架。 | 我们不会告诉你如何构建代理。我们会告诉你如何运营由代理组成的公司。 |
| 不仅仅是工作流构建器。 | 日常流程在组织内运行,涉及角色、目标、预算和治理。 |
| 不是提示管理器。 | 代理自带提示、模型和运行环境。Paperclip 管理他们工作的组织。 |
| 不限于单一代理。 | 从一个代理开始,逐步发展为具备共享技能、委派和审查功能的团队。 |
| 不仅仅用于代码审查。 | 编程和 PR 审查可与研究、运营、内容和其他工作并行进行。 |
快速开始
开源。自托管。不需要 Paperclip 账户。按照快速入门指南设置你的第一个代理。
只需让你的代理安装 Paperclip。
将安装指南分享给你的代理。
或者自己安装。
需要安装 Node.js 24.11 或更高版本:
npx paperclipai@latest onboard --yes
CLI 从 npm 的缓存中运行;您的实例配置和数据会在本地保留。
请参阅安装指南,了解托管安装、固定版本、金丝雀版本和 git-ref 安装、更新、回滚、服务管理以及卸载。
对于已初始化了 CEO 代理的独立手动测试实例,请使用 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 工作树调用时,test-drive 还会启用在该工作树中执行任务。有关凭据和重用行为,请参见test-drive 指南。
故障排除:私有 npm 注册表
.npmrc如果这在
paperclipai(或类似)上以E404失败,并且你通过全局~/.npmrc使用私有 npm 注册表(例如 GitHub Packages),npx可能会将paperclipai解析到该私有注册表,而不是公共 npm 注册表。诊断:
npm config get registry解决方法(跨平台;强制此命令使用公共 npm 注册表):
npx --registry https://registry.npmjs.org paperclipai@latest onboard --yes
该快速入门路径现在默认使用受信任的本地回环模式,以实现最快的首次运行。要改为以经过身份验证/私有模式启动,请明确选择绑定预设:
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 订阅登录还需要 Python 3 以及 Paperclip 主机上的相应提供者 CLI。Docker 镜像已包含它们。
源代码开发在启用时还会构建本地 Paperclip Runner(默认自托管)。安装 Rust 工具链,或将 PAPERCLIP_RUNNER_BINARY 设置为兼容的预构建 Runner。
常见问题
问:这个项目是有人维护,还是只是敷衍了事?
A: Paperclip 由 Paperclip 团队 维护。我们已经合并了 超过 2,700 个拉取请求。
问:典型的设置是什么样的?
答: 在本地,一个 Node.js 进程管理嵌入式 Postgres 和本地文件存储。在生产环境中,将其指向您自己的 Postgres 并按照您的方式部署。配置项目、代理和目标——代理会处理其余部分。
对于远程访问,请使用带有私有网络绑定(如 Tailscale)的身份验证模式,或者使用 Docker 部署持久化服务器。请参阅 部署模式 和 Docker 指南。
问:我可以经营多家公司吗?
答: 可以。一个部署可以托管多个组织,并对公司范围的数据和访问进行检查。
问:Paperclip 与像 OpenClaw 或 Claude Code 这样的代理有什么不同?
答: Paperclip _使用_那些代理。它将它们组织成一家公司——有组织结构图、预算、目标、治理和问责制。
问:我为什么要使用 Paperclip,而不是直接将我的 OpenClaw 指向 Asana 或 Trello?
答: 代理协调在管理谁拥有待处理工作、如何维护会话、监控成本、建立治理方面有许多细节——Paperclip 会为你处理这些。
(自带工单系统正在开发计划中)
问:代理会持续运行吗?
答: 代理会在有分配的工作和跟进消息时唤醒。可选的定时心跳允许它们定期检查工作;例程按自己的计划创建重复任务。你也可以连接外部运行的代理,例如 OpenClaw。单纯提及不会分配工作或唤醒其他代理。
开发
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 / 爪式代理员工
- ✅ companies.sh - 导入和导出整个组织
- ✅ 简单的 AGENTS.md 配置
- ✅ 技能管理器、技能工作室与技能商店
- ✅ 定时例程
- ✅ 更好的预算管理
- ✅ 代理评审与审批
- ✅ 多人用户
- ✅ 云端 / 沙箱代理(e2b、Cloudflare、Daytona、Modal、Novita、自托管 Kubernetes)
- ✅ 工件与工作成果
- ✅ 深度规划(规划模式、修订计划、计划审批)
- ✅ 强制执行结果(看门狗、恢复操作、审查门)
- ✅ MCP 工具网关与应用(受管工具访问)
- ✅ 拥有每个代理访问权限的保密管理器
- ✅ 活动日志与操作归属
- ✅ 自我修复运行与自动恢复
- ✅ 代理评估与反馈
- ✅ 连接应用
- ✅ 个人与共享 AI 账户
- ✅ 共享代理使用个人 GitHub 身份
- ✅ 技能版本历史与恢复
- ✅ 文档评论与修订历史
- ✅ 公司范围搜索
- ✅ 多模型与多支持团队
- 🟡 记忆 / 知识
- ⚪ MAXIMIZER 模式
- ⚪ 工作队列
- ⚪ 自组织
- ⚪ 自动组织学习
- 🟡 代理聊天
- 🟡 云部署
- ⚪ 桌面应用
- ⚪ 自带工单系统(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/node@10.71.0;它是服务器的可选对等依赖,仅在需要错误监控时安装。浏览器 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 讨论 — 想法和 RFC
许可
麻省理工学院 © 2026 Paperclip Labs, Inc
星标历史
在 MIT 许可证下开源。为那些想要完成工作而不是照看代理的人而建。
- 本文标题:paperclip - 每个人都用来管理工作中代理的开源应用
- 本文链接:https://www.cn121.com/llm/paperclipai-paperclip.html
- 原项目:paperclipai/paperclip 版权归原作者 paperclipai 及贡献者所有
- 收录信息:本站于 2026-10-28 收录本项目,本页所列协议与仓库指标均为收录当时的状态;该日期之后原项目的版本更新与协议变更,本页不作同步。
- 开源协议:收录时本项目采用 MIT(查看 LICENSE 原文),本站转载其原始文档(未改动文字,仅剔除图片与无关章节);使用、修改、分发请以该仓库 LICENSE 原文为准。
- 站点出处:本文首发于 OneTwoOne,收录自 GitHub 开源项目 paperclipai/paperclip。
- 内容说明:本页正文为原项目 README 原文(英文),本站后续会翻译为中文(当前尚未译出,仅将二级标题译为中文,便于按栏目定位;标题原文可在下方原仓库中查看),仅剔除了图片与赞助等无关章节、并把相对链接改为绝对地址;页首简介为机器翻译自仓库描述。
- 引用声明:商业转载、第三方聚合或 AI 检索训练引用时,请务必保留以上来源出处、本文永久链接,以及原项目的版权声明与许可信息。
- 下架通道:若原项目此后变更或收紧了许可协议、或作者/权利人认为本站的收录方式(译文、排版适配、简介翻译等)超出其授权范围,请通过 xyd3302001@163.com 发送下架通知,并附上项目地址与本页链接。本站核实后将第一时间删除本页内容,或改为不复制原文的目录性收录;署名更正等其他要求可一并提出。