🦞 OpenClaw WSL2 部署全流程（2026.3.10最新）

📋 前置条件确认

系统要求：

• Windows 10（版本 21H2 / Build 19044 以上）或 Windows 11
• 内存 8GB 以上（WSL2 方案）
• 磁盘空余 10GB+
• 需要一个大模型的 API Key（Claude、GPT、qwen、Kimi 、GLM等任选）

检查 Windows 版本： 按 Win+R → 输入 winver → 查看版本号
网络要求

• 另外可能还需要VPN才能快速稳定安装，当然我后面会尽量找一些国内镜像。
• 如果有vpn WSL需要设置才能使用windows的代理

什么？你说什么，你没有梯子？你让我给你一个高速稳定的VPN？
当然可以 加我wechat 微信转账吧
我的微信是： oalo_cn
绝对高速稳定！ 广告 END~

直接在 PowerShell 里创建：

notepad C:\Users\mrche\.wslconfig

弹出记事本后创建并粘贴内容：

[wsl2]
networkingMode=mirrored

保存关闭即可。

注意：保存时确认文件名是 .wslconfig，不要变成 .wslconfig.txt。

然后重启 WSL（如果你已经安装了）：

wsl --shutdown
wsl

第一步：安装 WSL2

以管理员身份打开 PowerShell
（开始菜单搜索 PowerShell → 右键 → 以管理员身份运行）

wsl --install
或者
wsl --update

之后执行以下指令查看系统镜像

wsl --list --online

我这里安装的是

wsl --install -d Ubuntu-24.04

安装完成后按提示设置 Linux 用户名和密码
（这个密码后面 sudo 会用到，一定要记住）。

出现这种表示你安装成功了 但是你Windows使用了代理 但是WSL并没有 这时候就要看我最开始上面的网络要求说明配置一下了

⚠️ 如果 wsl --install 失败或安装慢：
可能是网络问题，换个时段重试。或手动勾选：控制面板 → 程序 → 启用或关闭 Windows 功能 → 勾选"适用于 Linux 的 Windows 子系统"和"虚拟机平台"。

验证 WSL2 版本：

wsl --version

确认 WSL 版本 显示 2.0 以上即可。

第二步：进入 Ubuntu 终端，更新系统 + 安装依赖

打开 Ubuntu 终端（开始菜单搜索 Ubuntu），依次执行：

# 更新系统
sudo apt update && sudo apt upgrade -y

# 安装编译工具和必要依赖（很多人失败就是跳过了这步！）
sudo apt install -y build-essential python3-dev libssl-dev pkg-config git curl

许多用户部署失败都是因为跳过了这一步，OpenClaw 的部分依赖需要编译 C++ 代码，必须先安装这些基础工具。

第三步：安装 Node.js （必须是 22以上，不能低！）

# 安装 nvm（Node 版本管理器）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

如果这个下面图中的下提示信息，ssl超时等问题可以使用国内镜像

# 用国内镜像下载安装脚本
curl -o- https://gitee.com/mirrors/nvm/raw/v0.39.7/install.sh | bash

# 让 nvm 命令生效
source ~/.bashrc

# 安装 Node.js 22以上版本 这里安装最新的v24.14.0
nvm install --lts

# 验证版本
node -v   # 应显示 v24.14.0
npm -v

OpenClaw 要求 Node.js 22 或更高，低版本跑不起来，装错了后面会报各种奇怪的错。

第四步：配置国内 npm 镜像（国内网络必做）

# 切换为淘宝源
npm config set registry https://registry.npmmirror.com

# 验证
npm config get registry

第五步：安装 OpenClaw

⚠ 这里用的是npm 安装的 可以参考官网的安装方式进行新手引导：
openclaw官网教程地址

npm install -g openclaw@latest

⚠️ 不要加 sudo！ 使用 nvm 管理的 Node.js 不需要 sudo，加了反而会出权限问题。

