Vercel 官方出品，你的 24 小时 AI 编程助手

你有没有想过，能不能让 AI 帮你写代码，然后关掉电脑去睡觉，第二天早上起来看到 PR 已经提好了？

这不是科幻。Vercel 刚刚开源了一个项目，叫 Open Agents，专门解决这个问题。

它是一个云端 AI 编码 Agent 的完整模板。你可以部署自己的版本，然后告诉它"帮我给项目加个登录功能"，它就会自动克隆代码、修改文件、跑测试、提交 PR。全程不需要你盯着，甚至不需要你的电脑开着。

GitHub：

github.com/vercel-labs...

什么是 Open Agents

简单说，这是一个开源的 AI 编程助手框架。但它和 Claude Code、Cursor 这些工具不一样。

Claude Code 是在你本地运行的，你的电脑得开着，它才能工作。Open Agents 是跑在云端的，部署到 Vercel 后，它 24 小时在线。你可以手机发消息给它，它就在服务器上干活。

这个项目是 Vercel Labs 出品的，代码质量和技术选型都很靠谱。它的定位是"参考模板"，意思是让你 fork 回去自己改，而不是当黑盒用。

三层架构设计

Open Agents 的设计很有意思，分成三层。

最上面是 Web 层，就是你看到的聊天界面。在这里发消息、看回复、管理会话。支持流式输出，AI 一边想一边显示，不用等半天才看到结果。

中间是 Agent 层，这是整个系统的大脑。它作为持久化工作流运行在 Vercel 上，可以执行多步骤任务。比如"先读文件 A，再改文件 B，然后跑测试"。每个步骤都能保存状态，就算断网了，重连后还能继续。

最下面是 沙箱层，这是代码执行环境。里面有文件系统、Shell、Git、开发服务器。Agent 通过工具操作沙箱，比如读文件、写文件、执行命令。沙箱支持快照，可以休眠和恢复，不用的时候不占资源。

最关键的设计是 Agent 和沙箱分离。Agent 不在沙箱里运行，而是在外面通过工具交互。这样做的好处很多：Agent 执行不依赖单次请求，沙箱可以独立休眠，两者可以分别升级，沙箱保持纯粹不变成控制中枢。

能做什么

Open Agents 的能力挺全面的，基本覆盖了 AI 编程的常用场景。

对话式编码是最基础的功能。你描述需求，Agent 理解后自动操作。支持文件读写、代码搜索、Shell 命令、任务管理、技能调用、Web 搜索等工具。比如你说"把项目里的 console.log 都改成 logger.info"，它会先搜索所有文件，然后逐个修改。

持久化执行是云端的优势。Agent 运行的是一个工作流，可以跨多个步骤持久化状态。如果某一步失败了，你可以看到具体错在哪，修复后继续，不用从头来。还支持取消操作，如果发现它走偏了，随时可以喊停。

隔离沙箱保证安全。每个会话有独立的执行环境，基于快照快速启动。暴露了几个常用端口（3000、5173、4321、8000），可以跑开发服务器看效果。不用的时候自动休眠，省资源。

GitHub 集成让协作更顺畅。Agent 可以克隆仓库、创建分支、提交代码。 optionally 还能自动 push 和提 PR。比如你说"给 README 加个徽章"，它改完后直接提 PR，你手机上就能收到通知。

会话分享方便团队协作。生成的会话链接可以分享给同事，对方能看到完整的对话历史和代码改动，但只能看不能改。

语音输入是锦上添花的功能。集成了 ElevenLabs 的语音识别，懒得打字可以直接说。

部署自己的版本

Open Agents 是开源的，你可以部署自己的实例。整体流程不复杂，但需要准备一些配置。

第一步是 fork 仓库。把项目复制到你的 GitHub 账号下，这样后面可以自定义修改。

第二步创建数据库。需要一个 PostgreSQL 数据库来存会话、用户、配置等信息。可以用 Vercel 自带的 Postgres，也可以用其他服务商的。

第三步生成密钥。需要两个密钥，一个是 JWE_SECRET 用于加密会话，一个是 ENCRYPTION_KEY 用于加密敏感信息。官方提供了生成命令：

bash 复制代码

