Win(WSL2)安装OpenClaw

注：该文档是从零使用WSL2安装OpenClaw，就是在Ubuntu中运行OpenClaw，适配OpenClaw的开发环境，使用这种安装方式会大大降低使用时的出错概率

一、下载WSL2

这里不直接使用powershell的install命令下载，因为install命令对windows10版本有要求，这里使用都可以使用的方式：

1、使用管理员打开powershell顺序执行两行命令：

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

再执行：

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

2、重启电脑

3、下载并安装内核升级包

下载连接：https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi

下载完成后双击运行，无脑点击"下一步"知道安装完成

3、确认安装成功

管理员打开powershell，执行wsl --set-default-version 2,若输出以下内容，则安装成功

二、下载并启动Ubuntu

1、下载Ubuntu

很多win10没有微软商店，这里通过链接下载：https://aka.ms/wslubuntu2204

2、解压

直接运行Ubuntu进行安装可能会安装失败，使用powershell命令行强装也能能因为缺少运行库导致无法启动
这里使用不会出错的方式：解压
找到刚才安装的文件，一般名为：Ubuntu2204-221101.AppxBundle
把该文件的后缀改成zip：

全部解压缩：

找到体积最大、名字带有 x64 的文件(通常叫 Ubuntu_2204.1.7.0_x64.appx)，把他的后缀也改成zip

找一个内存充足，适合存放Ubuntu的文件夹，这个文件夹就是Ubuntu的系统文件夹，把刚才的zip文件复制进去

将复制的zip文件解压缩

3、运行

双击运行刚才解压完的文件中的 ubuntu.exe

第一次需要输入系统用户用户名和密码，并确认密码
（注意：在 Linux 终端里输入密码时，屏幕上不会显示任何字符（连星号都没有）。盲打完密码后按回车即可。）

三、安装Npm和NodeJs

注意：本步骤需要VPN或使用镜像，使用VPN需要开启TUN模式
运行官方下载命令：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

运行刷新环境变量命令：

source ~/.bashrc

运行一键安装Node.js命令：

nvm install --lts

四、安装和配置OpenClaw

1、安装OpenClaw

执行OpenClaw安装命令：npm install -g openclaw

2、运行初始化向导

执行命令：openclaw onboard

3、初始化向导简单设置

风险提示，选择Yes

开始方式，选择QuickStart

Model/auth provider 模型鉴权，选择Skip for now

Filter models by provider 模型提供方，选择Filter models by provider
之后在配置文件中设置

出现这个，可以先选第一个，点击回车

Select channel(QuickStart) 选择通信渠道，选择Skip for now

Configure skills now?(recommended) 配置技能，选择No

Enable hooks? 配置自动化钩子，移到 Skip for now，先按空格，再按回车

4、复制网址

输出以下内容：

注意：一定要把带token的http网址复制下来！之后在浏览器要打开这个链接！

五、启动OpenClaw

1、修改wsl.conf

此时如果直接运行网关会报错，需要先唤醒systemd
这里不使用sudo编辑配置文件，直接运行命令：

sudo bash -c "echo -e '[boot]\nsystemd=true' > /etc/wsl.conf"

可能需要输一下密码

2、重启WSL引擎

把这个ubuntu界面关闭，重新启动ubuntu.exe

3、启动网关

运行启动网关命令：openclaw gateway run

4、在浏览器中运行

