Vercel 部署与管理

部署和管理 Vercel 项目。没有AI 会帮你构建应用的废话——只有实用的 Vercel 操作。

配置

Vercel 设置

获取你的令牌：

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

bash
export VERCEL_TOKEN=你的令牌

或者存储在 .env 文件中：

VERCEL_TOKEN=你的令牌

Vercel 操作

部署项目

bash

部署到预览环境

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

部署到生产环境

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

管理环境变量

bash

列出环境变量

scripts/vercel_env.sh --project bountylock --list

设置环境变量

scripts/vercel_env.sh --project bountylock --set \ --key NEXTPUBLICRPC_URL \ --value https://sepolia.base.org \ --env production

删除环境变量

scripts/vercel_env.sh --project bountylock --delete \ --key OLD_VAR \ --env production

检查部署状态

bash

获取最新部署

scripts/vercel_status.sh --project bountylock

获取特定部署

scripts/vercelstatus.sh --deployment dplabc123

查看日志

bash

获取部署日志

scripts/vercellogs.sh --deployment dplabc123

获取运行时日志

scripts/vercel_logs.sh --project bountylock --function api/bounties

常见工作流程

初始测试网部署

1. 1. 设置环境变量：

bash

合约地址（部署到 Sepolia 后）

scripts/vercel_env.sh --project bountylock --set \ --key NEXTPUBLICCONTRACT_ADDRESS \ --value 0x... \ --env production

RPC URL

scripts/vercel_env.sh --project bountylock --set \ --key NEXTPUBLICRPC_URL \ --value https://sepolia.base.org \ --env production

链 ID

scripts/vercel_env.sh --project bountylock --set \ --key NEXTPUBLICCHAIN_ID \ --value 84532 \ --env production

1. 2. 部署：

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

1. 3. 检查状态：

bash scripts/vercel_status.sh --project bountylock

更新环境变量

bash

重新部署后更新合约地址

scripts/vercel_env.sh --project bountylock --set \
--key NEXTPUBLICCONTRACT_ADDRESS \
--value 0xNEW_ADDRESS \
--env production

触发新部署以使用更新后的变量

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

调试部署问题

bash

获取最新部署信息

scripts/vercel_status.sh --project bountylock

获取构建日志

scripts/vercellogs.sh --deployment dplabc123

检查环境变量

scripts/vercel_env.sh --project bountylock --list

安全最佳实践

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

故障排除

身份验证失败

• - 检查令牌是否正确设置
• 验证令牌是否已过期

项目未找到

• - 验证项目名称是否与 Vercel 项目匹配
• 检查账户是否有权访问该项目

部署失败

• - 检查构建日志：scripts/vercellogs.sh --deployment dplxxx
• 验证环境变量是否正确设置
• 检查代码中的构建错误

参考文件

• - Vercel API 参考： 参见 vercel-api.md 获取完整的 API 文档
• 部署模式： 参见 deployment-patterns.md 获取常见部署工作流程