乐于分享
好东西不私藏

WSL2安装OpenClaw详解教程

WSL2安装OpenClaw详解教程

来源:公众号「虾米AI派」发布日期:2026-03-08适合群体:Windows 用户特别说明:**本文以 WSL2 安装为主,原生 Windows 为备选方案


大家好!我是虾米AI派!上一期我们讲了如何在原生 Windows 上安装 OpenClaw,但也有不少朋友问我:

"虾米,我电脑好像不太兼容,有其他方法吗?""能不能用 WSL2 安装?"

当然可以! 今天这篇教程就专门写给喜欢 WSL2 或者原生 Windows 安装失败的朋友们,手把手教你用 WSL2 安装 OpenClaw!

本篇教程包含:

  • • 为什么选择 WSL2
  • • WSL2 vs 原生 Windows 对比
  • • 完整的 WSL2 安装步骤(图解)
  • • 常见问题解答

一、为什么要选 WSL2??

1.1 什么是 WSL2?

简单来说: WSL2 是 Windows 自带的"Linux 系统",可以理解为在 Windows 里开了一个"虚拟机",能运行真正的 Linux 环境。

更直白地说:

  • • 原生 Windows = 在 Windows 里运行软件
  • • WSL2 = 在 Windows 里运行一个"小电脑",这个小电脑是 Linux 系统

1.2 WSL2 vs 原生 Windows

维度
原生 Windows
WSL2
优点
简单,会 Windows 就会
性能更好,官方推荐
缺点
可能有权限问题
需要了解 Linux 基础
适合群体
小白用户 ??
进阶用户 ??

我的建议: 如果你之前用过 Linux 或喜欢折腾,推荐 WSL2;如果你只想快速上手,用原生 Windows 就够了。


二、准备工作 ??

在开始之前,确保你的电脑满足以下条件:

项目
要求
说明
操作系统
Windows 10/11
WSL2 需要较新版本
内存
至少 8GB+
Linux 环境会占用内存
硬盘
至少 10GB 空余
存放 Linux 系统和文件
CPU
支持虚拟化
大多数现代 CPU 都支持

三、安装 WSL2 ???

3.1 启用 WSL2 功能

第一步: 以管理员身份打开 PowerShell(Win + X → 选择"Windows 终端(管理员)")

![图:打开管理员 PowerShell]

第二步: 运行以下命令安装 WSL2:

wsl --install

![图:PowerShell 执行 wsl --install 命令]

注意: 执行后会提示需要重启电脑,一定要重启后再继续!

3.2 重启电脑

电脑重启后,WSL2 会自动开始安装 Ubuntu。这是一个自动化过程,你只需要等待即可。

![图:WSL2 安装完成提示]

3.3 首次启动 Ubuntu

安装完成后,在开始菜单找到 Ubuntu 并打开。

第一次启动需要:

  1. 1. 设置用户名(记住它,安装软件时需要)
  2. 2. 设置密码(输入时不显示,输入两次确认)

![图:Ubuntu 首次启动界面]

?? 提示: 密码输入时屏幕不会显示任何字符,这是正常的,输入完按回车即可。


四、配置 WSL2 环境 ????

4.1 换源(让下载更快)

Ubuntu 默认使用国外源,下载会很慢。我们换成清华源

sudo sed -i 's/archive.ubuntu.com/mirrors.tuna.tsinghua.edu.cn/g' /etc/apt/sources.list

![图:终端执行换源命令]

?? 提示: 输入 sudo 后需要输入刚才设置的密码(输入时不显示,这是正常的)

4.2 更新软件包

sudo apt update && sudo apt upgrade -y

![图:apt update 执行过程]

?? 提示: 第一次执行 sudo 后,未来 15 分钟内不需要再输入密码。

4.3 安装 Node.js

OpenClaw 基于 Node.js 运行,我们来安装 LTS 版本:

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -sudo apt install -y nodejs

