Gondolabeta
⌁ Guides

OpenClaw

Register Gondola as an openai-completions provider in openclaw.json and run any Venice model, paid per request in USDC on Base.

1

Create an API key

Sign in with your Base wallet at /keys and mint a Gondola API key. Keys start with gnd_. It authenticates every request and each call is charged in USDC against your Gondola balance.

Top up USDC on Base once at /wallet. The same balance powers the browser chat and every tool you connect.

2

Point OpenClaw at Gondola

Add a Gondola provider to ~/.openclaw/openclaw.json (JSON5). The provider's api must be the literal openai-completions, and the default model is set at agents.defaults.model.primary as gondola/<id>:

~/.openclaw/openclaw.json
{
  agents: {
    defaults: {
      model: { primary: "gondola/claude-sonnet-5" },
    },
  },
  models: {
    providers: {
      gondola: {
        baseUrl: "https://api.gondola-ai.com/v1",
        apiKey: "${GONDOLA_API_KEY}",
        api: "openai-completions",
        models: [
          { id: "claude-sonnet-5", name: "Claude Sonnet 5", contextWindow: 200000, maxTokens: 8192 },
        ],
      },
    },
  },
}

Export the key before starting OpenClaw:

shell
export GONDOLA_API_KEY=gnd_live_xxxx
Base URL gotcha
The baseUrl is api.gondola-ai.com/v1 only. Do not append /chat/completions; the provider adds the path itself.
3

Pick a model

Gondola serves the full Venice catalog. Each model needs an entry in the provider's models array keyed by its exact id, referenced as gondola/<id>. Pull the live list:

shell
curl https://api.gondola-ai.com/v1/models

Each entry includes context_length and max_completion_tokens. Copy those into contextWindow and maxTokens per model.

4

Notes and troubleshooting

Set real context values
If you omit contextWindow and maxTokens, OpenClaw defaults to 200000 and 8192, which may not match the model you chose. Use the real numbers from the models list.

Environment substitution (${GONDOLA_API_KEY}) accepts uppercase variable names only and throws at load if the variable is unset, so export it first. The config schema is strict; run openclaw doctor --fix to diagnose a rejected config. If a request returns insufficient balance, top up at /wallet.

Keep going
All setup guides →OpenCode guide →SillyTavern guide →Live prices →