Updated · SI-API

DEVELOPER GUIDES

OpenClaw setup

Configure all seven models once for the TUI and browser Control UI, using the same key.

One connection. All seven models.

Set up your Agent once, then switch models and reasoning effort in the same session.

Download all-model configuration ZIP ↗

Prefer to skip manual setup? Ask AI to do it for you.

AI setup prompt

Follow https://siapi.ai/docs/openclaw?model=deepseek-flash&surface=cli&platform=macos to connect my Agent to all SI-API models. Preserve existing settings and ask for my API key when needed.

  • GLM 5.3 Flash
  • DeepSeek V4.1 Flash
  • Kimi K3.1 Pro
  • Kimi K3.1 Pro HighSpeed
  • GLM 5.3
  • MiniMax M3.1 Flash
  • Qwen3.8 Max

All seven models are in this download. Keep the same configuration when switching models. Get your API key →

1. Prepare your tool and key

Install OpenClaw from its official page. Create or copy your SI-API key from /keys.

Official installation guide ↗

Save the configuration and key on the machine running your OpenClaw Gateway, not just the browser opening the Control UI.

2. Save the configuration

Download and extract the ZIP. Replace YOUR_SIAPI_API_KEY with your key, then save each file to the path below. Merge these fields into an existing file, preserving other providers, permissions and preferences. Do not replace an existing configuration wholesale.

Configuration location: ~/.openclaw

openclaw.json

Save to: ~/.openclaw/openclaw.json

Merge these fields into an existing file, preserving other providers, permissions and preferences. Do not replace an existing configuration wholesale. Preserve agents.defaults.models entries with params.thinking: these supply per-model starting efforts. The provider’s thinkingLevelMap and compat.supportedReasoningEfforts declare the available choices.

View or copy configuration
openclaw.json
{
  "models": {
    "mode": "merge",
    "providers": {
      "siapi": {
        "baseUrl": "https://siapi.ai/v1",
        "apiKey": "${SIAPI_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "glm-5.3-flash",
            "name": "GLM 5.3 Flash",
            "input": [
              "text"
            ],
            "reasoning": true,
            "thinkingLevelMap": {
              "off": null,
              "minimal": null,
              "low": "low",
              "medium": null,
              "high": "high",
              "xhigh": null,
              "max": "max"
            },
            "compat": {
              "supportsDeveloperRole": false,
              "supportsReasoningEffort": true,
              "supportedReasoningEfforts": [
                "low",
                "high",
                "max"
              ]
            }
          },
          {
            "id": "deepseek-flash",
            "name": "DeepSeek V4.1 Flash",
            "input": [
              "text"
            ],
            "reasoning": true,
            "thinkingLevelMap": {
              "off": "none",
              "minimal": null,
              "low": "low",
              "medium": null,
              "high": "high",
              "xhigh": null,
              "max": "max"
            },
            "compat": {
              "supportsDeveloperRole": false,
              "supportsReasoningEffort": true,
              "supportedReasoningEfforts": [
                "none",
                "low",
                "high",
                "max"
              ],
              "reasoningEffortMap": {
                "off": "none"
              }
            }
          },
          {
            "id": "kimi-k3.1-pro",
            "name": "Kimi K3.1 Pro",
            "input": [
              "text"
            ],
            "reasoning": true,
            "thinkingLevelMap": {
              "off": null,
              "minimal": null,
              "low": "low",
              "medium": null,
              "high": "high",
              "xhigh": null,
              "max": "max"
            },
            "compat": {
              "supportsDeveloperRole": false,
              "supportsReasoningEffort": true,
              "supportedReasoningEfforts": [
                "low",
                "high",
                "max"
              ]
            }
          },
          {
            "id": "kimi-k3.1-pro-highspeed",
            "name": "Kimi K3.1 Pro HighSpeed",
            "input": [
              "text"
            ],
            "reasoning": true,
            "thinkingLevelMap": {
              "off": null,
              "minimal": null,
              "low": "low",
              "medium": null,
              "high": "high",
              "xhigh": null,
              "max": "max"
            },
            "compat": {
              "supportsDeveloperRole": false,
              "supportsReasoningEffort": true,
              "supportedReasoningEfforts": [
                "low",
                "high",
                "max"
              ]
            }
          },
          {
            "id": "glm-5.3",
            "name": "GLM 5.3",
            "input": [
              "text"
            ],
            "reasoning": true,
            "thinkingLevelMap": {
              "off": null,
              "minimal": null,
              "low": "low",
              "medium": null,
              "high": "high",
              "xhigh": null,
              "max": "max"
            },
            "compat": {
              "supportsDeveloperRole": false,
              "supportsReasoningEffort": true,
              "supportedReasoningEfforts": [
                "low",
                "high",
                "max"
              ]
            }
          },
          {
            "id": "minimax-m3.1",
            "name": "MiniMax M3.1 Flash",
            "input": [
              "text"
            ],
            "reasoning": false,
            "compat": {
              "supportsDeveloperRole": false,
              "supportsReasoningEffort": false
            }
          },
          {
            "id": "qwen3.8-max",
            "name": "Qwen3.8 Max",
            "input": [
              "text"
            ],
            "reasoning": true,
            "thinkingLevelMap": {
              "off": "none",
              "minimal": null,
              "low": "low",
              "medium": "medium",
              "high": null,
              "xhigh": "xhigh",
              "max": null
            },
            "compat": {
              "supportsDeveloperRole": false,
              "supportsReasoningEffort": true,
              "supportedReasoningEfforts": [
                "none",
                "low",
                "medium",
                "xhigh"
              ],
              "reasoningEffortMap": {
                "off": "none"
              }
            }
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "siapi/deepseek-flash"
      },
      "models": {
        "siapi/glm-5.3-flash": {
          "alias": "glm-5.3-flash",
          "params": {
            "thinking": "max"
          }
        },
        "siapi/deepseek-flash": {
          "alias": "deepseek-flash",
          "params": {
            "thinking": "high"
          }
        },
        "siapi/kimi-k3.1-pro": {
          "alias": "kimi-k3.1-pro",
          "params": {
            "thinking": "max"
          }
        },
        "siapi/kimi-k3.1-pro-highspeed": {
          "alias": "kimi-k3.1-pro-highspeed",
          "params": {
            "thinking": "max"
          }
        },
        "siapi/glm-5.3": {
          "alias": "glm-5.3",
          "params": {
            "thinking": "max"
          }
        },
        "siapi/minimax-m3.1": {
          "alias": "minimax-m3.1"
        },
        "siapi/qwen3.8-max": {
          "alias": "qwen3.8-max",
          "params": {
            "thinking": "xhigh"
          }
        }
      }
    }
  }
}

