OpenClaw - Qwen Cloud

OpenClaw is an open-source personal AI assistant platform that supports AI interaction through multiple messaging channels. Connect it to Qwen Cloud via Token Plan (Team Edition), Coding Plan, or pay-as-you-go billing.

Install OpenClaw

OpenClaw requires Node.js 22 or later. Run the following command to check your Node.js version:

node --version

If Node.js is not installed or the version is too low, visit the Node.js website to download and install it.

macOS / Linux
Windows

Use the official install script (recommended):

curl -fsSL https://openclaw.ai/install.sh | bash

Or install globally via npm:

npm install -g openclaw@latest

After first-time installation, OpenClaw automatically starts the setup wizard. You can also manually run the openclaw onboard command to start the wizard.

Setting	Recommended
I understand this is powerful and inherently risky. Continue?	Select Yes
Onboarding mode	Select QuickStart
Model/auth provider	Select Skip for now (configure Qwen Cloud models later)
Filter models by provider	Select All providers
Default model	Select Keep current
Select channel (QuickStart)	Select Skip for now (configure channels later)
Configure skills now? (recommended)	Select No
Enable hooks?	Press Space to select options, then press Enter to proceed
How do you want to hatch your bot?	Select Do this later

Configure credentials

OpenClaw provides two configuration methods: Web console or config file.

Web console
Config file

Run the following command in the terminal:

openclaw dashboard

