An open source template for building cloud agents.
📖 README
Open Agents[](https://vercel.com/new/clone?project-name=open-agents&repository-name=open-agents&repository-url=https%3A%2F%2Fgithub.com%2Fvercel-labs%2Fopen-agents&demo-title=Open+Agents&demo-description=Open-source+reference+app+for+building+and+running+background+coding+agents+on+Vercel.&demo-url=https%3A%2F%2Fopen-agents.dev%2F&env=POSTGRESURL%2CJWESECRET%2CENCRYPTIONKEY%2CNEXTPUBLICVERCELAPPCLIENTID%2CVERCELAPPCLIENTSECRET%2CNEXTPUBLICGITHUBCLIENTID%2CGITHUBCLIENTSECRET%2CGITHUBAPPID%2CGITHUBAPPPRIVATEKEY%2CNEXTPUBLICGITHUBAPPSLUG%2CGITHUBWEBHOOKSECRET&envDescription=Neon+can+provide+POSTGRESURL+automatically.+Generate+JWESECRET+and+ENCRYPTIONKEY+yourself%2C+then+add+your+Vercel+OAuth+and+GitHub+App+credentials+for+a+full+deployment.&products=%255B%257B%2522type%2522%253A%2522integration%2522%252C%2522protocol%2522%253A%2522storage%2522%252C%2522productSlug%2522%253A%2522neon%2522%252C%2522integrationSlug%2522%253A%2522neon%2522%257D%252C%257B%2522type%2522%253A%2522integration%252...
📊 Project Info
- Language
- TypeScript
- Stars
- ⭐ 2,607
- Forks
- 290
- Today
- +915
- Ranking
- #10
- Collection
- Overall
- Trending Date
- April 15, 2026
- Last Push
- 4/15/2026
🏷️ Topics
agentagentsaibackground-agents
5分钟快速开始：Vercel Open Agents
一个用于在Vercel上构建和运行云端智能体的开源模板，快速部署并体验AI驱动的编码代理。
🖥️ OS
macOSWindowsLinux
⚙️ Runtime
Node.js>=18
🔧 Tools
Git— 克隆仓库
Vercel CLI— 部署到Vercel
📝 Steps
1
克隆仓库并安装依赖
从GitHub克隆项目并安装必要的Node.js依赖包。
克隆项目到本地
$ git clone https://github.com/vercel-labs/open-agents.git进入项目目录并安装依赖
$ cd open-agents && npm install✓Expected: 依赖安装成功，无错误信息。
💡确保Node.js版本符合要求，否则可能安装失败。
2
设置环境变量
创建本地环境配置文件并填入基本值，以便应用启动。
复制环境变量示例文件
$ cp apps/web/.env.example apps/web/.env添加一个示例PostgreSQL连接字符串（需替换为真实值）
$ echo 'POSTGRESURL=postgresql://user:pass@localhost:5432/db' >> apps/web/.env✓Expected: 文件创建成功，无错误。
💡POSTGRESURL是启动所需的最小环境变量，可使用Neon等免费服务获取。
3
启动本地开发服务器
运行开发命令以在本地启动应用并查看效果。
启动开发服务器
$ npm run dev✓Expected: 服务器启动，输出类似'ready - started server on 0.0.0.0:3000'的信息。
💡打开浏览器访问 http://localhost:3000 查看应用界面。
✅ 验证成功
确认应用已成功运行并显示基本界面。
- ✓浏览器打开 http://localhost:3000 显示登录或欢迎页面
- ✓终端无错误日志，服务器持续运行
⚡ Quick Tips
部署使用Vercel一键部署可跳过本地设置，快速上线。
配置环境变量如JWESECRET和ENCRYPTIONKEY需自行生成，可用openssl命令。
🔍 Troubleshooting
❓ npm install失败
→ 检查Node.js版本，确保>=18，并尝试删除node_modules后重试。
❓ 应用启动后显示错误页面
→ 确认环境变量POSTGRESURL已正确设置，并重启服务器。
🎯 Next Steps
1
部署到Vercel
按照README部署指南，添加Vercel OAuth和GitHub App以启用完整功能。
2
探索代理功能
在本地或部署后，尝试使用聊天界面与AI代理交互，体验编码任务。