OpenClaw小白从入门到精通：电脑本地一键部署手把手教程

再次郑重提醒：切记！切记！切勿使用主力电脑进行部署，因为管理员权限过高，存在较大安全风险。

推荐使用 Mac Mini 或闲置主机来完成 OpenClaw 的部署工作，这样更为安全稳妥。

下面先介绍 Windows 电脑下的部署情况。

在 Windows 系统上安装 OpenClaw，通常有两种方式：一种是在 Windows 原生环境中直接安装，另一种是通过 Windows 自带的 Linux 子系统（WSL）进行安装。

直接给出结论：请务必避开第一种方法。直接在 Windows 上安装 OpenClaw 会遇到无数故障，让人束手无策。选择 WSL 方式才是正确路径，同时也是官方推荐的安装方案。

接下来，我们进入详细的部署步骤。

第一步
按下键盘上的“Win”键，在搜索框中输入“PowerShell”，右键点击结果并选择“以管理员身份运行”。

如果 PowerShell 无法打开，也可以使用 CMD（命令提示符），同样需要以管理员身份运行。

然后输入以下命令：

wsl --install

该命令用于安装 WSL。安装完毕后，系统会提示重启电脑，请按要求重启。

第二步
重启完成后，再次打开 PowerShell 或 CMD，输入如下命令：

wsl --install ubuntu-24.04

此命令将安装 Ubuntu 24.04 Linux 发行版。下载完成后，需要设置一个用户名和密码（可根据个人习惯自行设定）。

设置完毕后，屏幕上将显示带有颜色的命令行界面，表明已成功进入 Linux 系统。后续所有操作都必须在此环境中执行。若不小心退出，只需重新打开 PowerShell 或 CMD，输入 wsl 并回车即可重新进入。

第三步
在 Linux 系统界面中，输入以下命令以下载 OpenClaw：

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

该命令是官方提供的一键安装脚本，其优势在于会自动处理所有环境依赖。例如，若检测到系统未安装 Node.js，脚本会自动完成安装。

这里有两处需要特别留意：

1. 输入命令后，需输入之前设置的用户密码。

2. 如果电脑长时间没有响应且无任何输出，请不必惊慌。观察屏幕是否出现“Installing”字样，这表示正在安装中，此期间无输出是完全正常的情况，请耐心等待片刻。

当欢迎界面弹出时，即表示安装成功。

随后 OpenClaw 控制台会自动弹出。若未自动弹出，可复制提示中的网址，在浏览器中手动打开。

依次点击 Setting（设置）→ Config（配置）→ Authentication，然后点击菜单下方的 Raw 选项。

复制以下配置信息，替换掉原文中的 “agents”: {…}, 部分，并将 baseUrl 和 apiKey 修改为你自己的参数。

{
  “models”: {
    “mode”: “merge”,
    “providers”: {
      “bailian”: {
        “baseUrl”: “https://coding.dashscope.aliyuncs.com/v1”,
        “apiKey”: “YOUR_API_KEY”,
        “api”: “openai-completions”,
        “models”: [
          {
            “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
          }
        ]
      }
    }
  },
  “agents”: {
    “defaults”: {
      “model”: {
        “primary”: “bailian/MiniMax-M2.5”
      }
    }
  },
  “gateway”: {
    “mode”: “local”
  }
}

配置完成后，点击右上角的 Save 保存配置，再点击 Update。

至此，“第一步：环境部署”顺利结束。接下来即可进入“第二步：配置模型”阶段。