Alibaba Cloud Model Studio:OpenClaw

Manual installation

1. Install or update Node.js

   1. Check your current version: Run the following command in your terminal to view your Node.js version (must be v22.0 or higher). If you see “command not found,” Node.js is not installed. If the version shown is lower than v22.0, you must update it.

      To open the terminal: On macOS, press Command + Space → type Terminal → press Enter. On Windows, press the Win key → type Terminal/PowerShell/cmd → press Enter.

      node -v

   2. Download and install: Visit Node.js, select the “LTS” version with version >= 22.x.x, and download the installer for your operating system. Install after downloading.

      For example: On Windows, download Windows Installer (.msi). On macOS, download macOS Installer (.pkg).

2. Run the following command to start installing OpenClaw.

   1. macOS/Linux:

      Press Command + Space, type Terminal, and press Enter. Then run the following command:

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

   2. Windows:

      In the taskbar search box, type PowerShell, choose Run as administrator, and run the following command in PowerShell:

      iwr -useb https://openclaw.ai/install.ps1 | iex

3. After installation completes, a prompt appears automatically. Follow the prompts to finish configuring OpenClaw. Refer to the sample configuration below:

   Configuration item	Configuration Content
   I understand this is powerful and inherently risky. Continue?	Select “Yes”
   Onboarding mode	Select “QuickStart”
   Model/auth provider	Select “Skip for now”; you can configure it later
   Filter models by provider	Select “All providers”
   Default model	Use default configuration
   Select channel (QuickStart)	Select “Skip for now”; you can configure it later
   Configure skills now? (recommended)	Select “No”; you can configure it later.
   Enable hooks?	Press the space bar to select “Skip for now,” then press Enter to proceed.
   How do you want to hatch your bot?	Select “Hatch in TUI.”

Qwen Code guided installation

OpenClaw installation depends on a Node.js environment. Manual installation may encounter environment configuration issues. You can use Qwen Code to complete installation and verification.

1. Install and configure Qwen Code.

2. Run the following command in your terminal to start Qwen Code.

   qwen

