- name
- vercel-deploy
- description
- Deploy and manage Vercel projects. Use when deploying applications to Vercel, managing environment variables, checking deployment status, viewing logs, or performing Vercel operations. Supports production and preview deployments. Practical infrastructure operations - no "AI will build your app" magic.
Vercel Deployment & Management
Deploy and manage Vercel projects. No "AI will build your app" nonsense - just practical Vercel operations.
Configuration
Vercel Setup
Get your token:
- Go to https://vercel.com/account/tokens
- Create token (name it "OpenClaw")
- Set in environment:
export VERCEL_TOKEN="your-token-here"Or store in .env:
VERCEL_TOKEN=your-token-hereVercel Operations
Deploy Project
# Deploy to preview
scripts/vercel_deploy.sh --project bountylock --preview
# Deploy to production
scripts/vercel_deploy.sh --project bountylock --productionManage Environment Variables
# 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 productionCheck Deployment Status
# Get latest deployment
scripts/vercel_status.sh --project bountylock
# Get specific deployment
scripts/vercel_status.sh --deployment dpl_abc123View Logs
# Get deployment logs
scripts/vercel_logs.sh --deployment dpl_abc123
# Get runtime logs
scripts/vercel_logs.sh --project bountylock --function api/bountiesCommon Workflows
Initial Testnet Deployment
- Set environment variables:
# 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- Deploy:
scripts/vercel_deploy.sh --project bountylock --production- Check status:
scripts/vercel_status.sh --project bountylockUpdate Environment Variables
# 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 --productionDebug Deployment Issues
# 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 --listSecurity Best Practices
- Token Scope: Use project-scoped tokens when possible
- Rotation: Rotate tokens periodically
- Audit: Review deployment logs regularly
- Secrets: Never commit tokens to git
Troubleshooting
"Authentication failed"
- Check token is set correctly
- Verify token hasn't expired
"Project not found"
- Verify project name matches Vercel project
- Check account has access to project
"Deployment failed"
- Check build logs:
scripts/vercel_logs.sh --deployment dpl_xxx - Verify environment variables are set correctly
- Check for build errors in code
Reference Files
- Vercel API Reference: See vercel-api.md for complete API documentation
- Deployment Patterns: See deployment-patterns.md for common deployment workflows