Open Agents

Open Agents 是 Vercel Labs 开源的参考应用，用来在 Vercel 上搭建并运行后台编程智能体。它不是库，而是一套完整可运行的系统：Web 界面、智能体运行时、沙箱编排和 GitHub 集成都在一起，所以一句提示词可以变成一个分支和一次 PR，而不需要你的笔记本一直开着。第一方仓库 创建于 2025-12-26，许可证为 MIT。2026-09-21 GitHub 显示 5,823 star、758 fork，最后一次推送是 2026-08-29。README 明确写了：这个仓库是拿来 fork 和改造的，不是当黑盒用的。

结构

Open Agents 把三层摞在同一个部署里：

Web -> Agent workflow -> Sandbox VM

• Web 应用：负责认证、会话、聊天和流式界面。
• 智能体：以持久化工作流的形式在 Vercel 上运行，而不是绑在发起它的那次请求生命周期里。
• 沙箱：执行环境，包含文件系统、shell、git、开发服务器和预览端口。

项目自己最先强调的设计决定是：智能体不是沙箱。智能体在虚拟机之外运行，通过读取文件、编辑、搜索、执行 shell 这类工具去访问沙箱。正是这层分离，让智能体执行不依赖单次请求生命周期、让沙箱可以独立休眠与恢复、也让模型选择和沙箱实现可以各自演进。

核心功能

• 对话驱动的编程智能体，具备文件、搜索、shell、任务、技能与网页工具。
• 持久化多步执行，由 Vercel Workflow SDK 支撑，支持流式输出与取消。
• 隔离的 Vercel 沙箱，可从快照恢复，空闲时自动休眠。
• 沙箱内完成 Git 操作：克隆仓库、在分支上工作，并在成功运行后可选地自动提交、推送、开 PR。
• 会话分享：通过只读链接共享，另可选 ElevenLabs 转写提供语音输入。

适用场景

• 自托管编程智能体：想要内部智能体平台，而不是一个自己也检视不了的托管产品。
• 长时间后台任务：重构、迁移、测试清扫，应该在你关掉发起页签之后继续跑。
• 拿来当参考实现：即使你最终要换掉其中几层，Web／工作流／沙箱的三层拆解本身就很有价值。

限制：这是模板，不是托管产品。要完整跑起来，你得提供 Postgres、认证密钥、Vercel OAuth 凭据和 GitHub App；一旦 fork，升级也要自己负责。自动提交与自动开 PR 是偏好驱动的开关，不是永远开启的行为。

定价方案

截至 2026-09-21，软件本身没有厂商订阅费；成本就是底层 Vercel 与数据库的实际用量。

快速开始

最快的路径是 README 里的 Deploy with Vercel 按钮，它会创建应用并提示你填写必需的环境变量。

POSTGRES_URL=
BETTER_AUTH_SECRET=
NEXT_PUBLIC_VERCEL_APP_CLIENT_ID=
VERCEL_APP_CLIENT_SECRET=
NEXT_PUBLIC_GITHUB_CLIENT_ID=
GITHUB_CLIENT_SECRET=
GITHUB_APP_ID=
GITHUB_APP_PRIVATE_KEY=
GITHUB_WEBHOOK_SECRET=

本地运行见 apps/web/.env.example。最小运行时只需要 POSTGRES_URL 和 BETTER_AUTH_SECRET，但登录与 GitHub 访问各自需要对应的凭据。

常见问题

这是可以直接用的产品吗？

它是参考应用。能跑，但设计意图是让你 fork 之后把各层改造成自己的环境和策略。

智能体跑在沙箱里面吗？

不。智能体在外面，通过工具与沙箱交互，这正是持久化运行和沙箱独立生命周期成立的前提。

沙箱能暴露哪些端口？

内置配置暴露 3000、5173、4321、8000，也可以从指定的基础快照启动。

替代方案

• E2B：如果你已经有智能体运行时、只缺执行层，它是更聚焦的沙箱基础设施。
• Daytona：另一种面向智能体代码执行的托管沙箱方案。
• LangGraph：如果你更想自带沙箱和界面，可以用它做智能体逻辑本身的持久化图运行时。

使用技巧

1. 改任何东西之前先读「智能体不是沙箱」那一节。项目里的很多灵活性都来自这条边界。
2. 尽早接好 GitHub App。自动提交和自动开 PR 才是价值显现的地方，而它们必须有这套凭据才能动。
3. 让工作流层负责长任务。把工作塞进聊天请求里内联执行，就把这个模板最有意思的持久化能力丢掉了。

总结

Open Agents 具体回答了「一个真正可用的后台编程智能体部署长什么样」。如果你在建内部智能体平台，想要一个能 fork 的起点而不是先花一周做架构决策，它是个不错的起点，也很自然地和 E2B 这类专门的沙箱层搭配使用。