让Claude code界面化的超好用工具：图文并茂教你用Paperclip建个AI团队 | Paperclip使用完全指南

tangdou369098655
0 阅读6分钟

让Claude code界面化的超好用工具：图文并茂教你用Paperclip建个AI团队 | Paperclip使用完全指南

宝宝们又来看我啦~👋 今天分享一个超酷的工具——Paperclip！📋

📌 项目信息

🎯 Paperclip是干嘛的？

Paperclip是个Node.js服务+网页界面，专门用来管理一帮AI协同工作。

主要能做什么：

  • 搭配你自己的AI（OpenClaw、Claude Code、Cursor都行）
  • 给它们分配任务和目标
  • 在一个仪表板里看工作进度和花费

看起来像任务管理工具，但底下其实有完整的公司架构：组织架构图、预算、目标对齐、代理协调这些。

一句话：管理业务目标，不是盯着一堆PR！ ✨

🤔 你需要Paperclip吗？

  • ✅ 想做个全自动的AI公司
  • ✅ 手头一堆AI代理（OpenClaw、Claude、Cursor）想协调起来
  • ✅ 同时开20个Claude Code终端，搞得晕头转向
  • ✅ 希望AI 24/7自动干活，但需要时还能干预
  • ✅ 想盯着成本，设个预算上限
  • ✅ 想有个像任务管理器一样管理AI的界面
  • ✅对，想手机上用也能管

🌟 核心功能

功能说明
🔌 配合自己的AI什么工具都行，只要能接"心跳"就能上岗
🎯 目标对齐每个任务都连着公司目标，AI知道做啥为啥
💓 心跳机制代理按时醒来干活，任务在组织里上下流转
💰 成本控制给每个代理设月预算，超了就停，防止翻车
🏢 多公司一套服务管N家公司，数据完全隔开
🎫 工单系统每个对话都能追溯，每个决定都有记录
🛡️ 治理功能你是老板，审批、暂停、踢人随时来
📊 组织架构有层级有角色，AI也有老板有头衔有JD
📱 移动端去哪儿都能看

🆚 用vs不用

没用Paperclip用了Paperclip
开一堆终端，关了就没了任务持久化，对话线程化
到处找上下文喂AI目标自动往下传，AI知道在干啥
配置文件乱七八糟组织架构、工单、治理一站式搞定
循环跑飞了几百刀预算监控，超了自动停
定时任务老忘开心跳自动处理，你看着就行
有想法得自己开终端丢个任务给AI，它干完告诉你

🔌 兼容哪些代理？

平台说明
🦞 OpenClaw全功能AI员工
🤖 Claude CodeAnthropic的代码助手
🧩 CodexGitHub的AI编程助手
💻 CursorAI代码编辑器
💻 Bash命令行脚本代理
🌐 HTTPHTTP代理

能接收心跳的都能入职！ 💼

🛠️ 安装教程

第一步：准备环境

需要：

  • Node.js 20+
  • pnpm 9.15+

检查一下：

node --version
npm --version

没装pnpm的话：

npm install -g pnpm

image

国内用户记得换镜像源：

pnpm config set registry https://registry.npmmirror.com

第二步：安装Paperclip

方法一：一键搞定（推荐）

npx paperclipai onboard --yes

这条命令自动完成下载、安装、配置、启动。

方法二：手动装

git clone https://github.com/paperclipai/paperclip.git
cd paperclip
pnpm install
pnpm dev

启动后访问 http://localhost:3100 image

第三步：Docker安装（如果已经安装成功，请跳过这一步）

不想装Node.js？用Docker：

docker build -t paperclip-local .
docker run --name paperclip \
  -p 3100:3100 \
  -e HOST=0.0.0.0 \
  -e PAPERCLIP_HOME=/paperclip \
  -v "$(pwd)/data/docker-paperclip:/paperclip" \
  paperclip-local

或者用Docker Compose：

docker compose -f docker-compose.quickstart.yml up --build

💾 数据存哪？

