open-agents 是什么?

Open Agents 是 Vercel Labs 出的开源「云端编码 agent」模板,给你一套可直接部署、可改造的参考架构。它是三层系统:Web(认证/会话/聊天/流式 UI)→ Agent workflow(在 Vercel 上以持久化工作流运行的 agent)→ Sandbox VM(文件系统、shell、git、dev server、预览端口的执行环境)。它最核心的设计决策是『agent 不等于 sandbox』——agent 跑在 VM 之外、通过文件读写/搜索/shell 等工具与沙箱交互,从而把 agent 执行与单次请求生命周期、与沙箱生命周期解耦。TypeScript(Next.js + Turbo monorepo),MIT,可一键部署到 Vercel。

⭐ 5,263 Stars 🍴 656 Forks TypeScript MIT 作者: vercel-labs
来源:README What it is/架构决策;GitHub vercel-labs/open-agents,desc,license MIT 查看 GitHub 仓库 →

为什么值得关注

约 5.5k 星,热度来自 Vercel 官方背书 + 一个清晰的架构主张:很多人想做『云端编码 agent』(像 Devin/云端 Cursor 那样),但卡在 agent 与沙箱怎么解耦、怎么持久化跨多步执行、怎么 resume。Open Agents 把这套架构(持久工作流 + 隔离沙箱 + agent 在 VM 外)做成可一键部署到 Vercel 的开源模板,省去从零搭建,对想自建云 agent 产品的人很有参考价值。

来源:GitHub 5,520 stars / 708 forks,created 2025-12-26;README What it is

核心功能

agent 与 sandbox 解耦的三层架构

agent 不在 VM 内运行,而在沙箱外通过工具交互——好处是 agent 执行不绑死单次请求、沙箱可独立 hibernate/resume、模型/provider 与沙箱实现可各自演进、VM 保持为纯执行环境而非控制面。

来源:README The key architectural decision
持久多步执行(Workflow SDK)

聊天请求启动一个 workflow run 而非内联执行 agent,一个 agent turn 可跨多个持久化 workflow step 继续;支持流式、取消,活跃 run 可通过重连 stream 恢复。

来源:README Current capabilities/Runtime notes;apps/web(workflows)
隔离沙箱 + 快照恢复

用隔离的 Vercel sandbox,支持基于快照的 resume,可在沙箱里 clone 仓库、建分支工作;沙箱暴露 3000/5173/4321/8000 端口做预览,闲置后 hibernate,可选配置基础快照。

来源:README Current capabilities/Runtime notes;packages/sandbox
Git 集成与会话分享

成功运行后可选自动 commit、push 并创建 PR(偏好驱动、非默认常开);会话可通过只读链接分享;可选 ElevenLabs 语音输入。

来源:README Current capabilities
可一键部署的完整模板

chat 驱动的编码 agent 带文件/搜索/shell/task/skill/web 工具与 subagent;提供 Deploy on Vercel 一键部署、本地搭建、Vercel OAuth + GitHub App 集成配置,开箱即是可跑的云 agent 应用。

来源:README Current capabilities/Deploy your own/OAuth setup

技术架构

Bun + Turbo 管理的 monorepo,结构与其架构主张一一对应:apps/web 是 Next.js 应用,承载认证、聊天 UI、流式以及 Vercel workflows(agent 以持久工作流运行);packages/agent 是 agent 实现——工具、subagent、skill;packages/sandbox 是沙箱抽象层与 Vercel sandbox 集成;packages/shared 是共享工具。关键在于 agent(packages/agent,跑在 workflow 里、VM 外)与 sandbox(packages/sandbox,纯执行环境)的清晰分离:agent 通过工具调用操作沙箱里的文件/shell/git,沙箱可独立休眠恢复。集成上用 Vercel OAuth 登录、GitHub App 做仓库访问/push/PR,可选 ElevenLabs 语音。整体是『Next.js 前端 + Vercel Workflow 持久 agent + 可插拔沙箱抽象』的云 agent 参考实现,工程化(oxlint/oxfmt、turbo、skills-lock)较完整。

