Files
bot/docs/providers/vercel-ai-gateway.md
zeekayandHanzo Dev 84e4069c2c docs name the state dir and config file the bot reads: ~/.bot/bot.json
The docs said ~/.hanzo-bot/hanzo-bot.json (and ~/.hanzo-bot-<profile>, hanzo-bot.plugin.json), which nothing reads: src/config/paths.ts resolves ~/.bot, bot.json and ~/.bot-<profile>, and plugins ship bot.plugin.json. Every such path in docs/ now names what the code opens.

Co-authored-by: Hanzo Dev <[email protected]>
2026-09-24 21:12:09 -07:00

1.4 KiB

title, summary, read_when
title summary read_when
Vercel AI Gateway Vercel AI Gateway setup (auth + model selection)
You want to use Vercel AI Gateway with HanzoBot
You need the API key env var or CLI auth choice

Vercel AI Gateway

The Vercel AI Gateway provides a unified API to access hundreds of models through a single endpoint.

  • Provider: vercel-ai-gateway
  • Auth: AI_GATEWAY_API_KEY
  • API: Anthropic Messages compatible

Quick start

  1. Set the API key (recommended: store it for the Gateway):
hanzo-bot onboard --auth-choice ai-gateway-api-key
  1. Set a default model:
{
  agents: {
    defaults: {
      model: { primary: "vercel-ai-gateway/anthropic/claude-opus-4.6" },
    },
  },
}

Non-interactive example

hanzo-bot onboard --non-interactive \
  --mode local \
  --auth-choice ai-gateway-api-key \
  --ai-gateway-api-key "$AI_GATEWAY_API_KEY"

Environment note

If the Gateway runs as a daemon (launchd/systemd), make sure AI_GATEWAY_API_KEY is available to that process (for example, in ~/.bot/.env or via env.shellEnv).

Model ID shorthand

HanzoBot accepts Vercel Claude shorthand model refs and normalizes them at runtime:

  • vercel-ai-gateway/claude-opus-4.6 -> vercel-ai-gateway/anthropic/claude-opus-4.6
  • vercel-ai-gateway/opus-4.6 -> vercel-ai-gateway/anthropic/claude-opus-4-6