Windows 环境下 OpenClaw 的安装与千问大模型配置

为了不占用 C 盘空间，重装系统也不丢失配置：OpenClaw 非系统盘安装与通义千问对接全指南

如果你也苦于C盘空间告急，或者担心重装系统后一切又要从头再来，那么把OpenClaw这类开发工具安装到D盘或其他非系统盘，确实是个一劳永逸的好办法。今天这份指南，就手把手带你完成两件事：一是将OpenClaw本体和所有配置稳稳地迁移到D盘；二是顺利接入阿里云通义千问大模型，后者在阿里云百炼平台注册即可获得免费额度，足够我们尝鲜和日常使用。

整个过程的核心思路很清晰：利用NVM（Node Version Manager）管理Node.js环境，再通过npm全局安装OpenClaw。这样一来，后续升级维护也变得无比简单。

准备工作

万事开头，目录先行。在动手安装前，请在D盘创建好这两个核心目录：

D:\SOFT_WARE\OpenClaw\data：这里将成为配置、日志和数据库文件的新家，彻底告别C盘的用户目录。
D:\SOFT_WARE\OpenClaw\workspace：未来AI生成的代码和项目都会存放在这里。

接下来是关键一步：配置环境变量。你需要新建一个名为OPENCLAW_HOME的系统环境变量，并将其值设置为D:\SOFT_WARE\OpenClaw\data。这个操作的目的，就是明确告诉系统：“请把OpenClaw的所有配置数据，都放到我指定的D盘位置去。”

然后，我们来布置Node.js环境。前往NVM for Windows的发布页面（https://github.com/coreybutler/nvm-windows/releases）下载并安装最新版本。

安装完成后，打开命令行，将NVM的安装路径也指向D盘：

nvm root D:\SOFT_WARE\NVM

接着，安装符合要求的Node.js版本（这里以22.12.0为例），并切换使用它：

nvm install 22.12.0
nvm use 22.12.0
# 切换到该版本后，验证一下
node -v  # 应显示 v22.12.0
npm -v   # 查看npm是否可用

安装步骤

基础环境搭建完毕，现在安装OpenClaw本身。请务必以管理员权限打开PowerShell，执行全局安装命令：

npm install -g openclaw

安装完成后，不妨验证一下版本，确保一切顺利：

openclaw -v

配置 Qwen 大模型

要让OpenClaw调用通义千问，首先需要配置API密钥。同样在管理员权限的PowerShell中，执行以下命令来设置环境变量（请将你的sk-xxx密钥替换为你在阿里云百炼平台获取的真实密钥）：

[Environment]::SetEnvironmentVariable("DASHSCOPE_API_KEY", "你的sk-xxx密钥", "User")

接下来是配置文件的修改。找到并打开位于D:\SOFT_WARE\OpenClaw\data\.openclaw\openclaw.json的文件。我们需要重点关注几个配置项：

{
  ...
  "agents": {
    "defaults": {
      "model": {
        "primary": "bailian/qwen3.5-plus-2026-02-15"  // 设置默认使用的主模型
      },
      "workspace": "D:\\SOFT_WARE\\OpenClaw\\workspace",  // 确认工作空间路径
      ...
    }
  },
  "models": {
    "providers": {
      "bailian": {
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "apiKey": "${DASHSCOPE_API_KEY}",  // 此处会引用上面设置的环境变量
        ...
      }
    }
  },
  "gateway": {
    "port": 12345,  // 设置网关服务端口
    "auth": {
      "mode": "token",
      "token": "你的自定义Token"  // 设置一个自定义的登录Token
    }
  },
  ...
}

启动网关服务

OpenClaw通过一个本地网关（Gateway）来提供网页操作界面。继续在管理员PowerShell中执行以下命令来安装并启动它：

openclaw gateway install --force  # 添加 --force 参数以确保安装纯净，避免旧配置冲突
openclaw gateway start

网页端使用与登录

服务启动后，如何登录呢？有两种方式获取Token：

1. 在命令行中直接运行：openclaw config get gateway.auth.token 2. 直接从上面修改的openclaw.json文件中的gateway.auth.token字段复制。

打开浏览器，访问 http://127.0.0.1:你的端口号（端口号即在json中设置的port，如12345），在登录页面输入获取到的Token即可进入操作界面。

小贴士

实践过程中，有几个细节值得特别注意，能帮你避开不少小坑：

路径与格式：在JSON配置文件中，Windows路径必须使用双反斜杠\\进行转义。
浏览器缓存：使用浏览器无痕模式时，本地存储可能会被清除，导致每次刷新都需要重新输入Token。一个更便捷的登录方法是直接在访问地址后追加Token参数，如：http://127.0.0.1:12345/?token=你的TOKEN。
配置生效：请记住，任何对openclaw.json的修改，都需要重启网关服务才能生效（命令：openclaw gateway restart）。
维护与升级：未来升级OpenClaw本身，只需运行npm update -g openclaw。若要彻底卸载网关，则可使用openclaw gateway uninstall --force。
配置项填写：端口号（port）填写纯数字即可；自定义Token（token）可以是任何你喜欢的字符串。

AI工具浪潮已然袭来，而顺利配置往往是高效使用的第一步。希望这份详尽的指南，能帮助各位在Windows平台上轻松部署OpenClaw，少走弯路，更快地开始你的智能编码体验。