夜雨聆风适用环境：Windows 10/11 + WSL2 Ubuntu
📢 安全提醒
OpenClaw 具备系统级操作权限，不建议在主力机部署。推荐使用备用机、虚拟机或本文介绍的WSL2 隔离环境运行。
🧭 为什么选择 WSL2？
| 对比项 | WSL2 方案 | 原生 Windows 方案 |
| 官方推荐 | ✅ **强烈推荐** | ⚠️ 仅体验用 |
| 兼容性 | 完美 | 部分功能可能异常 |
| Skills 支持 | 完整 | 可能受限 |
| 性能 | 优秀（Linux 文件系统） | 一般 |
💡 关键提示：WSL2 中的项目文件必须放在 Linux 文件系统内（如 `/home/你的用户名/`），不要放在 `/mnt/c/` 下，否则性能极差。
📦 第一步：安装 WSL2
1. 以管理员身份打开 PowerShell（Win+X → Windows PowerShell 管理员）
2. 执行一键安装命令：
wsl --install
3. 重启电脑（安装完成后会自动提示）
🐧 第二步：首次启动 Ubuntu
1. 在开始菜单找到 Ubuntu并打开
2. 等待初始化完成，设置你的 用户名 和 密码（密码输入时不显示，正常输入即可）
⚠️特别提醒：WSL2 中的所有操作都将在 Linux 环境 中完成，后续所有命令均在 Ubuntu 终端 中执行。
⚙️ 第三步：启用 systemd（必须）
Ubuntu 默认未开启 systemd，而 OpenClaw 网关需要依赖它，必须手动启用。
1. 在 Ubuntu 终端中编辑配置文件：
sudo nano /etc/wsl.conf
2. 写入以下内容：
[boot]
systemd=true
3. 保存：`Ctrl+O` → 回车 → `Ctrl+X`
4. 回到 Windows PowerShell（管理员），执行：
wsl --shutdown
5. 重新打开 Ubuntu，使配置生效。
🔧 第四步：更新系统与安装基础工具
更新软件源
sudo apt update && sudo apt upgrade -y
安装必要工具
sudo apt install -y curl git
📥 第五步：安装 Node.js 22
使用 nvm（Node Version Manager）安装，避免权限问题。
安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
重新加载配置
source ~/.bashrc
安装 Node.js 22
nvm install 22
nvm use 22
验证安装
node -v
应显示 v22.x.x
💡 国内用户加速：可配置 npm 镜像
npm config set registry https://registry.npmmirror.com/
🚀 第六步：安装 OpenClaw
官方安装脚本
curl -fsSL https://openclaw.ai/install.sh | bash
重新加载环境变量
source ~/.bashrc
⚠️ 若提示 `openclaw: command not found`，请执行以下命令修复 PATH：
export PATH="$(npm prefix -g)/bin:$PATH"
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
🎛️ 第七步：初始化配置（含开机自启）
openclaw onboard --install-daemon
向导选项参考：
- AI 模型：选择你拥有的 API Key（有需要联系我）
- 聊天渠道：可暂时跳过（后续可添加）
- Skills：选择 `No`（后续可添加）
💡 `--install-daemon` 参数会配置 systemd 用户服务，使 OpenClaw 能在后台运行。
✅ 第八步：启动并验证
启动网关
openclaw gateway start
查看状态
openclaw gateway status
打开 Web 控制台（自动弹出浏览器）
openclaw dashboard
浏览器访问 `http://127.0.0.1:18789`，看到界面即表示成功！
🖥️ 第九步（可选）：Windows 开机自启
让 OpenClaw 在 Windows 启动时自动运行：
sudo loginctl enable-linger "$(whoami)"
之后可通过 Windows 任务计划程序或 Windows Terminal 的“启动时打开 WSL”功能实现自启。
📌 关键注意事项总结
| 项目 | 说明 |
| 文件存放位置| 必须在 `/home/用户名/` 下，不要在 `/mnt/c/` 下开发 |
| systemd| 必须启用，否则 Gateway 无法作为后台服务运行 |
| WSL 内存限制| 可选，在 Windows 用户目录创建 `.wslconfig` 限制内存 |
| 网络代理| 如需代理，在 Ubuntu 中设置 `export http_proxy=http://127.0.0.1:7890` |
❓ 常见问题
1. `openclaw: command not found`
- 检查是否安装成功：
npm list -g --depth=0 | grep openclaw
- 修复 PATH：
export PATH="$(npm prefix -g)/bin:$PATH"
2. Gateway 无法启动 / 服务装不上
- 确认 systemd 已启用：
systemctl --user status # 不应报错
- 若报错，请重新执行第三步（启用 systemd）。
3. 安装脚本卡住 / 下载慢
- 配置 npm 镜像加速（见第五步）
- 或使用代理（在 Ubuntu 中设置 `http_proxy` 环境变量）
🎉 完成！
现在你已经拥有了一个完整的 OpenClaw 本地运行环境。可以开始使用 `openclaw tui` 进入聊天界面，或通过 `openclaw dashboard` 进行更丰富的管理。
📢 本文根据官方推荐的最佳实践整理，WSL2 方案是目前 Windows 下最稳定、最完整的部署方式。如果遇到问题，欢迎交流讨论！
本文由OpenClaw全自动定时任务推送到公众号草稿，一键发布，仅供参考。
本公众号价值：
1、展示OpenClaw全自动做公众号运营的能力；
2、每天全自动从全球收集OpenClaw使用技巧、创业机会、商业案例等，希望能帮到你；。
