Alibaba Cloud Model Studio：OpenClaw

手動安裝

1. 安裝或更新 Node.js

   1. 檢查目前的版本：在終端運行以下命令查看：Node.js的版本（需 v22.0 或更高版本）。如果提示“找不到命令”，說明未安裝；如果顯示版本號碼低於 v22.0，說明需要更新。

      進入終端的方法： Mac 系統按 Command + Space（空格） → 輸入 Terminal 或 終端 → 斷行符號，Windows系統按 Win 鍵 → 輸入 終端/PowerShell/cmd → 斷行符號。

      node -v

   2. 下載並安裝：訪問Node.js，在頁面中選擇“LTS” 且版本號碼 >= 22.x.x，並根據系統下載安裝包。下載完安裝即可。

      例如：Windows 系統找到並下載 Windows Installer（.msi），Mac 系統找到並下載 macOS Installer（.pkg）。

2. 執行以下命令開始安裝OpenCLaw。

   1. macOS/Linux：

      按鍵盤上的 Command + Space（空格）按鍵組合， 輸入終端並斷行符號，開啟終端後運行以下命令：

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

   2. Windows：

      在工作列搜尋方塊裡輸入PowerShell，選擇以管理員身份運行，在PowerShell中運行以下命令：

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

3. 安裝結束後會自動出現提示資訊，請根據提示資訊完成 OpenClaw 配置，參考配置如下：

   配置項	配置內容
   I understand this is powerful and inherently risky. Continue?	選擇 ”Yes”
   Onboarding mode	選擇 “QuickStart”
   Model/auth provider	選擇 “Skip for now”，後續可以配置
   Filter models by provider	選擇 “All providers”
   Default model	使用預設配置
   Select channel (QuickStart)	選擇 “Skip for now”，後續可以配置
   Configure skills now? (recommended)	選擇 “No”，後續可以配置。
   Enable hooks?	按空格鍵選中 “Skip for now”，按斷行符號鍵進入下一步。
   How do you want to hatch your bot?	選擇 “Hatch in TUI”。

Qwen Code 引導安裝

OpenClaw 安裝依賴於 Node.js 環境，手動安裝可能會遇到環境配置問題。您可以使用 Qwen Code 來完成安裝和驗證。

1. 安裝並配置Qwen Code。

2. 在終端輸入以下命令啟動 Qwen Code。

   qwen

