windows11安装openclaw

一、安装Node.js（可选）

如果你需要在后续步骤中用到Node.js环境，可以先进行安装。前往Node.js官方网站的下载页面：

下载最新的稳定版进行安装即可。

二、安装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