3. Enter the following instructions in the Qwen Code dialog box.

   1. macOS/Linux:

        Help me install OpenClaw by running the following commands in order:
      
        1. Prerequisite: Install Node.js (v22.0 or higher). Check with node --version. If already installed but below v22.0, upgrade without uninstalling the existing version.
        2. curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
        3. openclaw gateway install
        4. openclaw onboard --non-interactive --accept-risk --flow quickstart --auth-choice skip --skip-channels --skip-skills
        5. Run openclaw status to confirm OpenClaw is running normally

   2. Windows:

      Help me install OpenClaw on Windows by following these steps:
      
      ## Execution instructions
      
      Run all PowerShell commands using this format:
      ```
      powershell -ExecutionPolicy Bypass -Command "<command>"
      ```
      
      ### Notes:
      1. Use the `write_file` tool to create multi-line files instead of here-string syntax.
      2. After modifying environment variables, explicitly refresh `$env:Path` to use them in the same session.
      3. Set a longer timeout (≥120000 ms) for network download commands.
      
      ---
      
      ## Step 1: Check prerequisites
      
      Verify these tools are installed and output their versions:
      - `node --version` (requires v22 or higher)
      - `npm --version`
      - `git --version`
      
      If all are installed and Node.js ≥ v22, skip to Step 4.
      
      ---
      
      ## Step 2: Install Node.js (if missing or below v22)
      
      1. Detect system architecture (x64 / x86 / ARM64).
      2. Download and extract Node.js zip from the official source:
      ```
      powershell -ExecutionPolicy Bypass -Command "$ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest -Uri 'https://nodejs.org/dist/v24.0.0/node-v24.0.0-win-x64.zip' -OutFile \"$env:TEMP\node24.zip\"; Expand-Archive \"$env:TEMP\node24.zip\" -DestinationPath \"$env:LOCALAPPDATA\nodejs-v24\" -Force; Remove-Item \"$env:TEMP\node24.zip\""
      ```
      3. Add to system PATH (permanent; new terminals will recognize it):
      ```
      powershell -ExecutionPolicy Bypass -Command "$nodePath = \"$env:LOCALAPPDATA\nodejs-v24\node-v24.0.0-win-x64\"; $machinePath = [Environment]::GetEnvironmentVariable('PATH', 'Machine'); [Environment]::SetEnvironmentVariable('PATH', \"$nodePath;$machinePath\", 'Machine'); $env:Path = \"$nodePath;$env:Path\"; node --version; npm --version"
      ```
      
      ---
      
      ## Step 3: Install Git (if missing)
      
      1. Download and silently install Git from the official source:
      ```
      powershell -ExecutionPolicy Bypass -Command "$ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest -Uri 'https://github.com/git-for-windows/git/releases/download/v2.53.0.windows.2/Git-2.53.0.2-64-bit.exe' -OutFile \"$env:TEMP\Git-Installer.exe\"; Start-Process -FilePath \"$env:TEMP\Git-Installer.exe\" -ArgumentList '/VERYSILENT','/NORESTART','/NOCANCEL','/SP-','/CLOSEAPPLICATIONS','/RESTARTAPPLICATIONS','/COMPONENTS=icons,ext\reg\shellhere,assoc,assoc_sh' -Wait; Remove-Item \"$env:TEMP\Git-Installer.exe\""
      ```
      2. Refresh PATH and verify installation:
      ```
      powershell -ExecutionPolicy Bypass -Command "$machinePath = [Environment]::GetEnvironmentVariable('PATH', 'Machine'); $env:Path = \"$machinePath;$env:Path\"; git --version"
      ```
      
      ---
      
      ## Step 4: Install OpenClaw
      
      Refresh PATH and install globally:
      ```
      powershell -ExecutionPolicy Bypass -Command "$machinePath = [Environment]::GetEnvironmentVariable('PATH', 'Machine'); $userPath = [Environment]::GetEnvironmentVariable('PATH', 'User'); $env:Path = \"$machinePath;$userPath;$env:Path\"; npm install -g openclaw@latest"
      ```
      
      ---
      
      ## Step 5: Verify installation
      
      ```
      powershell -ExecutionPolicy Bypass -Command "$machinePath = [Environment]::GetEnvironmentVariable('PATH', 'Machine'); $userPath = [Environment]::GetEnvironmentVariable('PATH', 'User'); $env:Path = \"$machinePath;$userPath;$env:Path\"; openclaw --version"
      ```
      
      ---
      
      ## Step 6: Install Gateway
      
      ```
      openclaw gateway install
      ```
      
      ---
      
      ## Step 7: Auto-complete initial configuration
      
      Use the `write_file` tool to create a config file for QuickStart mode:
      
      Config file path: `%USERPROFILE%\.openclaw\config.yaml`
      
      Config file content:
      ```yaml
      # OpenClaw Configuration - QuickStart mode
      
      workspace:
        name: default
        directory: .
      
      gateway:
        mode: local
        auth:
          token: openclaw-quickstart-token
      
      session:
        scope: personal
        dmScope: per-channel
      
      channels:
        - type: tui
          enabled: true
      
      skills:
        enabled: false
      
      hooks:
        enabled: false
      
      security:
        acknowledged: true
        mode: personal
      
      ui:
        hatch: tui
      ```
      
      After creating the config file, run:
      ```
      powershell -ExecutionPolicy Bypass -Command "[Environment]::SetEnvironmentVariable('OPENCLAW_GATEWAY_TOKEN', 'openclaw-quickstart-token', 'User')"
      ```
      
      ---
      
      ## Step 8: Start and use
      
      ```
      # Launch TUI interface
      openclaw tui
      
      # Or check status
      openclaw status
      
      # View Dashboard (visit in browser)
      # http://127.0.0.1:18789/
      ```

4. Grant permission for Qwen Code to execute commands until installation completes.

5. Type /exit to exit Qwen Code.

   /exit

Method 1: Qwen Code guided configuration

1. Install and configure Qwen Code.

2. Run the following command in your terminal to start Qwen Code.

   qwen

