Vercel Deploy

# Vercel Deployment & Management

部署和管理 Vercel 项目。没有“AI 将构建你的应用”之类的空谈——只有实用的 Vercel 操作。

## 配置

### Vercel 设置

**获取你的令牌：** 1. 访问 https://vercel.com/account/tokens 2. 创建令牌（将其命名为“OpenClaw”） 3. 在环境中设置：

```bash export VERCEL_TOKEN="your-token-here" ```

或将其存储在 `.env` 中： ``` VERCEL_TOKEN=your-token-here ```

## Vercel 操作

### 部署项目

```bash # Deploy to preview scripts/vercel_deploy.sh --project bountylock --preview

# Deploy to production scripts/vercel_deploy.sh --project bountylock --production ```

### 管理环境变量

```bash # List env vars scripts/vercel_env.sh --project bountylock --list

# Set env var scripts/vercel_env.sh --project bountylock --set \ --key NEXT_PUBLIC_RPC_URL \ --value "https://sepolia.base.org" \ --env production

# Delete env var scripts/vercel_env.sh --project bountylock --delete \ --key OLD_VAR \ --env production ```

### 检查部署状态

```bash # Get latest deployment scripts/vercel_status.sh --project bountylock

# Get specific deployment scripts/vercel_status.sh --deployment dpl_abc123 ```

### 查看日志

```bash # Get deployment logs scripts/vercel_logs.sh --deployment dpl_abc123

# Get runtime logs scripts/vercel_logs.sh --project bountylock --function api/bounties ```

## 常见工作流

### 初始测试网部署

1. **设置环境变量：** ```bash # Contract addresses (after deploying to Sepolia) scripts/vercel_env.sh --project bountylock --set \ --key NEXT_PUBLIC_CONTRACT_ADDRESS \ --value "0x..." \ --env production

# RPC URL scripts/vercel_env.sh --project bountylock --set \ --key NEXT_PUBLIC_RPC_URL \ --value "https://sepolia.base.org" \ --env production

# Chain ID scripts/vercel_env.sh --project bountylock --set \ --key NEXT_PUBLIC_CHAIN_ID \ --value "84532" \ --env production ```

2. **部署：** ```bash scripts/vercel_deploy.sh --project bountylock --production ```

3. **检查状态：** ```bash scripts/vercel_status.sh --project bountylock ```

### 更新环境变量

```bash # Update contract address after redeployment scripts/vercel_env.sh --project bountylock --set \ --key NEXT_PUBLIC_CONTRACT_ADDRESS \ --value "0xNEW_ADDRESS" \ --env production

# Trigger new deployment to use updated vars scripts/vercel_deploy.sh --project bountylock --production ```

### 调试部署问题

```bash # Get latest deployment info scripts/vercel_status.sh --project bountylock

# Get build logs scripts/vercel_logs.sh --deployment dpl_abc123

# Check environment variables scripts/vercel_env.sh --project bountylock --list ```

## 安全最佳实践

1. **令牌范围：** 尽可能使用项目范围的令牌 2. **轮换：** 定期轮换令牌 3. **审计：** 定期检查部署日志 4. **密钥：** 切勿将令牌提交到 git

## 故障排除

**“身份验证失败”** - 检查令牌是否设置正确 - 验证令牌是否未过期

**“未找到项目”** - 验证项目名称是否与 Vercel 项目匹配 - 检查帐户是否有权访问该项目

**“部署失败”** - 检查构建日志：`scripts/vercel_logs.sh --deployment dpl_xxx` - 验证环境变量是否设置正确 - 检查代码中是否存在构建错误

## 参考文件

- **Vercel API 参考：** 有关完整的 API 文档，请参阅 [vercel-api.md](references/vercel-api.md) - **部署模式：** 有关常见的部署工作流，请参阅 [deployment-patterns.md](references/deployment-patterns.md)