# 生成 JWE_SECRET
openssl rand -base64 32 | tr '+/' '-_' | tr -d '=\n'

# 生成 ENCRYPTION_KEY
openssl rand -hex 32

复制生成的字符串，后面会用到。

第四步导入 Vercel。在 Vercel 控制台导入 fork 的仓库，添加环境变量，然后部署。最少需要这几个变量：

bash 复制代码

POSTGRES_URL=postgresql://...
JWE_SECRET=上面生成的第一个密钥
ENCRYPTION_KEY=上面生成的第二个密钥

部署一次获取稳定的生产 URL，后面配置 OAuth 需要用到。

第五步配置 OAuth。如果要支持登录，需要创建 Vercel OAuth App：

Homepage URL: https://YOUR_DOMAIN
Callback URL: https://YOUR_DOMAIN/api/auth/vercel/callback

创建后得到 Client ID 和 Client Secret，加到环境变量：

bash 复制代码

NEXT_PUBLIC_VERCEL_APP_CLIENT_ID=你的ClientID
VERCEL_APP_CLIENT_SECRET=你的ClientSecret

第六步配置 GitHub App。如果要支持克隆仓库、提 PR，需要创建 GitHub App：

Homepage URL: https://YOUR_DOMAIN
Callback URL: https://YOUR_DOMAIN/api/github/app/callback
Setup URL: https://YOUR_DOMAIN/api/github/app/callback

在设置里启用 "Request user authorization (OAuth) during installation"，然后添加这些环境变量：

bash 复制代码

NEXT_PUBLIC_GITHUB_CLIENT_ID=GitHubApp的ClientID
GITHUB_CLIENT_SECRET=GitHubApp的ClientSecret
GITHUB_APP_ID=你的AppID
GITHUB_APP_PRIVATE_KEY=私钥内容
NEXT_PUBLIC_GITHUB_APP_SLUG=你的App名称
GITHUB_WEBHOOK_SECRET=Webhook密钥

全部配好后重新部署，就能访问你自己的 Open Agents 实例了。

本地开发

如果你想改代码或者二次开发，本地运行也很简单。

先安装依赖，项目用 Bun 作为包管理器：

bash 复制代码

bun install

然后复制环境变量模板：

bash 复制代码

cp apps/web/.env.example apps/web/.env

填上你的配置，最少需要这些：

bash 复制代码

POSTGRES_URL=postgresql://localhost:5432/openagents
JWE_SECRET=你的JWE密钥
ENCRYPTION_KEY=你的加密密钥

最后启动开发服务器：

bash 复制代码

bun run web

默认在 http://localhost:3000 运行，代码改动会自动热更新，开发体验不错。

如果你已经有链接的 Vercel 项目，也可以直接拉取环境变量：

bash 复制代码

vercel env pull apps/web/.env

适合谁用

Open Agents 的定位是"模板"，适合有一定技术能力的团队或个人。

如果你是独立开发者，想有一个 24 小时在线的 AI 助手，可以部署一个自己的实例。手机随时发任务，AI 在云端执行，回来验收结果就行。

如果你是技术团队，可以基于这个模板开发内部的 AI 编程工具。加上你们自己的业务逻辑、代码规范、审批流程，做成团队专用的 Agent。

如果你是AI 产品开发者，这个项目的架构设计很有参考价值。三层分离、持久化工作流、沙箱隔离，这些都是做 AI Agent 的通用模式。

GitHub：

github.com/vercel-labs...

写在最后

Open Agents 代表了 AI 编程工具的一个方向：从本地工具走向云端服务。

本地工具的好处是响应快、隐私好，但缺点是你的电脑得开着。云端服务的好处是随时在线、可以共享、可以持久化执行。两者不是替代关系，而是互补。

Vercel 把这个项目开源出来，对社区是好事。它不只是给了一个可用的工具，更重要的是展示了一种架构思路。怎么设计 Agent 系统，怎么处理持久化执行，怎么隔离执行环境，这些都是做 AI 应用的核心问题。

项目完全开源，欢迎 fork 和贡献。如果你也在探索 AI 编程的落地场景，这个项目值得研究。

关注

如果这篇文章对你有帮助，欢迎点赞、收藏、转发。我会持续分享实用的开发工具和技术教程，关注我，一起提升开发效率。