Skip to main content

Quick Setup

1

Get your API key

Sign up at kymaapi.com/signup. You’ll get your API key instantly + $0.50 free credits.
2

Configure OpenClaw

Edit ~/.openclaw/openclaw.json:
Replace ky-YOUR_API_KEY_HERE with your actual key.
Use 127.0.0.1 instead of localhost if you experience IPv6 connection issues.
3

Start coding

That’s it. OpenClaw will use Gemma 4 31B by default. Switch models anytime by changing the primary field.
Use model aliases like code or best — they auto-update when better models become available.

Choosing a model

  • Agentic coding: Use agent (Kimi K2.5) for autonomous tool use
  • Code generation: Use code (Qwen 3 Coder) for code-focused tasks
  • Quality: Use best (Qwen 3.6 Plus) for complex reasoning
  • Budget / long context: Use cheap (Gemini 2.5 Flash)

Switch Models

Change the default model in your config:
Or add multiple models and switch between them in OpenClaw.

Auto-Failover

Kyma automatically handles provider failures:
  • If the primary infrastructure for your model is down, Kyma retries on backup infrastructure
  • Most failures are invisible — you get a response without noticing
  • Check X-Kyma-Fallback response header to know if a fallback was used

Troubleshooting

Make sure you’re using https://kymaapi.com/v1 (not localhost). Kyma is a cloud API — no local setup needed.
Check the model ID is correct. Use GET https://kymaapi.com/v1/models to see all available models.
Your free 0.50creditsmayhavebeenusedup.Addmorecreditsat[kymaapi.com/dashboard/credits](https://kymaapi.com/dashboard/credits).Packagesstartat0.50 credits may have been used up. Add more credits at [kymaapi.com/dashboard/credits](https://kymaapi.com/dashboard/credits). Packages start at 5.
Try a faster model like qwen-3-32b. Larger models (DeepSeek V3, Qwen 3.6 Plus) take longer but produce higher quality output.

Audio Models (optional)

OpenClaw runs as your primary agent, but if you build voice-enabled tooling on the side (call summaries, transcript pipelines, voice notes), Kyma’s audio aliases drop in like any chat model:
  • transcribewhisper-v3-turbo — 228× realtime speech-to-text
  • audio-understandgemini-3-flash-audio — scene/tone/music recognition
Use them via POST /v1/audio/transcriptions and POST /v1/audio/understand. The full audio surface (TTS, music, SFX, voice clone/design) is documented in the Audio API reference and Model Aliases.

Prompt Caching

Prompt caching is automatic. Your system prompt and tool definitions are cached for 5 minutes, reducing costs by up to 90% on subsequent requests. No code changes needed. See Prompt Caching for details.