3. 在 Qwen Code 對話方塊中輸入以下指令。

   1. macOS/Linux：

        請幫我安裝 OpenClaw，依次執行以下命令完成安裝和初始配置：                                                          
        1. 前置條件：需要先安裝 Node.js（v22.0 或更高版本），可通過 node --version 檢查是否已安裝。版本較低時需升級或安裝更高版本，注意不能卸載已有的Node.js。                      
        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. 通過執行openclaw status，確保OpenClaw狀態正常

   2. Windows：

      請幫我在 Windows 上安裝 OpenClaw，按以下步驟依次執行：
      
      ## 執行說明
      
      所有 PowerShell 命令請使用以下格式執行：
      ```
      powershell -ExecutionPolicy Bypass -Command "<命令>"
      ```
      
      ### 注意事項：
      1. 多行內容請使用 `write_file` 工具建立檔案，避免 here-string 文法
      2. 環境變數修改後，需要顯式重新整理 `$env:Path` 才能在同一會話中使用
      3. 涉及網路下載的命令請設定較長 timeout（≥120000ms）
      
      ---
      
      ## 步驟 1：檢測前置環境
      
      檢查以下工具是否已安裝，並輸出版本號碼：
      - `node --version`（需要 v22 或更高）
      - `npm --version`
      - `git --version`
      
      如果全部已安裝且 Node.js 版本 ≥ 22，直接跳到步驟 4。
      
      ---
      
      ## 步驟 2：安裝 Node.js（如未安裝或版本低於 22）
      
      1. 檢測系統架構（x64 / x86 / ARM64）
      2. 從官方源下載 Node.js zip 包並解壓：
      ```
      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. 添加到系統 PATH（永久生效，新終端可直接使用）：
      ```
      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"
      ```
      
      ---
      
      ## 步驟 3：安裝 Git（如未安裝）
      
      1. 從官方源下載 Git 安裝包並靜默安裝：
      ```
      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. 重新整理 PATH 並驗證安裝：
      ```
      powershell -ExecutionPolicy Bypass -Command "$machinePath = [Environment]::GetEnvironmentVariable('PATH', 'Machine'); $env:Path = \"$machinePath;$env:Path\"; git --version"
      ```
      
      ---
      
      ## 步驟 4：安裝 OpenClaw
      
      重新整理 PATH 並全域安裝：
      ```
      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"
      ```
      
      ---
      
      ## 步驟 5：驗證安裝
      
      ```
      powershell -ExecutionPolicy Bypass -Command "$machinePath = [Environment]::GetEnvironmentVariable('PATH', 'Machine'); $userPath = [Environment]::GetEnvironmentVariable('PATH', 'User'); $env:Path = \"$machinePath;$userPath;$env:Path\"; openclaw --version"
      ```
      
      ---
      
      ## 步驟 6：安裝 Gateway
      
      ```
      openclaw gateway install
      ```
      
      ---
      
      ## 步驟 7：自動完成初始配置
      
      使用 `write_file` 工具建立設定檔，自動完成所有配置項（QuickStart 模式）：
      
      設定檔路徑：`%USERPROFILE%\.openclaw\config.yaml`
      
      設定檔內容：
      ```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
      ```
      
      建立設定檔後執行：
      ```
      powershell -ExecutionPolicy Bypass -Command "[Environment]::SetEnvironmentVariable('OPENCLAW_GATEWAY_TOKEN', 'openclaw-quickstart-token', 'User')"
      ```
      
      ---
      
      ## 步驟 8：啟動並使用
      
      ```
      # 啟動 TUI 介面
      openclaw tui
      
      # 或查看狀態
      openclaw status
      
      # 查看 Dashboard（瀏覽器訪問）
      # http://127.0.0.1:18789/
      ```

4. 授權允許 Qwen Code 執行命令，直至完成安裝。

5. 輸入/exit退出Qwen Code。

   /exit

方式一：通過 Qwen Code 引導配置

1. 安裝並配置Qwen Code。

2. 在終端輸入以下命令啟動 Qwen Code。

   qwen

3. 在 Qwen Code 對話方塊中輸入以下指令。

   請幫我配置 OpenClaw 接入 Coding Plan，按以下步驟操作：
   
   ## 第一步：擷取 API Key
   請先詢問使用者："請提供您的 Coding Plan API Key"
   等待使用者回複 API Key 後再繼續下一步。
   
   ## 第二步：修改設定檔
   1. 開啟設定檔：~/.openclaw/openclaw.json
      - 如果檔案不存在，請先建立該檔案
      - 重要：必須使用 .json 格式，不要使用其他格式
   
   2. 找到或建立以下欄位，合并配置（保留原有配置不變，若欄位不存在則新增）：
      - 使用 "mode": "merge" 確保不會覆蓋已有配置
      - 將 YOUR_API_KEY 替換為使用者提供的實際 API Key
   {
     "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. 儲存檔案
   
   ## 第三步：重啟並驗證
   1. 運行 `openclaw gateway restart` 重啟網關使配置生效
   2. 運行 `openclaw models list` 驗證配置是否成功
      - 檢查輸出中是否包含 `bailian/` 開頭的模型
      - 檢查每個模型是否有 `configured` 標籤
      - 如果有錯誤，請根據錯誤資訊修複

4. 授權允許 Qwen Code 執行命令，直至完成配置。

5. 配置完成後，Qwen Code 會輸出openclaw models list的結果。若bailian/qwen3.5-plus等模型都標記為 configured 表示配置成功。

方式二：通過圖形化介面配置

如果使用Simple Application Server部署方案部署的 OpenClaw，可以通過其產品的圖形化介面配置 Coding Plan。詳情請參考輕量伺服器配置方式。

方式三：直接修改設定檔

網頁瀏覽器

1. 新開一個終端，運行以下命令，瀏覽器將自動開啟 OpenClaw 的操作介面。

   openclaw dashboard

2. 開始對話。

   

終端命令列

1. 新開一個終端，運行以下命令。

   openclaw tui

2. 開始對話。