2026 年 9 月 26 日的 GitHub 趋势日榜上,paperclipai/paperclip 当日 +2,589★,排在当日第一。仓库元数据(GitHub API 取数时间 2026-09-26 21:31 CST):86,105★、15,323 fork、425 watcher、5,736 条 open 待办(口径见下)、TypeScript、MIT 协议、2026-03-02 建仓、取数当天最后一笔 push 17:36 CST。npm 侧的包名是 paperclipai,自 2026-03-03 上线以来发了 1,582 个版本,最近 30 天(2026-08-26 至 2026-09-24)下载 93,389 次。

两组数字放在一起看,能说清它是怎么回事:

  • 六个半月长到 8.6 万星。同一个榜单上,同期最猛的开源个人 AI 助手 OpenClaw 是 39 万星(建仓于 2025-11-24),Paperclip 的曲线没有被它压住。
  • 它不是“再做一个 Agent”,而是给一堆已有 Agent 加一层公司级的控制面。README 自己写了一句话概括:「如果 OpenClaw 是一名员工,Paperclip 就是那家公司」。

一句话定位:它管 Agent 的组织,不管 Agent 的脑子

它的形态是 Node.js 服务 + React 前端,官方把使用流程压成三步:

步骤做什么README 里的例子
01定义目标「做出第 1 款 AI 笔记应用,做到 100 万美元 MRR」
02招聘团队CEO、CTO、工程师、设计师、市场——任何 bot、任何厂商
03审批并运行看策略、设预算、点开始,之后在仪表盘上盯

接入方式对现有 Agent 完全开放:Claude Code、Codex、Cursor、Gemini CLI 这类命令行 Agent,以及 bash 脚本和 HTTP / webhook 机器人(OpenClaw 属于这一类)都能挂进来。官方那句招聘标准很形象——「只要能收到心跳,就能入职」。

它同时划了六条边界,把“我不是什么”说得比“我是什么”更清楚:不是聊天机器人(Agent 有岗位,没有聊天窗)、不是 Agent 框架(不教你怎么造 Agent)、不是工作流拖拽器(没有拖拽式流水线)、不是提示词管理器(提示词、模型、运行时都是你自己带)、不是代码评审工具,而且直接劝退:如果你只有一个 Agent,你大概不需要它。

四个支柱:它把“公司”拆成了哪四块

README 用一张表交代了它的世界观——一个 Agent 组织要真正出活,得有四件事同时成立:

支柱面向谁覆盖什么
Agent 任务管理器所有人,每天用工单、审批与评审闸、主动干活的 Agent 同事、可审计的例行流程,以及“用 diff、截图、测试来验收”
Agent 组织架构管理者人与 Agent 混编的架构、职责与授权、治理(谁能做什么)、带作用域的密钥与公司边界
Agent 员工培训使能者Skill Studio 与全公司共享技能、评测与可复跑的测试、主动学习闭环、给 Agent 做绩效复盘
Agentic OSIT 与平台跨厂商运行时、沙箱与 MCP、SSO / RBAC / 成本控制、数据隐私与内部链路追踪

12 个控制面模块:哪些是“能落地”的部分

