OpenClaw

OpenClaw is a cross-platform AI assistant platform supporting multiple models and chat channels. Connect it to ClearMaas to unlock 570+ models including Claude, GPT, Grok, DeepSeek, Qwen, GLM, Kimi, and Doubao.

Prerequisites

OpenClaw installed (openclaw.dev or via GitHub)
A ClearMaas API key starting with sk-

Config file location

OpenClaw’s configuration lives at ~/.openclaw/openclaw.json (legacy path: ~/.clawdbot/clawdbot.json).

Adding ClearMaas as a provider

Add a provider entry under models.providers:

{
  "models": {
    "providers": {
      "clearmaas": {
        "baseUrl": "https://api.clearmaas.com/v1",
        "apiKey": "sk-...",
        "api": "openai-completions",
        "models": [
          {
            "id": "anthropic/claude-sonnet-4.6",
            "name": "Claude Sonnet 4.6",
            "contextWindow": 200000,
            "maxTokens": 8192
          },
          {
            "id": "openai/gpt-4o-mini",
            "name": "GPT-4o Mini",
            "contextWindow": 128000,
            "maxTokens": 16384
          }
        ]
      }
    }
  }
}

Key fields:

Field	Description
`baseUrl`	Must include `/v1` suffix for OpenAI-compatible APIs
`api`	Set to `"openai-completions"` for OpenAI-compatible endpoints
`models`	List of exact model IDs available through this provider
`id`	The ClearMaas model ID (`provider/model-name`)

Model ID format

All ClearMaas models use the provider/model-name pattern:

Model ID	Description
`anthropic/claude-sonnet-4.6`	Claude Sonnet 4.6
`anthropic/claude-opus-4.8`	Claude Opus 4.8
`openai/gpt-4o-mini`	GPT-4o Mini
`openai/gpt-4o`	GPT-4o
`google/gemini-2.5-pro`	Gemini 2.5 Pro
`deepseek/deepseek-chat`	DeepSeek Chat
`grok/grok-4-fast-reasoning`	Grok 4 Fast
`qwen/qwen3.6-plus`	Qwen 3.6 Plus
`kimi/kimi-k2.6`	Kimi K2.6

Model allowlist requirement

OpenClaw requires you to explicitly list allowed models under models. Requests for models not in this list return a “model not allowed” error. Add all models you intend to use.

Automated setup

Instead of editing the config manually, you can ask OpenClaw to add the provider:

Start OpenClaw
Describe your provider in natural language:
“Add ClearMaas as a provider with API key sk-… and models anthropic/claude-sonnet-4.6 and openai/gpt-4o-mini”

Switching providers

After setup, select ClearMaas as your active provider:

In the OpenClaw UI, choose clearmaas from the provider selector
Or use a command: /provider clearmaas

Verification

openclaw models list

You should see the ClearMaas models listed under the clearmaas provider. Alternatively, send a message and check your ClearMaas dashboard to confirm the request was routed.

Full config example

{
  "models": {
    "providers": {
      "clearmaas": {
        "baseUrl": "https://api.clearmaas.com/v1",
        "apiKey": "sk-...",
        "api": "openai-completions",
        "models": [
          {
            "id": "anthropic/claude-sonnet-4.6",
            "name": "Claude Sonnet 4.6",
            "contextWindow": 200000,
            "maxTokens": 8192
          },
          {
            "id": "openai/gpt-4o",
            "name": "GPT-4o",
            "contextWindow": 128000,
            "maxTokens": 16384
          },
          {
            "id": "anthropic/claude-opus-4.8",
            "name": "Claude Opus 4.8",
            "contextWindow": 200000,
            "maxTokens": 8192
          },
          {
            "id": "google/gemini-2.5-pro",
            "name": "Gemini 2.5 Pro",
            "contextWindow": 1048576,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

AI Agents

Prerequisites

Config file location

Adding ClearMaas as a provider

Model ID format

Model allowlist requirement

Automated setup

Switching providers

Verification

Full config example

See also

​Prerequisites

​Config file location

​Adding ClearMaas as a provider

​Model ID format

​Model allowlist requirement

​Automated setup

​Switching providers

​Verification

​Full config example

​See also

Prerequisites

Config file location

Adding ClearMaas as a provider

Model ID format

Model allowlist requirement

Automated setup

Switching providers

Verification

Full config example

See also