An open source template for building cloud agents.
📊 Project Info
- Language
- TypeScript
- Stars
- ⭐ 5,033
- Forks
- 636
- Today
- +131
- Ranking
- #8
- Collection
- Overall
- Trending Date
- May 7, 2026
- Last Push
- 5/6/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代理交互，体验编码任务。