Agent之Framework：Paperclip的简介、安装和使用方法、案例应用之详细攻略

Agent之FrameworkPaperclip的简介、安装和使用方法、案例应用之详细攻略目录Paperclip的简介1、特点Paperclip的安装和使用方法1、安装1快速开始2手动安装与本地开发3如果遇到私有 npm 源问题2、使用方法1核心步骤2运行时与执行方式3日常运行方式Paperclip的案例应用1搭建“自治 AI 公司”2协调多个不同类型的代理3监控成本并防止失控消耗4让代理 24/7 运行但仍可审计与接管5把重复性工作交给定时心跳处理6把“想法”变成持续推进的工作流7适合移动端随时监控业务8适合从一个具体目标出发搭公司Paperclip的简介Paperclip 的定位是 “给工作中的 AI agents 用的应用”它是一个开源的编排平台用来管理一组协同工作的 AI 代理。README 直接说明它是一个 Node.js server React UI用于 orchestrate 一支 AI agents 团队来“运营一家业务”核心不是单个聊天机器人而是把多个代理组织成一个可管理的体系。在产品定义里Paperclip 被明确描述为 autonomous AI companies 的 control plane。也就是说它不是在做一个通用聊天应用也不是在替代 Jira 或代码评审工具而是把“公司”作为组织单位把目标、组织架构、预算、审批、任务层级、心跳执行和治理放在同一个控制面里管理。仓库 README 还用一句很直白的话概括它的角色“If OpenClaw is an employee, Paperclip is the company.” 也就是说像 OpenClaw、Claude Code、Codex、Cursor、Bash、HTTP 这类代理或运行方式可以被 Paperclip 统一接入并编排。Github地址GitHub - paperclipai/paperclip: The open-source app everyone uses to manage agents at work · GitHub1、特点领域核心说明组织架构以 “公司”为第一组织单元。一个 Paperclip 实例可运行多个公司公司下设目标、员工、组织结构、收入与支出、任务层级所有工作均需追溯至公司总目标。运行时兼容支持 “自带代理”不强绑定运行时。支持 OpenClaw bots、Python 脚本、Node 脚本、Claude Code sessions、Codex instances 等只要运行体“可被调用、可被观察、可被授权”即可被 Paperclip 协调。任务管理任务层级化所有工作回归目标。每个任务必须追溯至上级任务并最终关联公司总目标确保 AI 代理始终明确“我为什么在做这件事”。调度机制内置 心跳Heartbeat机制。代理按计划“醒来”检查工作并执行动作后退出同时支持事件触发如任务分配或 提及。成本控制内置预算限制。可为每个代理设置月度预算达到上限后自动停止有效避免 Runaway Costs。多租户隔离支持 多公司隔离。单个部署可运行多家公司且数据完全隔离所有实体均作用于 Company 范围内。可观测性可审计、可追踪。通过 Ticket System 实现每次对话追踪、每个决策可解释并提供完整的 Tool-Call Tracing 和 不可变审计日志Immutable Audit Log。权限治理支持 治理与审批。支持董事会级Board-level治理可审批招聘、覆盖策略、暂停或终止任一代理避免代理“随意运行”。角色体系组织结构清晰。具备组织架构图Org Chart代理拥有“上级Boss”、“头衔Title”和“职位描述Job Description”适配 CEO、CTO、工程师、市场、财务等层级化组织。部署模式本地优先、云端兼容。典型本地部署为单个 Node.js 进程管理 Embedded Postgres 和本地文件存储生产环境可对接自有 Postgres并支持 local_trusted 和 authenticated 两种运行模式。产品定位非聊天工具非代码审查器。其目标不是替代协作工具而是编排团队工作明确排除 Chatbot、单智能体工具或 Code Review Tool 的定位。Paperclip的安装和使用方法1、安装1快速开始README 的 Quickstart 非常直接npx paperclipai onboard --yes官方说明这是开源、自托管、无需 Paperclip 账号的启动方式。默认会走 trusted local loopback mode以便快速完成第一次运行。如果你想显式进入其他绑定模式README 提供了npx paperclipai onboard --yes --bind lan npx paperclipai onboard --yes --bind tailnet它还说明如果你已经配置过 Paperclip再次运行 onboard 会保留原有配置想改设置则使用 paperclipai configure。2手动安装与本地开发如果你更愿意直接跑源码README 给出的方式是git clone https://github.com/paperclipai/paperclip.git cd paperclip pnpm install pnpm dev这样会启动 API server默认地址是 http://localhost:3100并且 embedded PostgreSQL 会自动创建不需要额外数据库初始化。仓库还明确列出最低要求Node.js 20、pnpm 9.15。3如果遇到私有 npm 源问题README 给了一个很实用的排障说明如果你使用了 private npm registrynpx 可能会把 paperclipai 解析到私有源而报 E404。官方给出的规避方式是强制使用公共 npm registry例如npx --registry https://registry.npmjs.org paperclipai onboard --yes2、使用方法1核心步骤从产品定义里的 “Dream Scenario” 看Paperclip 的典型使用流程是先创建 company再定义 company goal然后创建 CEO接着配置 CEO 的下属如 CTO、CMO、CFO再继续往下定义工程、市场等团队最后设置预算和初始战略任务点击启动后让代理按心跳开始执行。README 也把这一使用路径概括得很清楚你可以“Bring your own agentsassign goalstrack work and costs from one dashboard”。也就是说使用时重点不是写提示词而是把代理、目标、预算和治理放到同一个面板里管理。2运行时与执行方式产品文档说明Paperclip 支持几种运行代理心跳的方式本地 CLI/session adapter、运行命令、发 webhook/API 请求给外部运行的代理以及通过插件/adapter 加载外部运行时。也就是说它既可以协调本地工具也可以协调远端 agent。3日常运行方式README 说明代理默认按 scheduled heartbeats 和 event-based triggers 工作比如任务分配或 -mentions如果你接入了像 OpenClaw 这样的连续代理也可以让 Paperclip 统一协调。Paperclip的案例应用1搭建“自治 AI 公司”README 直接把目标场景定义为你想构建 autonomous AI companies并且由多个代理协同完成公司级目标。这个场景下Paperclip 负责公司结构、组织关系、目标拆解、预算和审批代理负责具体执行。2协调多个不同类型的代理README 举例说明它可以协调 OpenClaw、Codex、Claude、Cursor 等多个代理朝同一个目标工作对于同时开着很多 Claude Code 终端、已经分不清谁在做什么的情况它尤其合适。3监控成本并防止失控消耗README 直接把“监控成本和强制预算”列为适用场景之一。产品定义里也有 monthly budgets per agent 和 stop-at-limit 的机制因此适合 token 成本敏感、需要预算管控的项目。4让代理 24/7 运行但仍可审计与接管README 写到你可以让代理自治运行 24/7但仍然希望在需要时审计工作、插手或叫停。这正是 Paperclip 的治理与审计能力要解决的问题。5把重复性工作交给定时心跳处理FAQ 说明代理默认会通过 scheduled heartbeats 和事件触发来运行因此像客服、社媒发布、定期报告这类周期性任务可以由代理自动处理不必每次手动启动。6把“想法”变成持续推进的工作流README 里有一个很典型的对比过去你得找到 repo、打开 Claude Code、盯着它做在 Paperclip 里你只需要添加任务编码代理就会一直工作到任务完成管理层再审查结果。7适合移动端随时监控业务README 把 “You want to manage your autonomous businesses from your phone” 列为适合人群之一说明它适合远程管理、随时查看目标、预算和代理执行状态。8适合从一个具体目标出发搭公司产品定义中的示例非常清晰目标可以是“在 3 个月内做出 $1M MRR 的 AI note-taking app”然后再围绕这个目标设置 CEO、下属团队、预算与任务层级。这个例子很好地体现了 Paperclip 的“公司级代理编排”思路。