来源:README Repo layout/Runtime notes;tree(apps/web、packages/{agent,sandbox,shared}、turbo.json)

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) Vercel Workflow SDK(持久执行)Vercel Workflo… Vercel Sandbox(隔离 VM + 快照)Vercel Sandbox… Vercel OAuth + GitHub App(认证/仓库)Vercel OAuth +… Turbo + Bun(monorepo)Turbo + Bun(m… ElevenLabs(可选语音)ElevenLabs(可… agent 与 sandbox 解耦的三层架构agent 与 sandbox 解… 持久多步执行(Workflow SDK)持久多步执行(Workflo… 隔离沙箱 + 快照恢复 Git 集成与会话分享 可一键部署的完整模板 open-agents 项目本体 核心功能 关键依赖

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言TypeScript框架Next.js + Vercel Workflow SDK
Vercel Workflow SDK(持久执行)Vercel Sandbox(隔离 VM + 快照)Vercel OAuth + GitHub App(认证/仓库)Turbo + Bun(monorepo)ElevenLabs(可选语音)
云端:部署在 Vercel(workflow + sandbox);可一键 Deploy;强依赖 Vercel 平台能力
来源:README Environment variables/Deploy;tree(turbo.json、bun.lock)

快速上手

最快路径是『Deploy your own copy on Vercel』一键部署。本地搭建:clone 后按 README 装依赖(Bun + Turbo),配置环境变量——最小运行所需若干变量、登录需 Vercel OAuth、GitHub 仓库访问/push/PR 需配 GitHub App,可选 ElevenLabs 语音等。配好后即得一个 chat 驱动的云编码 agent:对话发起 workflow run,在隔离沙箱里 clone 仓库、改代码、跑 dev server 预览(端口 3000/5173/4321/8000),可选自动 commit/push/PR。强依赖 Vercel 平台(Workflow + Sandbox)。
来源:README Deploy your own/Local setup/OAuth and integration setup

使用场景

适合:①想自建『云端编码 agent』产品或内部工具、需要一套成型架构而非从零搭的团队与开发者;②想学习『agent 与沙箱解耦 + 持久工作流执行 + 快照 resume』这套云 agent 模式的人;③已在 Vercel 生态、想快速起一个可改造的 agent 模板的人。不适合:不想绑定 Vercel 平台(Workflow/Sandbox/OAuth)的团队;以及只需要本地 CLI agent、不需要云端持久执行与沙箱的人。

来源:README What it is/Deploy,结合定位推断

优势与局限

优势

  • 架构主张清晰且有价值:agent 与 sandbox 解耦,让执行、沙箱、模型可各自演进,是云 agent 的合理范式
  • 持久执行做对了:用 Workflow SDK 跨多步持久化、可流式可取消可 resume,比内联请求更适合长任务
  • 开箱即用模板:认证、聊天、沙箱、git(自动 commit/push/PR)、会话分享、语音都接好,省大量搭建
  • Vercel 官方出品 + MIT,可一键部署、可改造,工程化(turbo/oxlint)规范
  • monorepo 分层(web/agent/sandbox/shared)干净,便于替换模型或沙箱实现

局限

  • 强依赖 Vercel 平台(Workflow、Sandbox、OAuth),迁到其他云需自行替换沙箱/工作流抽象
  • 是模板/参考实现而非成品产品,做成可用产品仍需大量定制与运维
  • 云沙箱与工作流有真实成本(计算、存储、模型),规模化需自担
  • GitHub App、OAuth、多环境变量配置有一定上手门槛
  • 能力仍是『当前 capabilities』级别,复杂多 agent 协作、权限与安全等需自行加固
来源:README Runtime notes/Environment variables;平台依赖推断

最新版本

仓库无正式 GitHub Release,以模板形式持续维护,主分支高频更新(最近 push 2026-05-22,创建于 2025-12-26)。作为 Vercel Labs 项目,随 Workflow SDK 与 Sandbox 能力演进同步迭代。

来源:GitHub 无 releases;pushed_at 2026-05-22;created 2025-12-26

总结评价

Open Agents 的价值不在于又一个 agent,而在于它把『云端编码 agent 该怎么搭』这件事,用一套清晰、可一键部署的开源模板讲明白了:agent 与沙箱解耦、用持久工作流跨多步执行、沙箱快照 resume、再接好认证/git/分享——这套范式正是想做 Devin 类产品的人最需要的脚手架,加上 Vercel 官方背书,5.5k 星合理。要清醒它是模板而非成品,且强绑 Vercel 平台(Workflow/Sandbox/OAuth),迁出或规模化都要自己补。对想在 Vercel 上自建云 agent、或想学这套架构的团队,它是目前最值得参考的开源起点之一;不想绑 Vercel 的人则需另选。

来源:综合 README 架构/能力、tree 分层、平台依赖与发布状态的事实判断
透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-05-22 21:29. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件