OpenClaw

Qwen Code 引导安装

OpenClaw 安装依赖于 Node.js 环境，手动安装可能会遇到环境配置问题。可以使用 Qwen Code 来完成安装和验证。

1. 安装并配置Qwen Code。

2. 在终端输入以下命令启动 Qwen Code。

   qwen

3. 在 Qwen Code 对话框中输入以下指令。

   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状态正常

   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://npmmirror.com/mirrors/node/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. 从 npm 国内镜像下载 Git 安装包并静默安装：
   ```
   powershell -ExecutionPolicy Bypass -Command "$ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest -Uri 'https://registry.npmmirror.com/-/binary/git-for-windows/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：切换 npm 源为国内镜像
   
   ```
   npm config set registry https://registry.npmmirror.com
   ```
   
   ---
   
   ## 步骤 5：安装 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"
   ```
   
   ---
   
   ## 步骤 6：验证安装
   
   ```
   powershell -ExecutionPolicy Bypass -Command "$machinePath = [Environment]::GetEnvironmentVariable('PATH', 'Machine'); $userPath = [Environment]::GetEnvironmentVariable('PATH', 'User'); $env:Path = \"$machinePath;$userPath;$env:Path\"; openclaw --version"
   ```
   
   ---
   
   ## 步骤 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：启动并使用
   
   ```powershell
   # 启动 TUI 界面
   openclaw tui
   
   # 或查看状态
   openclaw status
   
   # 查看 Dashboard（浏览器访问）
   # http://127.0.0.1:18789/
   ```

4. 授权允许 Qwen Code 执行命令，直至完成安装。

5. 输入/exit退出Qwen Code。

   /exit

手动安装

1. 安装或更新 Node.js

   1. 检查当前版本：在终端运行以下命令查看：Node.js的版本（需 v22.0 或更高版本）。如果提示“找不到命令”，说明未安装；如果显示版本号低于 v22.0，说明需要更新。

      进入终端的方法：Mac 系统打开"终端"应用，Windows 系统打开"终端"、"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 引导配置

1. 安装并配置Qwen Code。

2. 在终端输入以下命令启动 Qwen Code。

   qwen

3. 在 Qwen Code 对话框中输入以下指令。

   Qwen Code 引导配置指令

   请帮我配置 OpenClaw 接入 Token Plan 团队版，按以下步骤操作：
   
   ## 第一步：获取 API Key
   请先询问："请提供 Token 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://token-plan.cn-beijing.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"],
               "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
               "contextWindow": 1000000,
               "maxTokens": 65536,
               "compat": {
                 "thinkingFormat": "qwen"
               }
             },
             {
               "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": "deepseek-v3.2",
               "name": "deepseek-v3.2",
               "reasoning": false,
               "input": ["text"],
               "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
               "contextWindow": 163840,
               "maxTokens": 16384,
               "compat": {
                 "thinkingFormat": "qwen"
               }
             }
           ]
         }
       }
     },
     "agents": {
       "defaults": {
         "model": {
           "primary": "bailian/qwen3.6-plus"
         },
         "models": {
           "bailian/qwen3.6-plus": {},
           "bailian/MiniMax-M2.5": {},
           "bailian/glm-5": {},
           "bailian/deepseek-v3.2": {}
         }
       }
     },
     "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.6-plus等模型都标记为 configured 表示配置成功。

方式二：直接修改配置文件

网页浏览器

1. 新开一个终端，运行以下命令，浏览器将自动打开 OpenClaw 的操作界面。

   openclaw dashboard

2. 开始对话。

   

终端命令行

1. 新开一个终端，运行以下命令。

   openclaw tui

2. 开始对话。

   

钉钉

飞书

微信

QQ