README 把服务端拆成 12 块,这是判断它是否可靠的关键——如果只是张组织架构图,这个项目撑不到 8.6 万星。逐个看:

  • 身份与访问:两套运行模式(免登录的可信本地 / 需认证的多人),agent API key、短期 run token、公司成员与邀请流程,每个写操作都能追到具体是谁。
  • 组织架构与 Agent:角色、头衔、汇报线、权限、预算,适配器覆盖 Claude Code / Codex / Cursor / Gemini CLI / bash / HTTP webhook,以及第三方适配器插件。
  • 任务系统:工单带公司 / 项目 / 目标 / 父级链接;原子 checkout 加执行锁,阻塞依赖是一等公民;评论、文档、附件、产出物、标签、收件箱状态齐全。
  • 心跳执行:数据库支撑的唤醒队列,做唤醒合并、预算检查、工作区解析、密钥注入、技能加载、适配器调用;每次运行留下结构化日志、成本事件、会话状态和审计轨迹,孤儿运行会自动恢复。
  • 工作区与运行时:项目工作区、隔离执行区(git worktree、operator 分支)、运行时服务(开发服务器、预览 URL),让 Agent 每次都在对的目录、带着对的上下文干活。
  • 治理与审批:董事会审批流、带评审阶段的执行策略、决策记录、预算硬停、暂停 / 恢复 / 终止任意 Agent,以及完整审计日志。
  • 预算与成本:按公司、Agent、项目、目标、工单、厂商、模型七个维度统计 token 与花费;带阈值告警和硬停,超支会自动暂停 Agent 并取消排队中的工作。
  • 例行任务与调度:支持 cron、webhook、API 三种触发器,有并发与追赶策略;每次执行都生成一张可追踪的工单并唤醒对应 Agent,不用人手动点火——这一点对拿它做内容排期、客服值守的人是最实用的。
  • 插件:实例级插件系统,带进程外 worker、能力门控的主机服务、任务调度、工具暴露和 UI 扩展,不改核心就能加东西。
  • 密钥与存储:实例级与公司级密钥、加密的本地存储、可接对象存储的附件与产出物;敏感值只在被明确授权的那一次运行里进入提示词。
  • 活动与事件:写操作、心跳状态变化、成本事件、审批、评论、产出物都记成持久活动流。
  • 公司可搬迁:整家公司(Agent、技能、项目、例行任务、工单)可导出导入,导出时做密钥擦洗与冲突处理;一个部署跑多家公司,数据与审计各自隔离。

仓库里还带着 skills/(paperclip-board、paperclip-create-agent、para-memory-files、slack、agentmail 等)和 evals/(含 promptfoo 评测目录),说明技能与评测不是宣传词,是有具体目录的。

怎么用起来:四条路径,从“不装东西试一下”到“跑成服务”

路径一,零安装试用。 官方留了一条不落地任何东西的路:一行 npx 起一个已经初始化好 CEO Agent 的隔离实例,前台运行、不装服务、不建首个任务,启动后才开浏览器。适合先看一眼界面再决定要不要装:

1
2

ANTHROPIC_API_KEY=... npx paperclipai test-drive
OPENAI_API_KEY=... npx paperclipai test-drive --harness codex

不带 --data-dir 时每次都会新建一个唯一临时目录,绝对路径会在启动时打印出来;想复用它就传 --data-dir,不想自动开浏览器就加 --no-browser。

路径二,正式安装。 官方安装脚本会确保机器上有 Node.js 24.11 或更新版本,把受管 CLI 装到 ~/.paperclip/cli,再进入交互式引导;在支持的 Linux 与 macOS 上还能顺手装成后台服务:

1
2
3

curl -fsSLO https://paperclip.ing/install.sh
curl -fsSLO https://paperclip.ing/install.sh.sha256
sha256sum -c install.sh.sha256 && bash install.sh

想非交互安装,用 bash -s -- --no-prompt --no-onboard 之后再 paperclipai onboard --yes。默认绑定是“可信本地回环”,要换成需认证的模式要显式选 --bind lan 或 --bind tailnet。

路径三,Docker。 仓库根有 Dockerfile,doc/DOCKER.md 的第一句就是「不装 Node 或 pnpm 本地依赖,直接在 Docker 里跑 Paperclip」。镜像里预装了 git、gh、curl、wget、ripgrep、python3,以及 Claude、Codex、OpenCode 三个 CLI;本地构建设置 USER_UID / USER_GID 以匹配宿主机用户,避免挂载目录权限错乱。官方仓库也发布标准镜像 ghcr.io/paperclipai/paperclip:sha-<完整SHA>,并带 GitHub / Sigstore 的 attestation;docker/ 目录下还有 docker-compose.quickstart.yml 与 docker-compose.untrusted-review.yml 两个编排文件。

路径四,源码。 git clone 之后 pnpm install && pnpm dev,API 起在 http://localhost:3100,内嵌的 PostgreSQL 会自动创建,不需要额外配置数据库。硬性要求写在 README 里:Node.js 24.11+、pnpm 9.15+。生产部署则建议换成你自己的 Postgres 和部署方式。文档里还有一份部署模式说明(doc/DEPLOYMENT-MODES.md,落款 2026-02-23):运行模式分免登录的 local_trusted 与需认证的 authenticated,后者再分 private / public;可达性单独控制,取值是 loopback | lan | tailnet | custom。打算把控制台放到公网的人,先把这份文档读完再动手。

