Windows安装Openclaw

WSL 环境准备

安装 or 更新 wsl

1
wsl --install / wsl --update

安装 Ubuntu

1
wsl --install -d Ubuntu

启动Ubuntu

  1. 在开始菜单启动Ubuntu
    在开始菜单中点击图标进入
  2. PowerShell/CMD 中启动
1
wsl
1
ubuntu

或

1
wsl -d Ubuntu
  1. Windows Terminal（推荐）
    Windows Terminal 是微软推出的现代化终端工具，比传统 PowerShell/CMD 更好用
    安装（PowerShell）
1
winget install Microsoft.WindowsTerminal

安装后使用
开始菜单搜索 “Terminal” 打开 ->> 点击标签栏的 ▼ 下拉箭头 =>> 选择 Ubuntu 即可进入

三种启动方式对比

启动方式 界面
点击 Ubuntu 图标 独立的 Ubuntu 终端窗口
PowerShell 输入 wsl 在 PowerShell 中进入 Ubuntu
Windows Terminal 多标签页，可切换不同 shell

当前采用 PowerShell/CMD 方案启动 Ubuntu

创建完Ubuntu的账号密码，然后看到这个 $ 就是进入 Ubuntu 环境了

基于 Ubuntu 环境安装

先检测一波, 大概率都没有安装的

1
2
3
4
5
6
7
8
9
10
11
# Git（两个横杠）
git --version

# NVM
nvm --version

# Node
node --version

# Ollama
ollama --version

git

第 1 步：安装 Git

1
sudo apt update && sudo apt install -y git curl

验证：

1
git --version

nvm

第 2 步：安装 NVM

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

激活 NVM（立即生效）：

1
export NVM_DIR="$HOME/.nvm"
1
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

验证：

1
nvm --version

第 3 步：基于 NVM 安装 node

1
nvm install 24

选择node版本

1
nvm use 24.14.0

验证

1
2
node --version
npm --version

ollama

第 4 步：安装 Ollama

命令行安装

1
2
3
4
5
6
7
8
# 1. 安装 zstd 解压工具
sudo apt install -y zstd

# 2. 测试网络连通性
ping -c 4 ollama.com

# 3. 下载（重试机制，并去掉静默模式（-s）来查看实时进度）
curl -fL --retry 5 https://ollama.com/install.sh | sh

验证

1
ollama --version

openclaw

为了让 OpenClaw 的后台服务（Gateway）正常工作，你的 WSL 必须开启 systemd

1
2
3
4
5
# 1. 写入配置文件
sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF

重启 WSL
执行完上面的命令后，你必须彻底关闭并重启 WSL 才能生效。请在 Windows 的 PowerShell（不是 WSL 窗口）里输入：

1
wsl --shutdown

为什么要这么做？
因为 OpenClaw 需要以“系统服务”的形式在后台持续运行。如果没有开启 systemd，OpenClaw 的网关（Gateway）就没法启动，会导致你打不开网页界面。 [1.1, 1.2]
重启完 WSL 之后，你就可以直接运行这一行来安装并启动了：

1
2
3
4
5
6
7
8
9
# 
# 从powershell进入wsl
wsl

# 登录 ollama - 绑设备
ollama signin

# ollama 一键 openclaw，没有的东西它会提示安装
ollama launch openclaw --model glm-5:cloud

https://ollama.com/settings/keys 这个可以验证你的设备有没有绑定成功

如果Windows有安装ollama，记得退出，不然会占用端口

由于前置没有安装openclaw，它会安装，然后准备第一次启动，由于openclaw权限比较大会有一点危险、它会有安全声明，选yes后开始使用

開始使用：確認後，OpenClaw 會正式啟動並彈出一個網頁界面，或者在終端顯示一個 http://localhost:18700 的地址

由于选择的是glm-5:cloud云模型、所以要登录下 “signin_url”:”https://ollama.com/connect?name=D...，就复制这个 https://olla… 到浏览器中去登录，登录成功后，强制退出当前窗口，重新执行

1
2
3
wsl

ollama launch openclaw --model glm-5:cloud

控制台成功

浏览器成功

http://localhost:18789/#token=ollama 【不一定是这个，没关系他会重定向】
18789 这是 OpenClaw 默认的服务端口
#token=ollama: 这是你的临时登录令牌

操作模拟成功

假设桌面是 \\wsl$\Ubuntu\home\username\Desktop

说明：

当你运行 openclaw 时：

  1. 执行 \wsl.localhost\Ubuntu\home\用户名.nvm\versions\node\v24.14.0\lib\node_modules\openclaw/openclaw.mjs （程序代码）
  2. 读取 \wsl.localhost\Ubuntu\home\用户名.openclaw/openclaw.json （你的配置）
  3. 加载 \wsl.localhost\Ubuntu\home\用户名.openclaw/workspace/ （你的工作区）

────────────────────────────────────────────────────────────────────────────────

如果重装？

  • 重装 OpenClaw → ~/.nvm/…/openclaw/ 会被覆盖
  • 你的数据 → ~/.openclaw/ 保持不变

所以：

  • 想备份个人数据 → 备份 ~/.openclaw/
  • 想看程序代码 → 去 ~/.nvm/…/openclaw/