国内网络如果还是装不上，可以用国内镜像包：

npm install -g openclaw-cn

安装完验证：

openclaw --version

第六步：初始化配置（onboard 向导）

openclaw onboard

yes 同意！

QuickStart

向导会引导你完成配置，包括选择 AI 模型提供商，支持 OpenAI、Anthropic、Google Gemini 等主流平台。按提示操作：

1. 选择模型提供商 → 输入对应 API Key
2. 我不打广告用的谁的模型 你们自己选 又没给我钱
3. 通讯渠道（飞书/Telegram 等）→ 可先跳过 skip now，后续用 openclaw channels add 配置，我有telegram就先配置了 怎么配置后面再说吧，但是可能就忘了
4. 配置web search
   
   简单介绍一下这些吧

这是 OpenClaw 在配置 Web Search 工具，让你的 Agent 能联网搜索。

各选项对比

推荐方案

国内用户首选：Kimi（月之暗面）

• 中文搜索效果最好
• 注册就有免费额度
• 访问稳定不需要代理
• 直接把key粘贴一下就行

md！！！ 这么打上广告了 打钱！

5. 是否启用 skills → 建议跳过空格 Skip for now 反正你也不懂
   
6. Set GOOGLE_PLACES_API_KEY for goplaces? → NO 跳过吧，收费的地图。
7. Set GEMINI_API_KEY for nano-banana-pro? → NO 跳过吧
   nano-banana-pro 是一个需要 Gemini API 的技能 除非你用的Gemini需要
8. Set NOTION_API_KEY for notion?
   除非你日常用 Notion 记笔记，想让 Agent 帮你读写 Notion 页面，才需要配。否则直接跳过，后面要用随时 openclaw skills install notion 再配。
9. Set OPENAI_API_KEY for openai-image-gen?
   选 No，跳过。这个是用 OpenAI 的 DALL-E 生图的，需要 OpenAI API Key，国内访问也麻烦。跳过就行。
10. 10.Set OPENAI_API_KEY for openai-whisper-api?
    选 No，跳过。
    同上，OpenAI 的语音转文字服务，需要 OpenAI Key，跳过。

一路 No 到底，等向导结束就行了

11. 是否启用 Hooks → 建议选 Yes（可实现自动化触发脚本）

这是 Hooks（钩子/自动化触发器） 配置，每个选项介绍：

建议选择

新手入门推荐勾选：

• ✅ session-memory → 最实用，让 Agent 有记忆能力
• ✅ command-logger → 出问题时方便排查

其余先跳过，后续用 openclaw hooks enable boot-md 随时开启。

用空格键勾选，回车确认。

Ladies and Gentlemen!!!

到这里 不出意外的话小龙虾就能对话啦，前提我配置channel了

12. How do you want to hatch your bot?
    选 Hatch in TUI（默认推荐选项），直接回车。
    TUI 就是终端界面，在 WSL 里是最稳定的方式，Web UI 有时候在 WSL 环境下会有端口访问问题。

到此，你可以直接在终端里跟 Agent 对话了 🎉

🔧 常用命令速查

openclaw gateway start    # 启动网关
openclaw gateway stop     # 停止网关
openclaw gateway restart  # 重启网关
openclaw dashboard        # 打开 Web 控制台
openclaw doctor           # 健康检查（出问题先跑这个）
openclaw status           # 查看运行状态
openclaw logs follow      # 实时查看日志
openclaw config           # 修改模型配置
openclaw onboard          # 重新进入配置向导
npm install -g openclaw@latest  # 更新到最新版

🚨 常见报错速查

整个流程按下来大概 15-30 分钟，主要耗时在下载阶段。国内网络建议全程挂代理或提前切好镜像源，能省掉不少麻烦。

淘宝咸鱼上收费几百块 我靠 如果你看懂了 能不能给我点！！！

快！点击赞助 微信 支付宝 qq都可以