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

  1. 以管理员身份打开PowerShell,运行: wsl --install
  2. 在Microsoft Store(微软商店)中找到Ubuntu 24.04 安装
  3. 首次启动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

配置向导会引导你完成:

  1. 安全确认:输入Yes同意风险提示
  2. 模式选择:选择QuickStart快速开始
  3. 模型配置:可以先选择Skip for now跳过,后续再配置
  4. 渠道配置:选择Skip for now跳过,后续再添加飞书、Telegram等
  5. 技能配置:选择No跳过,后续按需安装
  6. 服务安装:选择Yes安装系统服务,实现开机自启

在Windows中访问OpenClaw

  1. 在Ubuntu中查看WSL2的IP地址: ip addr show eth0 | grep inet
  2. 在Windows浏览器中访问:http://[WSL2的IP地址]:18789
  3. 或者使用端口转发,在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

常见问题解决

  1. 安装脚本失败:检查网络连接,或使用npm直接安装
  2. 端口冲突:修改配置文件中的端口号,默认18789
  3. 权限问题:确保使用sudo或正确配置用户权限
  4. 模型配置:首次可跳过,后续在Web界面中配置

两大核心优势

  1. 数据完全私密:所有数据都在你的WSL2环境中,不上传云端
  2. 开发调试方便:完整的Linux环境,方便查看日志、修改配置

现在就开始

相比Docker方案,WSL2原生安装让你同时拥有Windows的易用性和Linux的强大能力。对于希望在Windows环境下深度使用OpenClaw的技术爱好者来说,这是目前最理想的方案。

打开Windows Terminal,开始部署你的第一个本地AI数字员工吧!

腾讯云精选福利

发表回复

您的电子邮箱地址不会被公开。 必填项已用 * 标注