windows wsl openclaw安装教程
在Windows上通过WSL部署OpenClaw：一份精炼指南
对于Windows用户来说，想体验那些专为类Unix系统设计的强大工具，往往需要绕点路。OpenClaw这款AI助手便是其中之一。好在，微软的WSL（Windows Subsystem for Linux）为我们架起了一座完美的桥梁。整个部署过程，其实可以精炼为四个清晰的阶段：准备底层环境、安装核心支撑、部署应用本身，最后是启动验证。下面，就带你一步步走通全程。
第一步：搭建WSL2 Linux基础环境
万事开头，得先把WSL2这个“模拟器”给装好、配置妥当。
开启WSL功能：首先，请以管理员身份打开PowerShell或命令提示符。直接输入下面这条命令并回车，它会自动启用所需的Windows功能，并默认安装Ubuntu发行版。
wsl --install命令执行完毕后，务必重启你的电脑，这是关键一步。
初始化Ubuntu系统：重启后，在开始菜单里找到并启动刚安装好的Ubuntu。首次运行会提示你创建一个新的用户名和密码——这个密码很重要，后续执行管理员命令（sudo）时全靠它。
确认WSL版本：为了获得最佳兼容性和性能，强烈建议使用WSL2。你可以在PowerShell中运行以下命令来检查：
wsl -l -v如果显示的版本是1，别担心，一条命令就能升级：wsl --set-version <你的发行版名称> 2（请将<你的发行版名称>替换为实际的名称，比如Ubuntu）。
第二步：在WSL中安装核心依赖
环境搭好，接下来所有操作都在刚才打开的Ubuntu终端里进行。
更新系统软件源：这是保证能安装到最新软件包的好习惯。
sudo apt update && sudo apt upgrade -y安装基础工具集：Git、Curl这些工具在后续步骤中必不可少。
sudo apt install -y git curl wget build-essential安装Node.js运行环境：OpenClaw要求Node.js版本在22及以上。怎么灵活管理Node版本？业内普遍推荐使用nvm（Node Version Manager）。
# 下载并安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 重新加载shell配置，让 nvm 命令生效
source ~/.bashrc
# 安装 Node.js 22 LTS（长期支持）版本
nvm install 22
# 验证安装是否成功
node --version # 预期输出 v22.x.x 或更高
npm --version第三步：部署OpenClaw应用
基石打牢，现在可以正式安装OpenClaw了。这里提供两条路径，适合不同需求的用户。
方式一：快速安装（新手首选）
官方提供了一键安装脚本，能自动化完成绝大多数配置工作，非常省心。
在Ubuntu终端中直接运行：
curl -fsSL https://openclaw.ai/install.sh | bash脚本跑完后，通常会自动进入初始配置向导。如果中途退出了或想重新配置，随时可以执行openclaw onboard --install-daemon来唤起。
方式二：源码安装（适合开发者与定制需求）
如果你打算钻研代码、二次开发，或者单纯想更透彻地了解其工作原理，从源码安装是更合适的选择。
克隆代码仓库：
git clone https://github.com/openclaw/openclaw.git
cd openclaw创建Python虚拟环境（强烈建议，能有效避免包依赖冲突）：
sudo apt install -y python3-pip python3-venv
# 确保使用Python3的venv模块
python3 -m venv venv
source venv/bin/activate安装项目依赖：
# 以“可编辑”模式安装Python依赖，便于后续修改代码
pip install -e .
# 安装Node.js相关的前端依赖
npm install运行初始化配置：
openclaw onboard第四步：配置并启动OpenClaw
配置API密钥：这是关键一步。OpenClaw本身不内置AI模型，它需要连接外部的“大脑”。在运行onboard向导时，你需要选择一个模型服务提供商（例如OpenRouter、阿里云百炼等），并填入对应的API Key。如果还没有Key，可以先去相应平台（比如OpenRouter）注册申请。
小提示：如果追求完全本地化、免费用，可以考虑集成Ollama来调用本地模型。当然，这对电脑硬件配置的要求会高不少。
启动核心服务：配置妥当后，启动OpenClaw的网关（Gateway）服务。
openclaw gateway start验证服务状态：用下面任一命令检查服务是否正常运行。
openclaw status
# 或者更具体地查看网关状态
openclaw gateway status如果终端返回服务正在运行，那么恭喜你，安装已成功。
访问Web控制台：最后，打开你最常用的浏览器，访问 http://localhost:18789。一个功能完整的OpenClaw Web操作界面应该展现在你眼前，现在就可以开始和你的AI助手对话了。
注意事项与常见问题排查
文件互访：WSL内的Linux系统可以通过/mnt/c/这个路径轻松访问你Windows的C盘文件。例如，想进入桌面目录，只需cd /mnt/c/Users/你的用户名/Desktop。
网络代理配置：如果在安装依赖时遇到网络连接问题，可能是代理没设置。可以在WSL的~/.bashrc文件末尾添加以下内容（记得把1080换成你本地代理软件的实际端口）：
export http_proxy=http://host.docker.internal:1080
export https_proxy=http://host.docker.internal:1080保存后，执行source ~/.bashrc让配置立即生效。
“command not found”错误：安装后如果提示找不到openclaw命令，通常是npm的全局安装目录没加入系统路径。可以先运行npm prefix -g找出npm的全局路径，然后将该路径下的bin文件夹（例如/home/你的用户名/.npm-global/bin）添加到~/.bashrc文件的PATH环境变量里。
说到底，整个过程更像是一次标准化的工程部署。如果卡在了某个环节，别犹豫，随时可以针对具体问题寻求帮助。是API Key的配置遇到麻烦，还是某一步命令出了错？把问题抛出来，解决起来就快了。