Vercel

The Vercel extra provides integration with Vercel for deploying the MonoClaw dashboard and API.

When to use Vercel

• You want to host the MonoClaw dashboard publicly
• You need serverless API endpoints for webhooks
• You want edge-deployed functions for low latency
• You're already using Vercel for other projects

Installation

The Vercel extra is included in the [all] install. If you installed the minimal bundle:

cd ~/.monoclaw/monoclaw-runtime
uv pip install -e ".[vercel]"

Deploying the dashboard

The MonoClaw dashboard is a Next.js app that can be deployed to Vercel:

cd ~/.monoclaw/monoclaw-runtime/web
vercel --prod

Vercel AI Gateway

You can route Mona through Vercel AI Gateway for unified API management:

# ~/.monoclaw/config.yaml
model:
  provider: vercel
  vercel:
    api_key: "${VERCEL_AI_GATEWAY_API_KEY}"
    gateway_url: "https://your-gateway.vercel.ai/v1"

Environment variables

Set these in your Vercel project settings:

MONOCLAW_API_KEY
MODEL_DEFAULT
OPENROUTER_API_KEY

Serverless functions

Deploy webhook handlers as Vercel Functions:

# api/webhooks/github.py
from monoclaw.vercel import handle_webhook

async def handler(request):
    return await handle_webhook(request, "github")

Configuration

# ~/.monoclaw/config.yaml
vercel:
  project_id: "your-project-id"
  team_id: "your-team-id"
  edge_functions: true

Troubleshooting