PaperclipAI

Paperclip：面向 AI 代理团队的编排平台

Paperclip 是一个开源的 AI 代理编排系统，采用 Node.js 服务端与 React 前端的架构。它把 AI 代理组织成"公司"来运作：自带组织架构、预算控制、治理流程与目标对齐机制，让用户从统一的仪表盘管理代理团队的任务、技能、权限与历史记录。用户可以接入任意代理、任意运行时，并为每个代理单独选择模型与执行环境（harness）。

核心定位

如果说 OpenClaw 是一名"员工"，Paperclip 就是一家"公司"。Paperclip 不规定如何构建代理，而是负责组织由代理组成的公司如何运转——包括任务派发、上下文传递、跨代理协作、成本管控与可审计性。

四大支柱

关键能力

• 自带代理：兼容 Claude Code、Codex、Cursor、Gemini CLI、OpenCode、Pi、Hermes、Grok、Kimi Code 等，只要能接收心跳即可接入。
• 目标对齐：任务向上关联项目与公司目标，代理执行时能看到"为什么做"，而不仅是标题。
• 心跳执行：数据库支持的去重唤醒机制，按预算、工作区与技能注入触发代理。
• 成本控制：按公司、代理、项目粒度追踪开销，配置阈值告警与硬性停止。
• 多组织部署：单一部署可托管多个独立组织，数据与访问严格隔离。
• 任务线程：对话、计划、阻塞、文件、运行历史与任务绑定，支持分配给代理或人。
• 治理与审批：审批流、执行策略、预算熔断、代理暂停/恢复/终止、配置变更可回滚。
• 定时例程：cron、webhook、API 触发，可设置并发与补跑策略。
• 技能与插件：技能版本化、可评测、可回滚；插件支持进程外扩展、定时任务与 UI 贡献。
• 可移植性：导出/导入组织包（代理、技能、可选项目/任务/附件），密钥值会被剥离。

快速开始

需要 Node.js 24.11 及以上版本。最简方式：

# 一键初始化并启动（默认本地受信回环模式）
npx paperclipai@latest onboard --yes

# 试用模式：前台启动临时实例，不安装服务、不创建首任务
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

也可手动安装：

git clone https://github.com/paperclipai/paperclip.git
cd paperclip
pnpm install
pnpm dev   # 同时运行 UI 与 API，监听 http://localhost:3100

启动后会自动创建内嵌的 PostgreSQL 数据库，无需额外配置。

若需以认证方式启动，可显式指定绑定预设：

npx paperclipai@latest onboard --yes --bind lan     # 局域网模式
npx paperclipai@latest onboard --yes --bind tailnet # Tailscale 模式

若公司内网使用了私有 npm 镜像（如 GitHub Packages），并导致 paperclipai 解析失败，可强制走公共镜像：

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

开发命令

pnpm dev          # 全量开发（API + UI，watch 模式）
pnpm dev:once     # 全量开发，不监听文件变化
pnpm dev:server   # 仅启动服务
pnpm dev:mobile   # :3101 提供预构建 UI，转发 /api 到 :3100，便于手机/平板访问
pnpm dev:both     # 同时运行 dev 与 dev:mobile
pnpm build        # 构建全部产物
pnpm typecheck    # 类型检查
pnpm test         # 跑 Vitest 单测（默认不包含 Playwright）
pnpm test:watch   # Vitest watch 模式
pnpm test:e2e     # Playwright 浏览器端到端测试
pnpm db:generate  # 生成数据库迁移
pnpm db:migrate   # 应用迁移

完整开发指南见 doc/DEVELOPING.md。源码构建在默认启用自托管 Runner 时需要安装 Rust 工具链，也可通过环境变量 PAPERCLIP_RUNNER_BINARY 指定预编译产物。