Skip to content

OpenClaw

View as Markdown

OpenClaw registers providers with openclaw onboard. Vikey is added as a custom provider with an API key.

  1. Install or update OpenClaw:

    Terminal window
    npm install -g openclaw@latest
  2. Register Vikey. Replace YOUR_API_KEY and the model as needed:

    Terminal window
    openclaw onboard --non-interactive --accept-risk \
    --auth-choice custom-api-key \
    --custom-provider-id vikey \
    --custom-base-url "https://api.vikey.ai/v1" \
    --custom-model-id "vikey/agent-gpt" \
    --custom-api-key "YOUR_API_KEY" \
    --custom-compatibility openai-responses \
    --gateway-port 18789 \
    --skip-health
  3. Start the OpenClaw gateway and select the model:

    Terminal window
    openclaw gateway --port 18789 --verbose
    openclaw models set vikey/vikey/agent-gpt
Flag Purpose
--custom-provider-id vikey The provider name in OpenClaw. Models are called as vikey/<model-id>.
--custom-base-url With /v1.
--custom-model-id A Vikey model id, such as vikey/agent-gpt or anthropic/claude-sonnet-5.5.
--custom-api-key Your Vikey API key. When omitted, OpenClaw reads the CUSTOM_API_KEY variable.
--custom-compatibility The API format. Vikey supports openai-responses, openai (chat completions) and anthropic.
What you see Cause Fix
--custom-compatibility rejected An older OpenClaw Update OpenClaw, or use the value openai
401 Wrong API key Repeat step 2 with the right key
Model '...' not found A typo in the model id Copy the id from the pricing page