# OpenClaw with zurelay

> Open-source personal assistant on your devices.

Source: https://zurelay.com/docs/integrations/openclaw

The examples use `claude-opus-5-5`. Any model ID from [the models page](https://zurelay.com/docs/models) works.

## Set it up

1. Put `ZURELAY_API_KEY=…` in `~/.openclaw/.env`.
2. Add zurelay as a custom provider in `~/.openclaw/openclaw.json` and make it the default model.
3. Restart with `openclaw gateway restart`. Switch later with `openclaw models set zurelay/<model-id>`.

## Configuration

**openclaw.json** (`~/.openclaw/openclaw.json`):

```json
{
  agents: {
    defaults: { model: { primary: "zurelay/claude-opus-5-5" } },
  },
  models: {
    mode: "merge",
    providers: {
      zurelay: {
        baseUrl: "https://api.zurelay.com/v1",
        apiKey: "${ZURELAY_API_KEY}",
        api: "openai-completions",
        models: [
          { id: "claude-opus-5-5", name: "Claude Opus 5.5" },
          { id: "gpt-6-astra", name: "GPT-6 Astra" },
          { id: "claude-sonnet-5-5", name: "Claude Sonnet 5.5" },
          { id: "gpt-6.1-sol", name: "GPT-6.1 Sol" },
          { id: "gpt-6-sol", name: "GPT-6 Sol" },
          { id: "gpt-6-luna", name: "GPT-6 Luna" },
          { id: "grok-4.7", name: "Grok 4.7" },
          { id: "mimo-v2.6-pro", name: "MiMo V2.6 Pro" },
          { id: "mimo-v2.6-flash", name: "MiMo V2.6 Flash" },
          { id: "deepseek-v4.1-flash", name: "DeepSeek V4.1 Flash" },
          { id: "deepseek-v4-flash", name: "DeepSeek V4 Flash" },
          { id: "deepseek-v4-flash-0731", name: "DeepSeek V4 Flash 0731" },
          { id: "deepseek-v4-pro-0813", name: "DeepSeek V4 Pro 0813" },
          { id: "claude-fable-5-1", name: "Claude Fable 5.1" },
          { id: "claude-fable-5", name: "Claude Fable 5" },
          { id: "claude-opus-5", name: "Claude Opus 5" },
          { id: "claude-opus-4-8", name: "Claude Opus 4.8" },
          { id: "claude-opus-4-7", name: "Claude Opus 4.7" },
          { id: "claude-opus-4-6", name: "Claude Opus 4.6" },
          { id: "claude-haiku-4-5", name: "Claude Haiku 4.5" },
          { id: "gpt-5.6-sol", name: "GPT-5.6 Sol" },
          { id: "gpt-5.6-terra", name: "GPT-5.6 Terra" },
          { id: "gpt-5.6-luna", name: "GPT-5.6 Luna" },
          { id: "gemini-3.7-flash", name: "Gemini 3.7 Flash" },
          { id: "gemini-3.5-flash-lite", name: "Gemini 3.5 Flash-Lite" },
          { id: "gemini-3.1-flash-lite", name: "Gemini 3.1 Flash-Lite" },
          { id: "glm-5.3", name: "GLM-5.3" },
          { id: "glm-5.2", name: "GLM-5.2" },
          { id: "kimi-k3", name: "Kimi K3" },
          { id: "qwen3.8-max", name: "Qwen 3.8 Max" },
          { id: "qwen3.8-flash", name: "Qwen 3.8 Flash" },
          { id: "qwen3.8-omni-flash", name: "Qwen 3.8 Omni Flash" },
          { id: "hy4-preview", name: "HY4 Preview" },
          { id: "minimax-m2.7", name: "MiniMax M2.7" },
        ],
      },
    },
  },
}
```

**Onboarding** (`terminal`):

```bash
openclaw onboard --auth-choice custom-api-key \
  --custom-base-url "https://api.zurelay.com/v1" \
  --custom-model-id "claude-opus-5-5" \
  --custom-api-key "$ZURELAY_API_KEY" \
  --custom-compatibility openai
```

> **Note:** Use the `openai-completions` API, not `openai-responses`: zurelay serves Chat Completions.

[OpenClaw’s own docs](https://docs.openclaw.ai/concepts/model-providers/custom-providers)