先说一句如果你跟我一样主力机是 Windows但日常要跑各种命令行工具、脚本、AI agent 类应用那我非常建议把这类工具放进 WSL 里而不是强行在原生 Windows 环境里折腾。这篇记录的是我在 Windows 上安装 OpenClaw 的完整过程用的是 WSL 方式整个流程我重新跑过至少三遍步骤是可靠的。文章会覆盖从初始化 WSL 环境到装好 OpenClaw、再到日常怎么和 Windows 协同使用的全部内容适合第一次碰 WSL 的小白也适合已经在用 WSL 但没装过这类 CLI 工具的人。1. 为什么是 WSL原生 Windows 的折腾点和 WSL 的取舍先说结论OpenClaw 这类工具设计上就是按 Linux 生态来跑的。它依赖一堆底层行为比如文件权限、软链接、进程信号、shell 环境变量传递这些在 Windows 原生环境里都会变成莫名其妙的小问题。你能在 Windows 上装成功但运行途中会遇到各种边界情况查起来非常耗时间。1.1 WSL 1 与 WSL 2 的差别以及为什么推荐 WSL 2WSL 2 和 WSL 1 是两条完全不同的实现路线。WSL 1 本质上是把 Linux 的系统调用翻译成 Windows 系统调用兼容性说不上差但遇到涉及文件系统 inode、socket 行为、内核模块的场景就容易出问题。WSL 2 则是真正跑了一个轻量虚拟机里面有完整的 Linux 内核OpenClaw 运行时的行为就和在真实 Linux 服务器上几乎一致。多数 Linux 工具开发商在写安装文档时会给用户提供 Linux 的安装命令根本不会考虑 Windows。用 WSL 2 的好处就是官方文档说怎么装你就怎么装不用再做任何“Windows 适配”翻译。OpenClaw 的安装脚本、依赖检查、路径权限设置全部按 Linux 语义来跑没人为难你。WSL 2 的代价是它需要虚拟化支持。现在大多数 CPU 都支持但你最好提前确认一下。1.2 装之前你最好先确认这几件事按顺序检查这几项任何一个不满足后面都会卡住系统版本Windows 10 21H2 及以上或者 Windows 11。这个要求并不苛刻Win10 的老版本可以通过系统更新解决Win11 通常开箱即用。BIOS 里的虚拟化开关Intel 的 VT-x 或 AMD 的 SVM需要处在开启状态。这个一般默认开着但如果你的机器是二手、或者安全软件改过 BIOS 设置有可能被关掉。Windows 功能里是否启用了“虚拟机平台”安装 WSL 2 时会自动启用但部分精简版系统需要手动打开否则命令行会提示找不到虚拟化平台。磁盘空间装一个 Ubuntu 发行版加上依赖和 OpenClaw 本体预留 15GB 以上比较稳妥。如果还要跑模型文件或数据集再多留一点。提示如果系统提示“WSL 2 需要更新内核”就按提示下载更新包完成安装或者直接执行wsl --update。这比手动去下载内核包要简单得多。2. 初始化 WSL 环境从零到能跑 Ubuntu环境初始化是整个流程的基础。我会按“命令执行、注意事项、验证结果”的顺序讲照做基本不会翻车。2.1 Windows 侧的开启命令在 Windows 管理员权限的 PowerShell 里执行wsl --install这一步在较新系统上会同时开启 WSL 功能、启用虚拟机平台、安装默认的 Ubuntu 发行版。如果没有自动装 Ubuntu可以追加参数指定wsl --install -d Ubuntu执行完后系统一般会提示重启。重启后发行版会自动继续安装或者你在开始菜单里找到已装好的 Ubuntu 图标点开走初始化流程。如果你需要查看当前 WSL 版本和默认版本可以用wsl --status wsl --version第一条约等于查“我现在的运行状态”第二条看 WSL 组件版本。常见情况是默认 WSL 版本已经是 2但你还需要单独确认。如果想完全手动启用不靠自动命令也可以这样操作dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart提示这两条命令需要管理员权限。手动方式适合自动化部署脚本普通人直接用wsl --install就行了。2.2 发行版安装与账号初始化重启之后Ubuntu 会要求设置一个 Linux 用户名和密码。这个用户名只影响 Linux 侧的标识和控制面板的 Windows 账号没有关系随便取一个顺手的就行。初始化完成之后进入 Ubuntu 终端的第一件事是更新软件源和已有软件包sudo apt update sudo apt upgrade -y这一步把系统软件索引和核心组件更新到较新状态后续安装依赖时才不会遇到版本过旧的问题。更新过程中如果网络慢可以留意自己系统的软件源配置把源切换到响应更快的服务商镜像很多地区的网络会明显改善。验证 WSL 版本是否为 2可以在 Windows PowerShell 里执行wsl -l -v输出结果里VERSION 列显示 2 就说明当前发行版跑在 WSL 2 上。如果显示 1执行wsl --set-version Ubuntu 2转换成 WSL 2。这一步会花几分钟主要是在做磁盘格式转换。2.3 把发行版装进非系统盘WSL 默认把发行版放在系统盘C 盘用久了会发现虚拟磁盘文件越来越大。OpenClaw 的会话记录、配置文件、缓存加上 Node.js 和 Python 的依赖包C 盘空间会快速被吃掉。有几种方式可以解决。最简单的是在拿到发行版之后立刻做一次导出再导入把系统盘里的虚拟磁盘迁移到 D 盘或 E 盘。操作步骤wsl --export Ubuntu D:\backup\ubuntu-backup.tar wsl --unregister Ubuntu wsl --import Ubuntu D:\WSL\Ubuntu D:\backup\ubuntu-backup.tar导入后默认会以 root 用户进入需要手动设置一下默认用户。可以在 PowerShell 里执行ubuntu config --default-user 你的用户名提示wsl --unregister会删除当前发行版的所有数据包括你还没保存的文件。先确认迁移文件已经导出来再执行。我是专门写了一条命令把备份放在非系统盘避免系统盘满后蓝屏的问题。3. Linux 侧依赖准备装好 Node.js、Python、Git 和常用构建工具OpenClaw 本体依赖 Node.js 运行时同时它的一些插件会用 Python 执行子任务。这一节把 Linux 环境里缺的运行时全部补齐并且解释一下每条依赖到底是干什么的。3.1 系统软件源和基础包更新先按官方方式更新包索引然后再装几个基础包sudo apt update sudo apt install -y curl wget git build-essentialcurl和wget用来下载安装脚本和压缩包git用来克隆源码仓库或检查依赖版本build-essential提供make、gcc等编译工具链。有些 npm 包在安装时需要现场编译原生模块没有工具链会直接报错。建议顺手装ca-certificatessudo apt install -y ca-certificates这一步保证 HTTPS 证书能被正确识别避免下载时出现证书校验失败。3.2 用动态版本管理工具安装 Node.jsNode.js 建议不要直接 apt 安装。Ubuntu 仓库里的 Node.js 版本经常滞后而 OpenClaw 对 Node 版本有最低要求装太旧的版本会在启动时打印一堆语法兼容错误。我用的是 nvm 这种方式。它会装在你的用户目录下不影响系统其他组件也能随时切换 Node 版本curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash执行完后重新加载 shell 配置source ~/.bashrc然后安装 Node.js 的长期支持版本nvm install --lts nvm alias default --lts检查版本node -v npm -v如果能看到 v20 或 v22 之类的版本号就说明 Node 环境没问题。这里不用管具体数字只要它是 LTS 版本就行。3.3 为什么需要 Python、Git 和那些小工具Python 不需要太新OpenClaw 的辅助脚本通常用 Python 3.10 以上就能跑。Ubuntu 自带的 Python 3 版本通常已经够用不信可以看python3 --version如果版本偏低用 apt 安装也行。Git 和编译工具链则属于“不一定马上用但一旦要用就必不可少”的类型。比如安装 OpenClaw 插件时有些插件是直接从 GitHub 仓库安装的没有 Git 会直接失败。而某些原生依赖需要预编译二进制找不到的时候还会自动走源码编译那 build-essential 就开始发挥作用了。提示在 Linux 环境里环境变量 PATH 是否干净直接影响后续安装结果的可用性。为了减少问题建议在装完依赖后重启一次 WSL在 PowerShell 执行wsl --shutdown再重新进入 Ubuntu这样能确保 shell 配置被完整加载。4. 安装 OpenClaw下载、校验、初始化依赖就绪后安装 OpenClaw 就只是一套标准流程了。整个环节我拆成四步获取安装包、校验完整性、初始化配置、执行环境自检。4.1 获取安装包和确认完整性OpenClaw 作为一个开源命令行工具正常发布渠道会提供两类安装方式一是在官网安装脚本二是手动下载对应平台的发布压缩包。我更推荐先看官方文档的安装脚本方式因为它会把依赖检查一起做掉curl -fsSL 官方安装地址 | bash但这里的“官方安装地址”在不同版本里可能有区别。如果你想完全掌控安装过程不依赖脚本那就走手动下载进入项目的 GitHub Release 页面找到linux-x64相关的压缩包。下载后解压到用户目录下比如~/openclaw。把可执行文件放到 PATH 范围内常见做法是建立软链接sudo ln -s ~/openclaw/bin/openclaw /usr/local/bin/openclaw软链接的好处是以后更新时只要替换~/openclaw目录里的内容系统命令路径不用改动。校验完整性这一点以前我经常跳过但后来被坑过一次。建议至少检查一下压缩包的校验值和发布页是否一致。如果 GitHub 页面上给出了 SHA256 值就执行echo 提供的校验值 下载的压缩包 | sha256sum -c -如果显示OK就表示文件完好。4.2 PATH 和配置文件位置安装完成后你可能还会碰到一个问题明明装好了输入openclaw却提示找不到命令。这就是 PATH 配置没生效。先看当前可执行文件在哪里which openclaw如果没有输出说明它不在 PATH 里。需要把它的所在目录加进去编辑~/.bashrcexport PATH$HOME/openclaw/bin:$PATH然后重新加载source ~/.bashrcOpenClaw 的配置文件通常生成在~/.openclaw/config.toml。这里存放 API 端点、模型参数、插件开关等设置。第一次启动时它不一定存在可以通过初始化命令生成。4.3 首次初始化和环境自检在项目目录下执行openclaw init初始化命令会询问几个基本问题工作目录、默认终端类型、是否需要启用某些插件。不要直接一路回车建议认真看一下提示。特别是“工作目录”选项它决定了后续 OpenClaw 操作文件时的基准路径。初始化完成后运行内置诊断工具确认环境没问题openclaw doctor这个命令会检查运行时版本、配置文件权限、依赖命令是否齐全。如果某项标红就按提示修。最常见的结果是某条命令版本太低升级一下对应组件就行。如果一切正常就可以做个快速验证直接进入交互模式openclaw它会进入一个命令行交互界面类似普通终端但多了一些快捷键和状态栏。如果能看到启动界面说明核心安装已经成功。4.4 基础用法和常见命令OpenClaw 常用命令并不复杂安装完先熟这几个就够用命令作用openclaw进入交互式对话界面openclaw run 任务描述单次执行任务适合脚本调用openclaw doctor检查环境健康状态openclaw plugin list查看当前已启用插件openclaw config show查看当前配置信息把交互界面当主战场把run当脚本后门。日常我习惯用openclaw run去处理批量任务比如写一个定时脚本调用它处理日志而手动调试时才进交互模式。5. Windows 与 WSL 的协同使用把它当成一个普通命令装好 OpenClaw 只是第一步。真正好用的状态是你坐在 Windows 桌面打开任意终端敲openclaw就能用不用每次手动跑到 WSL 窗口里。这里有几个协同技巧。5.1 从 PowerShell 调用 WSL 里的命令WSL 提供了一个从 Windows 侧发起命令的入口wsl.exe openclaw这个命令会在 WSL 默认发行版中运行openclaw。如果你只装了 Ubuntu那它就会在 Ubuntu 里启动。但每次敲wsl.exe openclaw比较麻烦尤其你想接参数的时候。可以创建 Windows 侧别名。在 PowerShell 里输入Set-Alias openclaw wsl.exe openclaw或者更彻底做一个简洁的批处理让“openclaw”在 Windows 的任意位置可用。5.2 创建一个叫 openclaw.cmd 的包装器在 Windows 上最常见也最稳定的做法是写一个.cmd包装脚本放到 Windows 的 PATH 目录里比如C:\Users\你的用户名\AppData\Local\Microsoft\WindowsApps。内容很简单echo off wsl.exe openclaw %*保存为openclaw.cmd然后重新打开一个终端输入openclaw --help这时你会发现它就像 Windows 原生装了一个 OpenClaw 一样。所有参数都会原样传给 WSL 里的 openclaw。提示不要在包装脚本里把%*漏掉否则你没法传参数每次调用都只能进入交互界面。5.3 文件交换与两个文件系统间的性能差异WSL 可以访问 Windows 磁盘Windows 也可以访问 WSL 里的文件。从 Ubuntu 里看 Windows 盘符它们被挂载在/mnt/c、/mnt/d这样的位置。反向的访问则基于\\wsl$网络路径例如\\wsl$\Ubuntu\home\用户名\project。但这里有个性能大坑跨文件系统运行程序会很慢。如果你把 OpenClaw 的项目放在C:\project然后在 WSL 里进入/mnt/c/project启动 OpenClaw你会明显感觉到启动变慢文件监听和编译操作也经常卡顿。原因是 WSL 访问 Windows 文件系统时要经过一层翻译IO 开销很大。最佳实践是把和 OpenClaw 相关的项目文件放在 WSL 自己的文件系统里比如~/projects然后通过\\wsl$路径让 Windows 侧的工具去访问它。同样的文件操作速度差异可以有数倍之多。5.4 Windows Terminal 的配置建议如果你还在用默认终端窗口建议换成 Windows Terminal。它对 WSL 的支持已经非常成熟可以给每个发行版设独立外观、快捷键、起始目录而且支持在同一个窗口里开多个 Tab。在 Windows Terminal 的设置里把默认配置文件改成 Ubuntu这样每次打开终端直接就是 WSL 环境。同时把startingDirectory设置成\\wsl$\Ubuntu\home\你的用户名\project以后一开终端就能直接操作 OpenClaw 项目。6. 实测中踩过的坑和对应修复安装教程讲得顺利但实际跑起来还是踩了五六个坑。我把这些问题的现象、原因和修复方法完整记录下来方便你遇到时照着处理。6.1 “command not found” 的三种常见原因第一次装完 OpenClaw 后我兴冲冲地输入openclaw结果提示命令找不到。排查了一通通常是这三种原因可执行文件所在的目录不在 PATH 里。解决办法是把安装目录 export 进~/.bashrc。用了 nvm 安装 Node但~/.bashrc里的 nvm 初始化代码没被加载。这种情况很少见多半是用了zsh时忘记把 nvm 初始化脚本转移到~/.zshrc。安装脚本实际装到了用户目录但当前 shell 的 hash 表没有刷新。先执行hash -r再重试。逐条排除时最快的方法是先which openclaw看它到底在哪里。如果连输出都没有说明 PATH 没指对如果有输出但执行失败那是权限问题。6.2 执行初始化命令时提示网络超时OpenClaw 初始化过程中会拉取一些远程配置或模型列表如果网络不稳定就会卡在 “request timed out” 之类的提示上。不同地区的网络环境不一样。我的处理方式是先确认基础网络是否正常在 WSL 里执行ping 一个稳定的公网域名看丢包率。确保 WSL 的 DNS 解析正常。偶尔 WSL 的 DNS 会因为 Windows 侧网络切换而失效执行sudo resolvectl flush-caches可以清掉缓存。如果一直超时可以选择一个不同的网络连接或改在流量时段执行初始化。6.3 内存占用过高或运行卡顿WSL 2 的默认内存占用策略是尽量使用宿主机内存。如果你发现 OpenClaw 跑了一会儿Windows 的内存被占掉不少可以在用户目录下创建.wslconfig文件限制 WSL 的内存和 CPU 占用。我自己的.wslconfig设置大概是[wsl2] memory4GB processors4 swap2GB localhostForwardingtrue其中localhostForwardingtrue的作用是让 WSL 里启动的服务可以直接用 Windows 浏览器访问localhostOpenClaw 的本地调试界面也用得上。改完配置后需要重启 WSLwsl --shutdown然后再启动 Ubuntu配置才会生效。6.4 Vmmem 进程占用过高使用 WSL 2 时Windows 任务管理器里会看到一个叫 Vmmem 的进程它就是 WSL 虚拟机的内存占用的总入口。如果 Vmmem 一直高占用先别急着杀进程先确认是不是 OpenClaw 正在执行任务。如果确实没有任务但内存占用还是很离谱大概率是缓存未释放。重启 WSL 是最快的方法wsl --shutdown不要直接在任务管理器里结束 Vmmem 进程那会让整个 WSL 环境异常退出。6.5 终端中文显示乱码OpenClaw 运行时终端里会出现中文输出。如果 Windows 上的终端没配好字体和编码中文就会变成乱码。解决方法是把 Windows Terminal 的字体设置成支持中文的等宽字体同时确保 WSL 的 locale 已设置为中文或 UTF-8sudo apt install -y language-pack-zh-hans sudo update-locale LANGzh_CN.UTF-8然后重新进入 WSL中文输出就正常了。这个坑最好提前规避否则看日志时会很痛苦。安装到这一步OpenClaw 在 WSL 里已经能稳定跑起来了。我后来还做了一件事把openclaw的自动启动脚本放进了 WSL 的启动项让每次打开 Ubuntu 终端时自动拉起工作目录省掉了手动cd的步骤。另外一个小习惯是把配置文件备份成config.example.toml以后重装系统时直接复制回去几分钟就能恢复一套完整环境。如果你也打算长期用 OpenClaw建议尽早把 WSL 迁移到非系统盘并限制好内存上限这套组合使用起来会舒心很多。