GitHub 地址：https://github.com/vercel-labs/open-agents

简介

Open Agents​ 是 Vercel Labs 开源的一套云端后台编码代理（Cloud Coding Agent）参考应用。它不是一个闭源的商业产品，而是一个旨在被 Fork 和深度定制的工程模板。其核心目标是实现从“自然语言指令”到“可审查的代码变更”的完整自动化闭环，且整个过程无需你的本地电脑保持开机或联网状态。

该项目构建于 Vercel 现代 Web 基础设施之上，集成了 Web UI（Next.js）、持久化工作流（Workflow SDK）和隔离沙箱（Vercel Sandbox）。最关键的架构哲学在于彻底分离了“决策大脑”（Agent）与“执行环境”（Sandbox）。Agent 运行在安全的控制平面，通过工具调用（文件读写、Shell）与沙箱交互，而非运行在 VM 内部。这种设计使得模型升级与执行环境升级可以独立进行，极大地提升了系统的可维护性和安全性。

主要功能

1. 云端原生与持久化工作流

• 24/7 后台运行：Agent 任务完全运行在 Vercel 云端。你可以关掉电脑，Agent 仍会继续执行克隆、编码、测试等长耗时任务，并通过 Web UI 或移动端实时查看进度。

• 可恢复的执行：基于 Vercel Workflow SDK，任务状态自动持久化。即使遇到网络波动或函数重启，任务也能从断点恢复，不会丢失工作进度。

2. 安全的沙箱化代码执行

• 隔离环境：代码修改、依赖安装、测试运行全部发生在隔离的 Vercel Sandbox 中，不会污染宿主环境。

• 快照与休眠：沙箱支持快照功能，空闲时自动休眠以节省资源，收到新任务时快速唤醒恢复，无需重复执行 npm install。

3. 完整的 Git 自动化流水线

• 端到端交付：支持自动克隆仓库、创建特性分支、提交代码、推送更改，并最终创建 Pull Request (PR)。

• GitHub 深度集成：通过配置 GitHub App，Agent 可以获得对私有仓库的读写权限，实现真正的自动化代码交付。

4. 多智能体协作（Multi-Agent）

系统内建了分工协作机制，而非单一 Agent 单打独斗：

• Explorer Agent：负责探索代码库结构，理解上下文。

• Executor Agent：负责执行具体的文件编辑、命令运行等操作。

  这种分工使得处理复杂任务（如重构）更加高效可靠。

安装与配置

核心依赖与环境要求

• 运行时：需要部署在 Vercel 平台（利用 Serverless Functions 和 Workflows）。

• 数据库：必须配置 PostgreSQL​ 数据库（用于存储会话、工作流状态）。

• 包管理器：推荐使用 bun（项目默认），也支持 npm/yarn。

部署步骤（Vercel 生产环境）

1. Fork 与导入：Fork 本仓库，并在 Vercel 控制台通过 Git 导入该项目。

2. 设置核心环境变量：在 Vercel 项目设置中配置以下必填项：

   • POSTGRES_URL：你的 PostgreSQL 数据库连接字符串。

   • JWE_SECRET：用于加密的密钥（可通过 openssl rand -base64 32生成）。

   • ENCRYPTION_KEY：用于加密令牌（可通过 openssl rand -hex 32生成）。

3. 配置认证（OAuth）：

   • 创建 Vercel OAuth App，设置回调地址为 https://your-domain.vercel.app/api/auth/vercel/callback。

   • 将获取的 NEXT_PUBLIC_VERCEL_APP_CLIENT_ID和 VERCEL_APP_CLIENT_SECRET填入环境变量。

4. 启用 GitHub 集成（可选但推荐）：

   • 创建 GitHub App，配置 Webhook 和 OAuth 权限。

   • 设置 GITHUB_APP_ID、GITHUB_APP_PRIVATE_KEY等环境变量以解锁私有仓库访问和 PR 创建能力。

本地开发

1. 克隆你的 Fork 仓库，安装依赖：bun install。

2. 复制环境模板：cp apps/web/.env.example apps/web/.env。

3. 填写本地 PostgreSQL 连接信息及密钥。

4. 启动开发服务器：bun run web，访问 http://localhost:3000。

如何使用

基础工作流

1. 登录与授权：访问部署好的 Web UI，使用 Vercel 账号登录，并授权连接你的 GitHub 账户。

2. 创建任务：在聊天界面输入自然语言指令，例如：“为我的 Next.js 项目添加 ESLint 配置并修复所有错误”。

3. 监控执行：系统会流式输出 Agent 的思考过程、执行的 Shell 命令和文件变更 Diff。

4. 审查与合并：任务完成后，Agent 会自动生成 PR 链接。你可以像审查人类贡献者的代码一样，Review 变更并决定是否合并。

关键配置点

• 模型选择：默认使用 OpenAI 模型，但通过 AI Gateway 可轻松切换为 Anthropic、Gemini 或本地模型。

• 沙箱行为：可通过环境变量 VERCEL_SANDBOX_BASE_SNAPSHOT_ID自定义基础镜像，预装团队特定的开发依赖。

应用场景实例（无代码）

场景一：独立开发者的“夜间工程师”

痛点：独立开发者白天忙于业务逻辑，晚上没有精力处理技术债（如依赖升级、代码格式化）。

Open Agents 方案：

1. 部署私有 Open Agents 实例，连接个人 GitHub 仓库。

2. 每晚睡前提交任务：“扫描代码库，将所有 var声明替换为 const/let，并运行测试”。

3. 价值：次日清晨，GitHub 通知中心已收到 Agent 提交的 PR，代码风格已统一且测试通过，开发者只需进行最终合并，实现了“睡眠开发”。

场景二：团队级“自动化代码卫士”

痛点：团队代码风格不一，新人常犯低级 lint 错误，导致主分支构建失败，资深工程师耗费时间在机械性审查上。

Open Agents 方案：

1. 团队部署内部 Open Agents 平台，配置统一的 ESLint、Prettier 规则。

2. 设置自动化规则：每当有新的 PR 创建且 lint 失败时，Agent 自动评论并生成一个修复 Commit 推送到该分支。

3. 价值：将资深开发者从“格式警察”的角色中解放出来，专注于架构审查。代码库始终保持统一的风格，且修复过程完全自动化。

场景三：开源项目的“自动依赖管理”

痛点：大型开源项目依赖更新频繁，维护者需要手动验证数百个依赖的兼容性，工作量巨大。

Open Agents 方案：

1. 项目维护者配置 Open Agents，授予其“依赖管理”仓库的写权限。

2. 指令 Agent：“每周检查 package.json中的依赖，对非重大版本更新（Minor/Patch），自动创建测试分支并运行 CI”。

3. 价值：Agent 自动完成依赖扫描、版本升级、测试运行。维护者只需审查 CI 结果和变更摘要，大幅降低了维护负担，确保项目依赖始终处于最新且安全的状态。

总结

Open Agents 是 Vercel 为社区提供的一份“AI 软件工厂”蓝图。它证明了将 AI 编码能力从本地 IDE 插件升级为云端持久化基础设施的可行性。对于想要构建私有 AI 开发助手的团队，它是极佳的起点；对于研究者，它是理解现代 Agent 架构的绝佳案例。

GitHub 地址：https://github.com/vercel-labs/open-agents