Vercel部署与管理

部署和管理Vercel项目。没有"AI将构建你的应用"这种无稽之谈——只涉及实用的Vercel操作。

配置

Vercel设置

获取您的令牌：

1. 前往https://vercel.com/account/tokens
2. 创建令牌（命名为"OpenClaw"）
3. 在环境中设置：

export VERCEL_TOKEN="your-token-here"

或存储在.env文件中：

VERCEL_TOKEN=your-token-here

Vercel操作

部署项目

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

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

管理环境变量

# 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

检查部署状态

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

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

查看日志

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

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

常见工作流程

初始测试网部署

1. 设置环境变量：

# 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. 部署：

scripts/vercel_deploy.sh --project bountylock --production

3. 检查状态：

scripts/vercel_status.sh --project bountylock

更新环境变量

# 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

调试部署问题

# 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 参考：请参阅vercel-api.md获取完整的 API 文档
• 部署模式：请参阅deployment-patterns.md了解常见的部署工作流程