Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.clearmaas.com/llms.txt

Use this file to discover all available pages before exploring further.

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:
FieldDescription
baseUrlMust include /v1 suffix for OpenAI-compatible APIs
apiSet to "openai-completions" for OpenAI-compatible endpoints
modelsList of exact model IDs available through this provider
idThe ClearMaas model ID (provider/model-name)

​
Model ID format

All ClearMaas models use the provider/model-name pattern:
Model IDDescription
anthropic/claude-sonnet-4.6Claude Sonnet 4.6
anthropic/claude-opus-4.8Claude Opus 4.8
openai/gpt-4o-miniGPT-4o Mini
openai/gpt-4oGPT-4o
google/gemini-2.5-proGemini 2.5 Pro
deepseek/deepseek-chatDeepSeek Chat
grok/grok-4-fast-reasoningGrok 4 Fast
qwen/qwen3.6-plusQwen 3.6 Plus
kimi/kimi-k2.6Kimi 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:
  1. Start OpenClaw
  2. 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
          }
        ]
      }
    }
  }
}

​
See also