3. Enter the following instruction in the Qwen Code dialog box.

   Help me configure OpenClaw to connect to Coding Plan by following these steps:
   
   ## Step 1: Get API Key
   First ask the user: "Please provide your Coding Plan API Key."
   Wait for the user's reply before proceeding.
   
   ## Step 2: Modify configuration file
   1. Open the configuration file: ~/.openclaw/openclaw.json
      - Create the file if it does not exist
      - Important: Must use .json format, not other formats
   
   2. Locate or create the following fields and merge the configuration (keep existing settings unchanged; add new fields if missing):
      - Use "mode": "merge" to avoid overwriting existing configuration
      - Replace YOUR_API_KEY with the actual API Key provided by the user
   {
     "models": {
       "mode": "merge",
       "providers": {
         "bailian": {
           "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
           "apiKey": "YOUR_API_KEY",
           "api": "openai-completions",
           "models": [
             {
               "id": "qwen3.5-plus",
               "name": "qwen3.5-plus",
               "reasoning": false,
               "input": ["text", "image"],
               "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
               "contextWindow": 1000000,
               "maxTokens": 65536,
               "compat": {
                 "thinkingFormat": "qwen"
               }
             },
             {
               "id": "qwen3-max-2026-01-23",
               "name": "qwen3-max-2026-01-23",
               "reasoning": false,
               "input": ["text"],
               "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
               "contextWindow": 262144,
               "maxTokens": 65536,
               "compat": {
                 "thinkingFormat": "qwen"
               }
             },
             {
               "id": "qwen3-coder-next",
               "name": "qwen3-coder-next",
               "reasoning": false,
               "input": ["text"],
               "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
               "contextWindow": 262144,
               "maxTokens": 65536
             },
             {
               "id": "qwen3-coder-plus",
               "name": "qwen3-coder-plus",
               "reasoning": false,
               "input": ["text"],
               "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
               "contextWindow": 1000000,
               "maxTokens": 65536
             },
             {
               "id": "MiniMax-M2.5",
               "name": "MiniMax-M2.5",
               "reasoning": false,
               "input": ["text"],
               "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
               "contextWindow": 196608,
               "maxTokens": 32768
             },
             {
               "id": "glm-5",
               "name": "glm-5",
               "reasoning": false,
               "input": ["text"],
               "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
               "contextWindow": 202752,
               "maxTokens": 16384,
               "compat": {
                 "thinkingFormat": "qwen"
               }
             },
             {
               "id": "glm-4.7",
               "name": "glm-4.7",
               "reasoning": false,
               "input": ["text"],
               "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
               "contextWindow": 202752,
               "maxTokens": 16384,
               "compat": {
                 "thinkingFormat": "qwen"
               }
             },
             {
               "id": "kimi-k2.5",
               "name": "kimi-k2.5",
               "reasoning": false,
               "input": ["text", "image"],
               "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
               "contextWindow": 262144,
               "maxTokens": 32768,
               "compat": {
                 "thinkingFormat": "qwen"
               }
             }
           ]
         }
       }
     },
     "agents": {
       "defaults": {
         "model": {
           "primary": "bailian/qwen3.5-plus"
         },
         "models": {
           "bailian/qwen3.5-plus": {},
           "bailian/qwen3-max-2026-01-23": {},
           "bailian/qwen3-coder-next": {},
           "bailian/qwen3-coder-plus": {},
           "bailian/MiniMax-M2.5": {},
           "bailian/glm-5": {},
           "bailian/glm-4.7": {},
           "bailian/kimi-k2.5": {}
         }
       }
     },
     "gateway": {
       "mode": "local"
     }
   } 
   3. Save the file
   
   ## Step 3: Restart and verify
   1. Run `openclaw gateway restart` to apply the configuration
   2. Run `openclaw models list` to verify success
      - Check that models starting with `bailian/` appear in the output
      - Check that each model has a `configured` tag
      - Fix any errors based on error messages

4. Grant permission for Qwen Code to execute commands until configuration completes.

5. After configuration completes, Qwen Code outputs the result of openclaw models list. If models such as bailian/qwen3.5-plus are marked as configured, the setup succeeded.

Method 2: Graphical interface configuration

If you deployed OpenClaw using the Simple Application Server deployment solution, configure Coding Plan through the product’s graphical interface. For details, see Simple server configuration method.

Method 3: Direct configuration file modification

Web browser

1. Open a new terminal and run the following command. Your browser will automatically open the OpenClaw dashboard.

   openclaw dashboard

2. Start a conversation.

   

Terminal command line

1. Open a new terminal and run the following command.

   openclaw tui

2. Start a conversation.