来源:公众号「虾米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
| 优点 | ||
| 缺点 | ||
| 适合群体 |
我的建议: 如果你之前用过 Linux 或喜欢折腾,推荐 WSL2;如果你只想快速上手,用原生 Windows 就够了。
二、准备工作 ??
在开始之前,确保你的电脑满足以下条件:
三、安装 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. 设置用户名(记住它,安装软件时需要) 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 配置过程
安装过程中会提示你进行配置,按照下表选择:
![图: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. 打开浏览器(推荐 Chrome 或 Edge) 2. 访问:http://127.0.0.1:18789
![图:OpenClaw 控制面板界面]
6.3 测试对话
在对话框输入:
你好,介绍一下自己如果收到回复,说明 OpenClaw 已经成功运行了! ?
七、常见问题 ???????
Q1: WSL2 安装失败怎么办?
A: 确认以下两点:
1. BIOS 虚拟化已开启(需要进 BIOS 设置) 2. Windows 版本够新(Windows 10 21H2+ 或 Windows 11)
Q2: 终端中文显示乱码?
A: 执行以下命令:
export LANG=C.UTF-8或者长期解决,在 ~/.bashrc 末尾添加:
export LANG=C.UTF-8Q3: 如何在 WSL2 和 Windows 之间传文件?
A: WSL2 的文件在 Windows 中的位置:
\\wsl$\Ubuntu\home\你的用户名也可以在 Ubuntu 终端输入 explorer.exe . 直接打开当前目录。
Q4: 每次都要手动启动吗?
A: 可以设置开机自启(后续教程会讲),目前每次使用前需要运行 openclaw gateway。
Q5: WSL2 和原生 Windows 选哪个?
A:
• 想省事 → 原生 Windows • 想性能好 → WSL2 • 之前安装失败 → 试试 WSL2
八、总结 ??????
今天我们学习了:
1. 什么是 WSL2 —— Windows 自带的 Linux 环境 2. 如何启用 WSL2 —— 一条命令搞定 3. 配置 Ubuntu —— 换源、更新、安装 Node.js 4. 安装 OpenClaw —— 脚本一键安装 5. 启动和使用 —— 浏览器访问控制面板
下期预告: 我们会讲讲如何配置多个 AI 模型,以及如何让 OpenClaw 开机自启!
觉得有帮助的话, 点个赞 ??、、在看 ??、转发 ?? 支持一下!
我是虾米AI派,陪你一起玩转 AI!
参考来源
• OpenClaw 官方文档:https://docs.openclaw.ai • OpenClaw 中文网:https://openclawcn.com • WSL2 官方文档:https://docs.microsoft.com/zh-cn/windows/wsl/
本篇文章最终解释权归虾米AI派所有,欢迎在评论区留言交流~
夜雨聆风