本文提供在 Windows 系统（含 WSL2 与宿主机两种方案）上部署最新 OpenClaw 的详细步骤，涵盖环境配置（Node.js 22+）、安装启动、UI 访问及常见问题解决。适合希望整合 Kimi、Claude 等 AI 工具至本地工作流的开发者与效率用户，无需编程基础，按步骤即可完成配置并接入使用。
Tags:
点击下方，关注后台回复【666】，免费领取【AI学习礼包】
大家好，我是陈凡，先祝大家开工大吉🧧！
大家回到工作岗位了吗？是不是有点过节综合症呀，如果上班第一天事情没那么多的话，就把手边那台用了好久的 windows电脑，重新灌入活力。
让你不用换机器，分五步就能把 OpenClaw 彻底驯服。不论是想干净的 WSL2 里跑，还是想在 Windows 宿主机里直接开干，这篇硬核的保姆级手册都能让你闭眼通关。
第一步、安装环境底座（WSL2 vs 宿主机）
WSL2 方案：
说实话为了长期的稳定性，WSL2 确实是不二之选。
在系统下方的搜索框中搜索PW，打开 PowerShell (管理员)。
安装wsl
wsl --install -d Ubuntu如果报错"未启用虚拟化"，那就需要重启进 BIOS 开启 VT-x (Intel) 或 SVM (AMD)。直到在任务管理器性能的 CPU中找到虚拟化：已启用。
Windows 宿主机方案：
如果你就想简单省事，直接跳过这一步。
第二步、安装 Git 与 Node.js 22+
OpenClaw 2026 版对环境有死要求：必须 Node.js 22+。 版本低了，连它的网关（Gateway）都起不来。
WSL2 方案：
在 Power Shell 敲 wsl 进 Ubuntu 后，用 nvm 来控制版本，非常有益于未来扩展：
#安装nvmcurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bashsource ~/.bashrcnvm install 22nvm use 22#安装gitsudo apt install -y git
Windows 宿主机方案：
去 nodejs.org 下载 v22.x LTS 的 .msi 安装包。
去 git-scm.com 下载并安装 Git for Windows。
避坑：安装完后，打开终端输
node -v。如果是 v18 或 v20，赶紧卸了重装，否则 OpenClaw 的onboard会经常报错。
第三步、安装 OpenClaw
别去文件夹里乱点，这玩意儿是靠 CLI（命令行）驱动的。
WSL2 & 宿主机通用方案：
建议用 pnpm，比 npm 快不止一个量级。
npm install -g pnpm# 1. 运行 pnpm 自动配置pnpm setup# 2. 重新加载 shell 配置（使环境变量生效）source /root/.bashrc# 3. 现在可以安装 openclaw 了pnpm add -g openclaw@latest
关键环节：运行初始化向导
openclaw onboard --install-daemon这里会弹出一堆选项，我们直接用下面的关键步骤表格对照一点一点来看，这步其实就是在写openclaw.json文件：
经过漫长的配置，最后如果API没问题，就直接能够和它沟通啦！
第四步、常用启动命令
以上我们都安装完毕后就可以启动啦：
启动网关：
openclaw gateway start。查看状态：
openclaw status。如果看到下面截图中的内容，说明你成了。
真实体验：直接在终端输入
openclaw tui，发个信息："你帮我看看文件到底说了什么"，你会看到 Kimi 2.5 调度了 file-system 技能，直接把活儿干了。
第五步、安装 OpenClaw-ui
很多时候我们如果没看到 openclaw-ui 感觉就和没成功没两样，所以这里我总结了几条命令，一步步执行下去，马上就能看到结果：
# 直接设置 gateway 为本地模式openclaw config set gateway.mode local# 设置绑定为局域网模式（允许非回环连接）openclaw config set gateway.bind "lan"# 明确允许本地地址（生产环境推荐）openclaw config set gateway.controlUi.allowedOrigins '["http://localhost:18789", "http://127.0.0.1:18789", "http://0.0.0.0:18789"]'# 生成并设置新的认证 TokenTOKEN=$(openssl rand -hex 32)openclaw config set gateway.auth.token $TOKEN# 显示 Token（复制这个值）echo $TOKEN# 强制刷新tokenopenclaw gateway install --force# 重启 Gatewayopenclaw gateway restart
最后我们将复制的Token写入到下面URL中，直接用下面地址访问浏览器即可。
http://127.0.0.1:18789/?token=<token>安装时常见的坑
权限错误：在 Windows 宿主机安装时，如果报
EPERM错误，那是你没用管理员权限开终端。千万记得右键以管理员身份运行。代理问题：WSL2 连不上 API？在
.bashrc里配好hostip转发，否则你只能看着"Connection Timeout"发呆。路径乱码：OpenClaw 碰到中文路径偶尔会抽风，工作区（Workspace）尽量设在
D:\AI_Agent这种纯英文路径。防火墙阻断：如果你要通过手机 飞书或者企微 连 OpenClaw，记得在 Windows 防火墙给 18789 端口（默认网关端口）开个绿灯。
写到最后
写到最后
说实话，折腾 OpenClaw，根本不需要写代码，但你得有那种"把复杂系统拆解并跑通"的耐心。
很多人还在犹豫是选 Claude 还是选 Kimi，懂行的人已经像咱们这样，用 OpenClaw 把它们全接进了工作流，工具就是拿来使的，千万别把它供起来。
想让你的 OpenClaw 具备"自动回复邮件"这种高阶技能吗？关注我，回关键词"技能包"，带你手搓 Skills ，脚本也直接甩给你。
扫码
链接我领礼包
