OpenClaw WSL2 Ubuntu安装指南:在Windows上体验原汁原味的Linux AI助手
想在Windows电脑上拥有一个完全运行在本地、能真正“动手做事”的AI助理吗?通过WSL2(Windows Subsystem for Linux 2)安装OpenClaw,让你在熟悉的Windows环境中享受Linux原生的AI助手体验,数据完全由你掌控,无需Docker容器,直接原生运行。
为什么选择WSL2 Ubuntu原生安装?
- 性能更优:直接运行在Linux内核上,比Docker少一层虚拟化,性能更好
- 开发友好:完整的Linux开发环境,方便调试和自定义
- 文件互通:Windows和Ubuntu文件系统无缝互通,管理文件更方便
- 更新简单:直接使用npm更新,比Docker容器更新更便捷
四步安装指南(WSL2 + Ubuntu原生安装)
第一步:启用WSL2并安装Ubuntu
- 以管理员身份打开PowerShell,运行:
wsl --install - 在Microsoft Store(微软商店)中找到Ubuntu 24.04 安装
- 首次启动Ubuntu时会提示创建用户名和密码,可以输入和Windows一样的密码,方便记住。
第二步:在Ubuntu中安装Node.js 22+
打开Ubuntu终端,执行以下命令:
# 更新系统包
sudo apt update && sudo apt upgrade -y
# 安装Node.js (OpenClaw必须要求22+版本,目前最新的是24)
sudo apt install -y nodejs
# 验证安装
node -v # 要大于v22.x.x
npm -v # 应该显示对应版本
第三步:安装OpenClaw
# 使用npm安装
npm install -g openclaw@latest
第四步:初始化配置向导
# 启动配置向导,--install-daemon参数会安装后台服务
openclaw onboard --install-daemon
配置向导会引导你完成:
- 安全确认:输入
Yes同意风险提示 - 模式选择:选择
QuickStart快速开始 - 模型配置:可以先选择
Skip for now跳过,后续再配置 - 渠道配置:选择
Skip for now跳过,后续再添加飞书、Telegram等 - 技能配置:选择
No跳过,后续按需安装 - 服务安装:选择
Yes安装系统服务,实现开机自启
在Windows中访问OpenClaw
- 在Ubuntu中查看WSL2的IP地址:
ip addr show eth0 | grep inet - 在Windows浏览器中访问:
http://[WSL2的IP地址]:18789 - 或者使用端口转发,在Windows PowerShell中运行:
ssh -N -L 18789:localhost:18789 [你的Ubuntu用户名]@localhost然后在Windows浏览器访问:http://localhost:18789
文件互通小技巧
- Windows访问Ubuntu文件:在文件资源管理器地址栏输入
\\wsl$\Ubuntu - Ubuntu访问Windows文件:路径为
/mnt/c/(对应C盘)
给技术爱好者的源码安装选择
如果你希望深度定制或参与开发,可以在Ubuntu中源码安装:
# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# 安装依赖(推荐使用pnpm)
npm install -g pnpm
pnpm install
# 构建项目
pnpm ui:build
pnpm build
# 初始化配置
pnpm openclaw onboard --install-daemon
常见问题解决
- 安装脚本失败:检查网络连接,或使用npm直接安装
- 端口冲突:修改配置文件中的端口号,默认18789
- 权限问题:确保使用sudo或正确配置用户权限
- 模型配置:首次可跳过,后续在Web界面中配置
两大核心优势
- 数据完全私密:所有数据都在你的WSL2环境中,不上传云端
- 开发调试方便:完整的Linux环境,方便查看日志、修改配置
现在就开始
相比Docker方案,WSL2原生安装让你同时拥有Windows的易用性和Linux的强大能力。对于希望在Windows环境下深度使用OpenClaw的技术爱好者来说,这是目前最理想的方案。
打开Windows Terminal,开始部署你的第一个本地AI数字员工吧!