本地开发自动存这些地方：

  • 数据库：~/.paperclip/instances/default/db
  • 文件：~/.paperclip/instances/default/data/storage
  • 工作空间：~/.paperclip/instances/default/workspaces/<agent-id>

🎮 怎么用？

创建公司

  1. 点"创建新公司"
  2. 填名字和描述
  3. 定目标 image

加代理

  1. 点"添加代理"
  2. 选类型（OpenClaw、Claude Code之类的）
  3. 配密钥、模型这些
  4. 分配角色权限 image

建任务

  1. 创建项目，定目标
  2. 建任务，分给AI
  3. 设预算，控制成本
  4. 启动，让它干活 image image

看进度

仪表板里实时看进度、审批决策、查成本、管权限。 image

其他内容

如果想要有更多使用了解，可以参考我的另一篇文章图文并茂教你快速上手Paperclip+Claude code并解决使用中的各种问题，可以供大家参考，文章概览如下：

  1. 如何去掉Inbox的小图标数字 - 解决方案
  2. 如何查看你的组织架构，修改组织架构 - 查看组织架构 - 修改组织架构 - Agent 团队配置与中文化设置
    • Agent 重命名
    • 新增 Agent
    • 信息完善
    • 中文化偏好设置
  3. 如何查看你的agent正在干什么 - 解决方案
  4. 创建的agent第二天起来莫名其妙丢失了怎么办 - 解决方案（创建新Agent指挥恢复数据）
  5. 丢失Agent恢复处理报告 - 问题描述 - 处理步骤
    • 检查现有Agent状态
    • 检查本地配置文件
    • 恢复Agent
    • 完成任务 - 结果
  6. Paperclip本地适配器问题 - PAPERCLIP_API_KEY未自动注入的解决方案
  7. Claude run failed错误 - max_tokens参数无效的解决方案

📋 常用命令

# 启动服务
pnpm dev

# 健康检查
curl http://localhost:3100/api/health

# 看公司列表
curl http://localhost:3100/api/companies

# 建任务
pnpm paperclipai issue create --company-id <company-id> --title "任务标题"

# 看任务
pnpm paperclipai issue list --company-id <company-id>

# 备份数据库
pnpm paperclipai db:backup

# 设置默认上下文
pnpm paperclipai context set --api-base http://localhost:3100 --company-id <company-id>

开发时还能用这些：

pnpm dev:once      # 一次性启动不监听文件
pnpm dev:server     # 只启动API服务
pnpm build          # 编译
pnpm test:run       # 跑测试

❓ 常见问题

典型配置啥样？

本地就一个Node.js进程管着嵌入式Postgres和文件存储。生产环境可以连你自己的Postgres，随便部署。个人创业者可以用Tailscale随时访问，需要时再上Vercel。

能跑多个公司不？

能，一个部署跑N个公司，数据完全隔离。

跟OpenClaw、Claude Code啥区别？

Paperclip是管它们的，把这些AI编排成一个真正的公司 — 有架构图、预算、目标、治理、责任划分。

为啥不直接让OpenClaw连Asana/Trello？

代理编排有好多细节要处理：谁在做任务、怎么维护会话、成本怎么监控、治理怎么建 — Paperclip都替你弄了。

代理是不是一直跑？

默认按心跳和事件触发（任务分配、@提及）运行。也能挂接OpenClaw这种持续型代理。你带代理来，Paperclip负责协调。

🚨 排坑

端口被占

# 查看占用的进程
lsof -i :3100

# 换个端口
export PORT=3200
pnpm dev

数据库连不上

# 删了重建
rm -rf ~/.paperclip/instances/default/db
pnpm dev

依赖装不上

# 换镜像
pnpm config set registry https://registry.npmmirror.com
pnpm install

💖 结语

今天就写到这里啦~ 小伙伴们，我们明天再见！👋

欢迎大家指出问题，一起进步~ (￣ω￣(￣ω￣〃 (￣ω￣〃)ゝ

image

avatar
文章
阅读
粉丝