windows11安装openclaw
一、安装Node.js(可选)
如果你需要在后续步骤中用到Node.js环境,可以先进行安装。前往Node.js官方网站的下载页面:
https://nodejs.org/en/download
下载最新的稳定版进行安装即可。
二、安装WSL2
首先,我们需要启用Windows子系统(WSL)功能。以管理员身份打开PowerShell,执行以下命令:
执行完成后,通常建议重启一次电脑。重启后,再次以管理员身份打开PowerShell,输入以下命令将WSL版本默认设置为WSL2:
为了验证安装是否成功,我们可以新开一个PowerShell窗口(无需管理员权限),查看WSL的版本信息:
接下来,安装一个Linux发行版。这里我们选择Ubuntu 24.04,执行如下命令:
wsl --install -d Ubuntu-24.04
安装过程中,系统会提示你为Ubuntu系统创建一个新的用户名和密码,请务必记住它们。
安装OpenClaw
打开PowerShell,并以管理员模式进入WSL环境:
进入WSL后,执行OpenClaw的一键安装命令:
curl -fsSL https://openclaw.ai/install.sh | bash
安装过程会持续几分钟。如果一切顺利,你会看到安装成功的提示。但有时在最后一步配置网关服务时可能会遇到报错,如下图所示:
如果遇到这个问题,不必担心,我们可以手动创建服务配置文件来解决。依次执行以下命令:
mkdir -p ~/.config/systemd/user
vim ~/.config/systemd/user/openclaw-gateway.service
在打开的vim编辑器中,写入以下服务配置内容:
[Unit]
Description=OpenClaw Gateway (profile: , v)
After=network-online.target
Wants=network-online.target
[Service]
ExecStart=/usr/local/bin/openclaw gateway --port 18789
Restart=always
RestartSec=5
[Install]
WantedBy=default.target
保存并退出vim(按Esc键后输入:wq并按回车)。接着,执行以下命令启用并立即启动这个服务:
systemctl --user enable --now openclaw-gateway.service
重启电脑
完成上述手动配置后,为了保证所有环境变量和服务生效,重启你的电脑。
重新启动网关
电脑重启后,再次进入WSL环境,手动启动OpenClaw网关服务:
openclaw gateway --port 18789
这个窗口需要保持运行,不要关闭。然后,我们启动一个新的WSL终端窗口,执行以下命令来启动仪表盘:
openclaw dashboard
命令执行后,会输出一个本地访问地址。在浏览器中打开这个地址:
http://localhost:18789/
看到OpenClaw的Web管理界面,就说明所有安装和配置工作已经圆满完成。
常用命令
这里再补充几个有用的命令:
- 启动配置面板:
openclaw onboard - 查找配置文件路径: 在WSL中执行下面命令,可以找到
~/.openclaw目录在Windows系统中的对应路径:
wslpath -w ~/.openclaw
# 输出示例:\\wsl.localhost\Ubuntu\home\taoliangyu\.openclaw












