Paperclip是一款面向「零人力公司」的开源AI Agent编排框架，支持多AI代理协同、预算管控和组织级治理。本文将梳理项目的两种主流部署方式，并介绍基础使用流程，帮助开发者快速搭建自己的AI协作体系。
一、项目介绍
Paperclip的核心定位是AI公司级编排框架，区别于LangChain等单Agent开发框架，它提供完整的组织架构、预算管控、审批治理和多租户隔离能力，适合构建全自动化的AI协作团队。
核心特性包括：
- 标准化接口适配多种AI Agent（Claude Code、Codex CLI、OpenCode等）
- 内置开发、审核、研究等常见角色的Agent模板
- 支持本地开发、Docker Compose、云厂商多种部署模式
- MIT开源协议，免费商用，支持二次开发
二、本地快速部署
对于个人开发者和本地测试，推荐使用一键快速部署，整个过程仅需5分钟：
环境要求
- Node.js 20+
- pnpm 9.15+
一键部署命令
npx paperclipai onboard --yes
如果需要局域网访问，加上--bind lan参数：
npx paperclipai onboard --yes --bind lan
手动部署
如果需要自定义修改，可以克隆源码手动部署：
git clone https://github.com/paperclipai/paperclip.git
cd paperclip
pnpm install
pnpm dev
部署完成后，打开浏览器访问 http://localhost:3100，按照界面提示完成初始化：设置AI公司名称、核心使命、初始预算，即可进入控制台。
三、Docker生产部署
对于生产环境，推荐使用Docker Compose部署，配置步骤如下：
1. 克隆项目并进入目录
git clone https://github.com/paperclipai/paperclip.git
cd paperclip
2. 修改环境配置
复制.env示例文件，修改关键配置：
PAPERCLIP_PUBLIC_URL=http://<你的服务器IP>:3198
BETTER_AUTH_SECRET=<替换为随机强密钥，可通过openssl rand -base64 32生成>
PAPERCLIP_DEPLOYMENT_MODE=authenticated
PAPERCLIP_DEPLOYMENT_EXPOSURE=private
ANTHROPIC_API_KEY=<你的Anthropic API密钥>
OPENAI_API_KEY=<你的OpenAI API密钥>
安全建议：
BETTER_AUTH_SECRET必须使用随机强字符串PAPERCLIP_DEPLOYMENT_EXPOSURE设置为private限制仅内网访问- 定期备份
./pgdata和./data目录
3. 启动服务
docker-compose up -d
查看启动日志：
docker-compose logs -f
4. 初始化管理员账号
服务启动后，访问 http://<你的服务器IP>:3198，进入容器执行初始化命令：
docker exec -it paperclip-web /bin/bash
pnpm paperclipai onboard
按照提示获取管理员邀请链接，打开链接创建账号，完成基础配置即可。
四、云服务商一键部署
Paperclip还提供主流云厂商的一键部署脚本，以DigitalOcean为例：
curl -sSL https://paperclip.ai/deploy/do | bash
对于AWS ECS Fargate，先构建镜像推送到镜像仓库，再参考官方文档docs/DEPLOYMENT-MODES.md完成部署。
五、基础使用流程
部署完成后，即可开始创建你的AI协作团队：
- 创建Agent角色：项目内置了coder（开发）、reviewer（代码审核）、researcher（研究）三种预设模板，可直接选用也可自定义。
- 配置模型密钥：在Web界面或.env文件中配置OpenAI、Anthropic等大模型API密钥。
- 创建任务：创建任务并分配给对应的Agent，设置目标和执行参数。
- 监控执行：在控制台查看任务执行进度、成本消耗，支持审计和回滚操作。
六、适用场景总结
Paperclip适合以下场景使用：
- 希望构建自主运营AI团队的创业者
- 需要协调多个AI代理共同完成复杂任务的团队
- 需要管控AI调用成本、保留审计能力的企业
- AI Agent开发者统一管理多Agent的协作迭代
如果仅需要单Agent完成简单交互，Paperclip可能会过于重量级，选择轻量化工具更合适。