Node.js + React的开源多Agent编排平台,支持OpenClaw/Claude Code/Cursor等Agent协同工作,提供组织架构、预算、目标对齐等企业级管理能力。

Quickstart · Docs · GitHub · Discord · Twitter · Website
如果把 OpenClaw 比作一名员工,那 Paperclip 就是一整家公司。
Paperclip 是一个 Node.js 服务端 + React 前端,用于编排一组 AI Agent 来运营一家企业。带上你自己的 Agent,分配目标,在统一的 dashboard 里追踪工作进度和成本。
它看起来像一个任务管理器,但其底层是:组织架构、预算、治理机制、目标对齐和 Agent 协调。
管业务目标,而不是管 pull requests。
能接收心跳,就能被雇佣。
如果你是这样的人,Paperclip 适合你:
✅ 你想构建自主运营的 AI 公司
✅ 你需要协调多个不同的 Agent(OpenClaw、Codex、Claude、Cursor)向同一个目标迈进
✅ 你同时开着 20 个 Claude Code 终端,已经分不清每个人在干什么
✅ 你希望 Agent 7×24 小时自主运行,但仍然想审计工作进展、在需要时介入
✅ 你想监控成本并强制执行预算
✅ 你希望管理 Agent 的流程像使用任务管理器一样简单
✅ 你想用手机管理你的自主业务
AI Agent 组织要真正产出成果,四件事必须同时做好:任务、组织、训练和基础设施。Paperclip 正是围绕这四大支柱构建的。
🔌 带上你自己的 Agent
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 │
└───────────┘ └───────────┘ └───────────┘ └───────────┘
两种部署模式(可信本地模式或认证模式)、董事会用户、Agent API key、短期运行 JWT、公司成员资格、邀请流程和 OpenClaw 入职引导。每个变更请求都会追溯到具体操作者。
Agent 有角色、职位、汇报线、权限和预算。适配器示例与图中对应:Claude Code、Codex、CLI 类 Agent(如 Cursor/Gemini/bash)、HTTP/webhook 机器人(如 OpenClaw),以及外部适配器插件。能接收心跳,就能被雇佣。
Issue 携带公司/项目/目标/父级链接、原子级检出与执行锁、一级 blocker 依赖、评论、文档、附件、工作产出物、标签和收件箱状态。不重复工作,不丢失上下文。
基于数据库的唤醒队列,支持合并、预算检查、工作区解析、secret 注入、技能加载和适配器调用。运行产生结构化日志、成本事件、会话状态和审计追踪。自动处理孤立运行的恢复。
项目工作区、隔离执行工作区(git worktree、operator 分支)和运行时服务(开发服务器、预览 URL)。Agent 每次都在正确的目录和正确的上下文中工作。
董事会审批工作流、带审核/审批阶段的执行策略、决策追踪、预算硬性停止、Agent 暂停/恢复/终止,以及完整的审计日志。没有你的签字,任何东西都不能发布。
按公司、Agent、项目、目标、Issue、提供商和模型追踪 token 和成本。作用域预算策略带有警告阈值和硬性停止。超支自动暂停 Agent 并取消排队中的工作。
支持 cron、webhook 和 API 触发的周期性任务。并发和补跑策略。每次例行执行都会创建一条追踪 Issue 并唤醒被分配的 Agent——无需手动触发。
实例级插件系统,支持进程外 worker、能力限制的主机服务、任务调度、工具暴露和 UI 贡献。无需 fork 即可扩展 Paperclip。
实例级和公司级 secret、加密本地存储、提供商支持的对象存储、附件和工作产出物。敏感值不会出现在 prompt 中,除非某个作用域运行明确需要。
变更操作、心跳状态变更、成本事件、审批、评论和工作产出物都被记录为持久化活动,供运维人员审计发生了什么以及为什么。
导出和导入整个组织——Agent、技能、项目、例程和 Issue——并处理 secret 脱敏和冲突处理。一个部署,多家公司,完全的数据隔离。
开源。自托管。无需 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-pinned 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 可能会从该私有 registry 而非公共 npm registry 解析 paperclipai。
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 并以你喜欢的方式部署。配置好项目、Agent 和目标——Agent 会处理剩下的工作。
如果你是独立创业者,可以用 Tailscale 在外出时访问 Paperclip。之后当需要时可以部署到 Vercel 等平台。
我可以运行多个公司吗? 可以。单个部署可以运行无限数量的公司,且数据完全隔离。
Paperclip 和 OpenClaw 或 Claude Code 这样的 Agent 有什么不同? Paperclip 使用这些 Agent。它将它们编排成一家公司——包含组织架构、预算、目标、治理和问责制。
为什么我要用 Paperclip,而不是把我的 OpenClaw 指向 Asana 或 Trello? Agent 编排有很多微妙之处:如何协调谁检出了工作、如何维护会话、如何监控成本、如何建立治理——Paperclip 为你处理这些。
(自带工单系统已列入路线图)
Agent 是持续运行的吗? 默认情况下,Agent 按预定的心跳和基于事件的触发器运行(任务分配、@-提及)。你也可以接入 OpenClaw 这样的持续运行型 Agent。你带上你的 Agent,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 风格 Agent 作为员工
✅ companies.sh——导入导出整个组织
✅ 简易 AGENTS.md 配置
✅ 技能管理器、技能工作室和技能商店
✅ Agent 评审和审批
✅ 多人类用户
✅ 云/沙盒 Agent(e2b、Cloudflare、Daytona、Modal、Novita、自托管 Kubernetes)
✅ 产出物和工作产品
✅ 深度规划(规划模式、版本化计划、计划审批)
✅ 强制执行结果(看门狗、恢复操作、审核门禁)
✅ MCP Tool Gateway 和应用(受治理的工具访问)
✅ 带按 Agent 访问控制的 Secrets 管理器
✅ 活动日志和操作归因
✅ 自愈运行和自动恢复
✅ Agent 评估和反馈
⚪ 自动组织学习
🟡 云部署(多租户隔离和公司导入/导出已发布)
🟡 自带工单系统(Asana / Linear / Jira 作为入口)
🟡 连接应用(一键集成,例如 Vercel)
这是简短路线图预览。完整路线图请参阅 ROADMAP.md。
在 awesome-paperclip 找到更多插件。
Paperclip 附带了可选的 OpenTelemetry 自动插桩(仅追踪)。当设置 OTEL_EXPORTER_OTLP_ENDPOINT 时激活,支持通过标准 OTEL_EXPORTER_OTLP_PROTOCOL 环境变量配置 grpc、http/protobuf 和 http/json。@opentelemetry/* 包是可选的 peer 依赖——只有在你需要追踪时才安装它们。安装命令和完整环境变量参考请参阅 doc/observability.md。
Paperclip 收集匿名使用遥测数据,以帮助我们了解产品如何使用并加以改进。不会收集任何个人信息、Issue 内容、prompt、文件路径或 secret。私有仓库引用在发送前会用每安装实例独立的 salt 做哈希处理。
贡献者修改发出的遥测事件应遵循遥测数据合约。对于尚未在生成合约中的拟议第一方事件,请遵循遥测工作流程。
遥测默认启用,可以通过以下方式禁用:
我们欢迎贡献。详情参阅贡献指南。
Discord — 加入社区
Twitter / X — 关注更新和公告
GitHub Issues — bug 和功能请求
GitHub Discussions — 创意和 RFC
MIT © 2026 Paperclip Labs, Inc
MIT 开源。为想把事情做完的人打造,不是为了当 Agent 的保姆。