![图:Node.js 安装过程]

验证安装:

node -v

看到 v22.x.x 就说明安装成功了!

![图:终端显示 node -v 结果]


五、安装 OpenClaw ?????

5.1 运行安装脚本

在 Ubuntu 终端中执行:

curl -fsSL https://openclawcn.com/install.sh | bash

![图:OpenClaw 安装脚本执行中]

5.2 配置过程

安装过程中会提示你进行配置,按照下表选择:

提示
推荐选择
说明
I understand this is powerful...
Yes
确认了解风险
Installation option
QuickStart
快速安装模式
Choose your LLM
选择 DeepSeek 或 MiniMax
推荐国内模型
API Key
粘贴你的密钥
模型需要

![图:OpenClaw 配置过程]

?? 提示:

  • • API Key 是什么? 相当于"密码",从模型服务商(如 DeepSeek、MiniMax)获取
  • • 粘贴快捷键: 在终端里 Ctrl+Shift+V 粘贴,或者右键选择"粘贴"

5.3 初始化配置

安装完成后,运行初始化:

openclaw setup

openclaw configure

![图:openclaw configure 运行界面]

按照提示选择:

  • • Gateway 安装位置:Local (this machine)
  • • 安装方式:QuickStart

六、启动和使用 ???????

6.1 启动 Gateway

在终端运行:

openclaw gateway

![图:openclaw gateway 启动成功]

?? 注意: 终端不能关闭!关闭就等于把 OpenClaw 关掉了。

6.2 打开控制面板

  1. 1. 打开浏览器(推荐 Chrome 或 Edge)
  2. 2. 访问:http://127.0.0.1:18789

![图:OpenClaw 控制面板界面]

6.3 测试对话

在对话框输入:

你好,介绍一下自己

如果收到回复,说明 OpenClaw 已经成功运行了! ?


七、常见问题 ???????

Q1: WSL2 安装失败怎么办?

A: 确认以下两点:

  1. 1. BIOS 虚拟化已开启(需要进 BIOS 设置)
  2. 2. Windows 版本够新(Windows 10 21H2+ 或 Windows 11)

Q2: 终端中文显示乱码?

A: 执行以下命令:

export LANG=C.UTF-8

或者长期解决,在 ~/.bashrc 末尾添加:

export LANG=C.UTF-8

Q3: 如何在 WSL2 和 Windows 之间传文件?

A: WSL2 的文件在 Windows 中的位置:

\\wsl$\Ubuntu\home\你的用户名

也可以在 Ubuntu 终端输入 explorer.exe . 直接打开当前目录。

Q4: 每次都要手动启动吗?

A: 可以设置开机自启(后续教程会讲),目前每次使用前需要运行 openclaw gateway

Q5: WSL2 和原生 Windows 选哪个?

A:

  • • 想省事 → 原生 Windows
  • • 想性能好 → WSL2
  • • 之前安装失败 → 试试 WSL2

八、总结 ??????

今天我们学习了:

  1. 1. 什么是 WSL2 —— Windows 自带的 Linux 环境
  2. 2. 如何启用 WSL2 —— 一条命令搞定
  3. 3. 配置 Ubuntu —— 换源、更新、安装 Node.js
  4. 4. 安装 OpenClaw —— 脚本一键安装
  5. 5. 启动和使用 —— 浏览器访问控制面板

下期预告: 我们会讲讲如何配置多个 AI 模型,以及如何让 OpenClaw 开机自启!

觉得有帮助的话, 点个赞 ??、、在看 ??、转发 ?? 支持一下!

我是虾米AI派,陪你一起玩转 AI!


参考来源

  • • OpenClaw 官方文档:https://docs.openclaw.ai
  • • OpenClaw 中文网:https://openclawcn.com
  • • WSL2 官方文档:https://docs.microsoft.com/zh-cn/windows/wsl/

本篇文章最终解释权归虾米AI派所有,欢迎在评论区留言交流~