三点得自己看清楚

  • 安装脚本的校验和与脚本同源。 官方自己在 README 里写明了:校验和能发现传输或发布失误,但它和脚本从同一个源提供;要真正独立的来源,得用 release tag 或 commit 固定到 GitHub 副本。这不是缺陷,是一句少见的实话——但意味着“跑了 sha256sum -c”不等于供应链已验证。
  • 遥测默认开着。 官方称收集的是匿名使用数据,不收集个人信息、工单内容、提示词、文件路径和密钥,私有仓库引用会加每安装唯一的盐做哈希;关闭方式有四种:环境变量 PAPERCLIP_TELEMETRY_DISABLED=1、通行约定 DO_NOT_TRACK=1、CI=true 自动关、配置文件里写 telemetry.enabled: false。对数据敏感的人,第一件事就是把它关掉。
  • 待办池很大,roadmap 还有整块空着。 GitHub 元数据里的 open_issues_count = 5,736,拆开是 2,436 个 open issue + 3,300 个待合 PR;另外已关闭 issue 904 个、已关闭 PR 7,250 个,取数当天一笔提交对应的 PR 编号已经排到 #14095,而建仓只有六个半月。roadmap 里尚未完成的整块功能包括 Memory / Knowledge、Work Queues、Self-Organization、CEO Chat、桌面端、自带工单系统(Asana / Linear / Jira 接入)和一键集成。换句话说:组织与成本这套骨架是齐的,长期记忆和知识库还没轮到。

和同类比,它占的是哪一格

方案管的东西谁定方向关键差别
直接用单个编码 Agent(Claude Code / Codex)一次会话、一个仓库你,一句话一句话没有工单、预算、审计,会话一关上下文就断
Agent 框架怎么把 Agent 造出来你写代码给的是零件,组织与治理要自己搭
任务工具(Trello / Asana)+ 定时脚本人看的看板人任务与执行是两张皮,没有原子 checkout,也没有预算硬停
Paperclip一群 Agent 组成的组织你,定目标与预算心跳排班、原子执行锁、成本硬停、审批与审计是一套内建能力

站内此前介绍过的 Agent 侧项目可以对照看:管“怎么把软件接给 Agent”的 CLI-Anything,以及管“Agent 记忆怎么分层”的 TencentDB Agent Memory——Paperclip 恰好把记忆留在 roadmap 未完成区,两者的分工边界很清楚。想先看一个人怎么用定时任务给 Agent 排班的,可以读 Hermes 工作流那篇,那是“轻量做法”,Paperclip 是“重做法”。

我的判断:谁该上,谁再等等,谁别碰

该上的三类人:

  1. 同时开着五个以上 Agent 会话、已经开始记不清谁在干什么的人。README 里那条“20 个 Claude Code 终端开着,重启就全丢”写的就是这个场景,它的工单化 + 会话持久化是直接对着这个痛点设计的。
  2. 把 Agent 当员工排班用的人。内容、客服、报表这类周期性工作,用 cron / webhook / API 三种触发器加并发策略排出去,每次执行自动生成工单并唤醒 Agent——这套“排班 + 留痕”对一个人做副业、需要回头对账的人价值最大。
  3. 需要给别人看账单和审计的人。按七个维度统计成本、带阈值告警与硬停、每个写操作可追到人,这三点是“敢让 Agent 自己跑”的前提。

再等等的:只有一个 Agent 的人(官方也这么劝);还没想清楚密钥与网络边界的人——先读那份部署模式文档,内部密钥要不要交给这一层,不是它能替你决定的事;以及手上机器和习惯都不满足 Node 24.11+ 或 Docker 前提的人。

别碰的:把“零人工公司”当成被动收入的人。它管的是流程、预算和验收,方向和选题还是人的活;指望它替你省下模型花费的人也别指望——预算硬停是止损开关,不是省钱开关。至于生产环境,建议等到内置记忆与工作队列这两个未完成项落地再评估,现在它更像一套“骨架已经立住、还在快速长肉”的控制面。

一句话收口:它是被给了一堆 Agent 之后才会显价值的工具——你手上 Agent 越多、越需要有人替你记账和踩刹车,它越值;反过来,只有一个 Agent 的话,它只会变成你的第二份工作。

顺带一提:一群 Agent 同时开跑,键盘声和通知声也一起来了——把世界关掉这件事,降噪耳机怎么选从头戴与入耳讲到 ANC 与通透。

本文由拾光札记编辑部整理,勘误请联系我们。