.env.example

Save to: ~/.openclaw/.env

Add the key to the Gateway’s .env, including when it runs as a background service.

View or copy configuration
.env.example
SIAPI_API_KEY=YOUR_SIAPI_API_KEY

3. Start your Agent

Start a new session and send a message. The startup model is deepseek-flash.

Start your Agent
openclaw gateway restart
openclaw models set siapi/deepseek-flash
openclaw tui

4. Switch between all models

After setup, choose any model below inside your Agent. The same key and configuration work for all seven models; no new download or connection is needed.

All 7 models in this Agent configuration
Model / API IDCommand / picker pathThinking settings
GLM 5.3 Flash
glm-5.3-flash
/model siapi/glm-5.3-flashLow, High and Max. Thinking is always enabled; choose Low for less reasoning. The model default is Max.
DeepSeek V4.1 Flash
deepseek-flash
/model siapi/deepseek-flashOff, Low, High and Max. Medium / XHigh map to High; Ultra maps to Max.
Kimi K3.1 Pro
kimi-k3.1-pro
/model siapi/kimi-k3.1-proLow, High and Max. Thinking is always enabled; choose Low for less reasoning. The model default is Max.
Kimi K3.1 Pro HighSpeed
kimi-k3.1-pro-highspeed
/model siapi/kimi-k3.1-pro-highspeedLow, High and Max. Thinking is always enabled; choose Low for less reasoning. The model default is Max.
GLM 5.3
glm-5.3
/model siapi/glm-5.3Low, High and Max. Thinking is always enabled; choose Low for less reasoning. The model default is Max.
MiniMax M3.1 Flash
minimax-m3.1
/model siapi/minimax-m3.1Use the model default. This route does not expose custom thinking controls.
Qwen3.8 Max
qwen3.8-max
/model siapi/qwen3.8-maxOff, Low, Medium and XHigh. High / Max map to XHigh, not additional levels.

5. Choose reasoning effort

Send each command separately inside your Agent. On DeepSeek V4.1 Flash, switch from Low to High before your next message.

Inside your Agent
/think low
/think high

Available effort levels depend on the model; see the table above. MiniMax M3.1 Flash uses its model default.

Effort defaults and saved settings

Start on DeepSeek V4.1 Flash. Choose Low, send a short file-reading task, then choose High and repeat. Check the current setting after each change.

Effort means how much reasoning to request. Kimi K3.1 Pro / HighSpeed, GLM 5.3 and GLM 5.3 Flash offer Low / High / Max with thinking always enabled. Choose Low for shorter reasoning; there is no Off option. Their model default is Max, but a client setting can override it. DeepSeek and Qwen have their own intensity levels listed below.

MiniMax M3.1 Flash uses its default reasoning behavior. MiniMax M3 settings apply to a different model.

The supplied agents.defaults.models entries set params.thinking separately for each supported model: High for DeepSeek, Max for Kimi and GLM, XHigh for Qwen. These defaults are separate from thinkingLevelMap, where null disables an unsupported choice.

Send /think low or /think high as a message by itself to change the saved session setting. /think reports the current level; /status shows the requested and effective settings. Send /think default to clear the session override and inherit the configured default. It does not ask the upstream model to choose a default. Per-agent defaults can still override the shared model settings.

The TUI uses the same local OpenClaw Gateway configuration as the browser Control UI. Recheck /think after changing models or resuming a saved session.

Inside the Agent · send each command separately
/think
/think low
/status
/think high
/status
/think low
  • Restart the local OpenClaw Gateway after updating reasoning, thinkingLevelMap or compat. Higher levels need the supplied supportedReasoningEfforts declaration. Off must map to none; omitting effort does not guarantee thinking is disabled. Agent-specific defaults and session overrides can supersede shared model settings.

Expected: On DeepSeek V4.1 Flash, the current setting changes from Low to High and back to Low before your next message. Other models follow the controls listed below.

OpenClaw thinking levels and custom endpoints ↗

Check the model and run your first task

Check the model and run your first task

Open a project containing README.md. Allow the tool to read it, then send the prompt below. Confirm that it reads the file and returns a summary. To check another model, switch using the table above and repeat this task.

Inside your tool
/model
Send this task in your tool

Use the file-reading tool to read README.md in this project and summarize its purpose in one sentence. Do not modify any files.

Tool-specific notes
  • The model allowlist includes all seven SI-API models. Existing per-agent model choices can override the default.
  • Restart an already installed Gateway after editing its environment. Use the official onboarding guide first if the Gateway has not been installed.

Official configuration reference ↗ · Model configuration

Connection not working? · Usage

Agent compatibility — Client versions, tested reasoning fields and known limits.

Download setup instructions