打开浏览器，把上面四-4 复制的网址输入进去，打开
注意：带token的网址只要输入一次就行了，之后可以使用不带token的http链接访问(http://127.0.0.1:18789/)

把语言改成中文：

六、配置第三方端点(墨信)，密钥和默认模型

1、打开openclaw.json文件

不建议在命令行和文本管理器中编辑wsl.conf文件，各有各的问题，建议下载一个vscode，配置会很舒适
vscode打开wsl.conf为例，新运行一个ubuntu.exe，执行vscode打开wsl.conf命令：

code ~/.openclaw/openclaw.json

2、配置openclaw.json文件

在 openclaw.json 配置文件的根节点（最外层的大括号）内，新增一段 "models" 配置块：
这个意思就是创建了一个自己的模型提供方，命名为custom-1
id和name可添加多个，但id一定要和模型中的模型名保持一致
注意：apiKey要填成你自己创建的密钥

  "models": {
    "providers": {
      "custom-1": {
        "baseUrl": "https://www.moxin.studio/v1",
        "apiKey": "sk-mobt1BjGxfQJ2znyRLho7JsabKwAI0kBdQT8oevICZc5OKS",
        "api": "openai-completions",
        "models": [
          {
            "id": "gemini-2.5-pro",
            "name": "Gemini 2.5 Pro"
          }
        ]
      }
    }
  },

在agents---defaults中添加两个配置块，将刚创建的模型提供方配置为默认：
如果要更换模型，需要把模型先添加到根节点的models中，再在下方替换

      "model": {
        "primary": "custom-1/gemini-2.5-pro"
      },
      "models": {
        "custom-1/gemini-2.5-pro": {}
      },

配置的时候可以在cmd中查看日志，分辨是否配置成功：黄字错，蓝字对

完整的openclaw.json参考：

{
  "wizard": {
    "lastRunAt": "2026-02-26T03:31:08.789Z",
    "lastRunVersion": "2026.2.24",
    "lastRunCommand": "onboard",
    "lastRunMode": "local"
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "custom-1/gemini-2.5-pro"
      },
      "models": {
        "custom-1/gemini-2.5-pro": {}
      },
      "workspace": "/home/jiangyi/.openclaw/workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },
  "models": {
    "providers": {
      "custom-1": {
        "baseUrl": "https://www.moxin.studio/v1",
        "apiKey": "sk-mobt1BjGxfQJ2znyRLho7JsabKwAI0kBdQT8oevICZc5OKS",
        "api": "openai-completions",
        "models": [
          {
            "id": "gemini-2.5-pro",
            "name": "Gemini 2.5 Pro"
          }
        ]
      }
    }
  },
  
  "messages": {
    "ackReactionScope": "group-mentions"
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto",
    "restart": true,
    "ownerDisplay": "raw"
  },
  "session": {
    "dmScope": "per-channel-peer"
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "40e94e0115f6236380be09bd41a4d505d46c4bbc09eedf9b"
    },
    "tailscale": {
      "mode": "off",
      "resetOnExit": false
    },
    "nodes": {
      "denyCommands": [
        "camera.snap",
        "camera.clip",
        "screen.record",
        "calendar.add",
        "contacts.add",
        "reminders.add"
      ]
    }
  },
  "meta": {
    "lastTouchedVersion": "2026.2.24",
    "lastTouchedAt": "2026-02-26T03:31:08.796Z"
  }
}

七、使用openclaw

1、测试对话

回到聊天里对话

这个不是报错，是需要给AI一个定位，比如你是谁，AI是谁，要做什么，在你的第一句对话后会触发，按实际情况填写即可
比如：我是张总，是一个运营总监，你是我的助手流萤，帮我操作电脑，执行我给的命令

2、配置记忆指令

记忆指令可以理解成agent
比如：通过WSL2部署的OpenClaw默认是不知道自己是windows下部署的，如果让她找个桌面文件她只会到ubuntu系统的目录下查找，可以通过记忆指令来给她，可以这样跟她对话：
注意：路径需要根据实际情况更改！
如果是 C:\ 开头，就改成 /mnt/c/
如果是 D:\ 开头，就改成 /mnt/d/
如果是 F:\ 开头，就改成 /mnt/f/
改完后，反转所有的/
比如你的路径是：F:\360MoveData\Users\lixiaojing\Desktop\dpyh
反转完之后是：/mnt/f/360MoveData/Users/lixiaojing/Desktop/dpyh

流萤请记住：我的真实 Windows 桌面绝对路径是 /mnt/c/Users/Administrator/Desktop。以后当我要你把文件保存在桌面，或者问你我的桌面路径时，你必须且只能使用这个绝对路径。请调用你的 Edit 工具，把这条规则永久记录到 USER.md 文件中

试一下：

可以访问windows了，成功：

至此，在Windows中通过WSL2安装OpenClaw已成功！

Win(WSL2)安装OpenClaw

一、下载WSL2#

1、使用管理员打开powershell顺序执行两行命令：#

2、重启电脑#

3、下载并安装内核升级包#

3、确认安装成功#

二、下载并启动Ubuntu#

1、下载Ubuntu#

2、解压#

3、运行#

三、安装Npm和NodeJs#

四、安装和配置OpenClaw#

1、安装OpenClaw#

2、运行初始化向导#

3、初始化向导简单设置#

4、复制网址#

五、启动OpenClaw#

1、修改wsl.conf#

2、重启WSL引擎#

3、启动网关#

4、在浏览器中运行#

六、配置第三方端点(墨信)，密钥和默认模型#

1、打开openclaw.json文件#

2、配置openclaw.json文件#

七、使用openclaw#

1、测试对话#

2、配置记忆指令#