The browser will automatically open the console page (usually http://127.0.0.1:18789).

In the left menu, navigate to Configure > RAW (or Config > RAW).
Replace the "agents": {...} section with the configuration for your chosen plan, and replace YOUR_API_KEY with your API Key.

To keep existing settings, do not overwrite the entire file. Merge the models and agents sections carefully.

Token Plan (Team Edition)

Replace YOUR_API_KEY with the Token Plan (Team Edition) dedicated API Key. For available models, see Token Plan (Team Edition) supported models.

Parameter	Value
API Key	Token Plan (Team Edition) dedicated API Key
Base URL	`https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1`
Available models	Token Plan (Team Edition) supported models

"models": {
  "mode": "merge",
  "providers": {
    "bailian-token-plan": {
      "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
      "apiKey": "YOUR_API_KEY",
      "api": "openai-completions",
      "models": [
        {
          "id": "qwen3.6-plus",
          "name": "qwen3.6-plus",
          "reasoning": false,
          "input": ["text", "image"],
          "contextWindow": 1000000,
          "maxTokens": 65536,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "compat": { "thinkingFormat": "qwen" }
        },
        {
          "id": "qwen3.6-flash",
          "name": "qwen3.6-flash",
          "reasoning": false,
          "input": ["text", "image"],
          "contextWindow": 1000000,
          "maxTokens": 32768,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "compat": { "thinkingFormat": "qwen" }
        },
        {
          "id": "deepseek-v4-pro",
          "name": "deepseek-v4-pro",
          "reasoning": false,
          "input": ["text"],
          "contextWindow": 163840,
          "maxTokens": 32768,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
        },
        {
          "id": "deepseek-v4-flash",
          "name": "deepseek-v4-flash",
          "reasoning": false,
          "input": ["text"],
          "contextWindow": 163840,
          "maxTokens": 16384,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
        },
        {
          "id": "deepseek-v3.2",
          "name": "deepseek-v3.2",
          "reasoning": false,
          "input": ["text"],
          "contextWindow": 163840,
          "maxTokens": 16384,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "compat": { "thinkingFormat": "qwen" }
        },
        {
          "id": "kimi-k2.6",
          "name": "kimi-k2.6",
          "reasoning": false,
          "input": ["text", "image"],
          "contextWindow": 262144,
          "maxTokens": 32768,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "compat": { "thinkingFormat": "qwen" }
        },
        {
          "id": "kimi-k2.5",
          "name": "kimi-k2.5",
          "reasoning": false,
          "input": ["text", "image"],
          "contextWindow": 262144,
          "maxTokens": 32768,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "compat": { "thinkingFormat": "qwen" }
        },
        {
          "id": "glm-5.1",
          "name": "glm-5.1",
          "reasoning": false,
          "input": ["text"],
          "contextWindow": 202752,
          "maxTokens": 16384,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "compat": { "thinkingFormat": "qwen" }
        },
        {
          "id": "glm-5",
          "name": "glm-5",
          "reasoning": false,
          "input": ["text"],
          "contextWindow": 202752,
          "maxTokens": 16384,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "compat": { "thinkingFormat": "qwen" }
        },
        {
          "id": "MiniMax-M2.5",
          "name": "MiniMax-M2.5",
          "reasoning": false,
          "input": ["text"],
          "contextWindow": 196608,
          "maxTokens": 32768,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
        }
      ]
    }
  }
},
"agents": {
  "defaults": {
    "model": {
      "primary": "bailian-token-plan/qwen3.6-plus"
    },
    "models": {
      "bailian-token-plan/qwen3.6-plus": {},
      "bailian-token-plan/qwen3.6-flash": {},
      "bailian-token-plan/deepseek-v4-pro": {},
      "bailian-token-plan/deepseek-v4-flash": {},
      "bailian-token-plan/deepseek-v3.2": {},
      "bailian-token-plan/kimi-k2.6": {},
      "bailian-token-plan/kimi-k2.5": {},
      "bailian-token-plan/glm-5.1": {},
      "bailian-token-plan/glm-5": {},
      "bailian-token-plan/MiniMax-M2.5": {}
    }
  }
},

To add more models, add model definitions in providers.bailian-token-plan.models, and add agents.defaults.models entries in "bailian-token-plan/model-ID": {}.

Coding Plan

Replace YOUR_API_KEY with the Coding Plan dedicated API Key. For available models, see Coding Plan supported models.

Parameter	Value
API Key	Coding Plan dedicated API Key
Base URL	`https://coding-intl.dashscope.aliyuncs.com/compatible-mode/v1`
Available models	Coding Plan supported models

"models": {
  "mode": "merge",
  "providers": {
    "bailian-coding-plan": {
      "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/compatible-mode/v1",
      "apiKey": "YOUR_API_KEY",
      "api": "openai-completions",
      "models": [
        {
          "id": "qwen3.6-plus",
          "name": "qwen3.6-plus",
          "reasoning": false,
          "input": ["text", "image"],
          "contextWindow": 1000000,
          "maxTokens": 65536,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "compat": { "thinkingFormat": "qwen" }
        },
        {
          "id": "qwen3-coder-plus",
          "name": "qwen3-coder-plus",
          "reasoning": false,
          "input": ["text"],
          "contextWindow": 131072,
          "maxTokens": 65536,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
        }
      ]
    }
  }
},
"agents": {
  "defaults": {
    "model": {
      "primary": "bailian-coding-plan/qwen3.6-plus"
    },
    "models": {
      "bailian-coding-plan/qwen3.6-plus": {},
      "bailian-coding-plan/qwen3-coder-plus": {}
    }
  }
},

Pay-as-you-go

Replace YOUR_API_KEY with your Qwen Cloud API Key. For available models, see supported models.

Parameter	Value
API Key	Your Qwen Cloud API Key
Base URL	`https://dashscope-intl.aliyuncs.com/compatible-mode/v1`
Available models	Supported models

"models": {
  "mode": "merge",
  "providers": {
    "qwencloud": {
      "baseUrl": "https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
      "apiKey": "YOUR_API_KEY",
      "api": "openai-completions",
      "models": [
        {
          "id": "qwen3.6-plus",
          "name": "qwen3.6-plus",
          "reasoning": false,
          "input": ["text", "image"],
          "contextWindow": 1000000,
          "maxTokens": 65536,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "compat": { "thinkingFormat": "qwen" }
        }
      ]
    }
  }
},
"agents": {
  "defaults": {
    "model": {
      "primary": "qwencloud/qwen3.6-plus"
    },
    "models": {
      "qwencloud/qwen3.6-plus": {}
    }
  }
},

Verify configuration

Enable the local gateway

Run the following command to enable the local gateway:

openclaw config set gateway.mode local

Start and test

openclaw gateway  # Start the gateway
openclaw tui      # Open terminal UI

Type a message to confirm the model responds normally. If it does, the configuration is complete.

Common commands

Command	Description	Example
`/help`	Display available commands	`/help`
`/status`	View current model, session, and gateway status	`/status`
`/model <model_name>`	Switch the model for the current session	`/model qwen3.6-plus`
`/new`	Start a new session	`/new`
`/compact`	Compress conversation history to free up context window	`/compact`
`/think <level>`	Set thinking (reasoning) depth: off, low, medium, high	`/think high`
`/skills`	Display all available Skills	`/skills`

FAQ

Error codes

If you encounter errors during configuration, refer to the FAQ documentation for the corresponding billing plan:

Pay-as-you-go: Error codes and troubleshooting
Coding Plan: Coding Plan FAQ
Token Plan (Team Edition): Token Plan (Team Edition) FAQ

"Gateway start blocked" error

Run openclaw config set gateway.mode local to enable the local gateway, or pass the --allow-unconfigured flag: openclaw gateway --allow-unconfigured.

How to view configured models

Run openclaw tui to open the terminal UI, then type /model to view the model list. Press Enter to select a model, or press Esc to exit.

Safely adding new plan models without losing existing configurations

Do not overwrite the entire ~/.openclaw/openclaw.json file. Make partial modifications instead — only edit the fields that need to change and keep existing configuration intact. After saving, restart the gateway with openclaw gateway restart.

"Device identity required" error

Error message:

code=1008 reason=device identity required

The client did not provide device identity information when connecting to the gateway. This usually happens on first browser visit, after clearing browser cache, or when key files in ~/.openclaw/identity/ are missing. Solution: Run the following commands to approve the device and regenerate the browser access URL:

openclaw devices approve --latest
openclaw dashboard --no-open

If the issue persists, clear pending device records and try again:

openclaw devices clear --pending --yes
openclaw dashboard --no-open

​Install OpenClaw

​Configure credentials

​Token Plan (Team Edition)

​Coding Plan

​Pay-as-you-go

​Verify configuration

​Enable the local gateway

​Start and test

​Common commands

​FAQ

​Error codes

​"Gateway start blocked" error

​How to view configured models

​Safely adding new plan models without losing existing configurations

​"Device identity required" error

Install OpenClaw

Configure credentials

Token Plan (Team Edition)

Coding Plan

Pay-as-you-go

Verify configuration

Enable the local gateway

Start and test

Common commands

FAQ

Error codes

"Gateway start blocked" error

How to view configured models

Safely adding new plan models without losing existing configurations

"Device identity required" error