Vercel 部署

前端党最爱 —— 边缘计算秒级部署

Vercel 部署 OpenClaw,前端选手的主场

如果你是前端开发者,Vercel 应该不陌生 —— Next.js 背后的公司,git push 就能自动部署,体验确实丝滑。

不过先说清楚:Vercel 适合部署 OpenClaw 的 Web UI 和 API Gateway,不适合跑完整的 Agent 后端。Serverless 函数有执行时间限制,长时间运行的 AI 任务会超时。轻量级的前端 + API 转发场景,Vercel 是最省事的选择。

Vercel 能做什么、不能做什么

⚠️ Vercel 的 Serverless Functions 默认超时 10 秒(Pro 版 60 秒),不适合跑长时间的 AI 推理任务。如果你需要跑完整的 OpenClaw Agent,请选择 VPS 方案(AWS EC2、GCP 等)。

Vercel 适合的场景:

  • 部署 OpenClaw 的 Web 控制面板
  • 做 API Gateway,把请求转发到后端服务器
  • 部署文档站、监控面板等静态/轻量应用

Vercel vs 传统 VPS

Vercel(Serverless)
  • git push 自动部署,不用管服务器
  • 全球边缘网络,访问速度快
  • 免费额度对个人项目够用
  • 不支持长时间运行的任务
  • 适合前端 + 轻量 API
VS
传统 VPS(EC2/GCP 等)
  • 完全掌控,想跑啥跑啥
  • 没有执行时间限制
  • 需要自己维护服务器
  • 固定 IP,适合后端长连接
  • 适合完整 Agent 部署

四步部署

1

Fork 仓库

打开 OpenClaw 的 GitHub 仓库,点 Fork 到你自己的账号下。如果你有定制需求,可以先在本地改好再 push。

2

连接 Vercel

vercel.com 用 GitHub 账号登录 → Import Project → 选你 Fork 的仓库 → Vercel 会自动检测项目类型。

3

配置环境变量

在 Vercel 的 Settings → Environment Variables 里添加必要的配置,比如 API Key、数据库连接串等。别把密钥写在代码里。

4

部署上线

点 Deploy,等个几十秒就好了。Vercel 会给你一个 xxx.vercel.app 的域名,直接就能访问。后续每次 git push,自动触发重新部署。

vercel.json 配置

在项目根目录创建 vercel.json,配置路由和构建参数:

vercel.json
{
  "version": 2,
  "builds": [
    {
      "src": "package.json",
      "use": "@vercel/next"
    }
  ],
  "routes": [
    {
      "src": "/api/(.*)",
      "dest": "/api/$1"
    },
    {
      "src": "/(.*)",
      "dest": "/$1"
    }
  ],
  "env": {
    "NODE_ENV": "production"
  }
}

Vercel CLI 部署

如果你习惯用命令行,也可以用 Vercel CLI 本地部署:

Vercel CLI 部署流程
# 安装 Vercel CLI
npm i -g vercel

# 登录
vercel login

# 在项目目录下执行部署
cd your-project
vercel

# 部署到生产环境
vercel --prod

# 查看部署状态
vercel ls

# 查看日志
vercel logs your-project.vercel.app

环境变量配置

在 Vercel Dashboard 的 Settings → Environment Variables 里添加:

需要配置的环境变量
# 必填
OPENCLAW_API_KEY=your-api-key-here

# 可选
NODE_ENV=production
OPENCLAW_BACKEND_URL=https://your-backend-server.com
LOG_LEVEL=info
⚠️ 环境变量里的 API Key 等敏感信息不要提交到 Git 仓库,只在 Vercel Dashboard 里配置。

Vercel 免费额度

💡 Vercel 的 Hobby(免费)计划对个人项目完全够用:每月 100GB 带宽、每天 100,000 次 Serverless 调用、自动 HTTPS、自定义域名。只要不是特别大的流量,基本不用花钱。

免费计划的限制:

  • Serverless 函数超时 10 秒(Pro 版 60 秒)
  • 不支持团队协作(需要 Pro)
  • 构建时间每月 6000 分钟
  • 单个部署包大小限制 250MB
这篇教程对你有帮助吗?