Windows环境下OpenClaw本地部署完整指南

OpenClaw是一款完全开源、本地优先的AI智能体执行网关，它不仅能对话，还能直接操控电脑执行任务（管理文件、编写代码、浏览网页、发送邮件等），所有数据完全存储在本地设备上。

这是官方推荐的最简单方法，自动检测并安装所有依赖。

以管理员身份打开PowerShell
- 开始菜单搜索"PowerShell"
- 右键点击"Windows PowerShell"
- 选择"以管理员身份运行"
允许脚本执行

Windows默认禁止运行远程脚本，需要先授权：
powershell 复制代码
```
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
```
当系统提示确认时，输入Y并按回车。

执行官方安装脚本

powershell 复制代码

# 官方脚本（推荐）
iwr -useb https://openclaw.ai/install.ps1 | iex

# 国内网络超时可使用中国社区镜像
# iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex

等待2-5分钟，出现"OpenClaw installed successfully"即为安装完成。

验证安装

关闭所有PowerShell窗口，重新打开一个新的PowerShell窗口：
powershell 复制代码
```
openclaw --version
```
如果显示版本号，说明安装成功。

官方明确表示原生Windows安装虽然可用，但稳定性较差，强烈推荐使用WSL2环境部署OpenClaw。

安装WSL2和Ubuntu

以管理员身份打开PowerShell：
powershell 复制代码
```
wsl --install
```
安装完成后重启电脑，系统会自动创建Ubuntu用户账户。
在WSL2中启用systemd

打开Ubuntu终端，编辑wsl.conf文件：
bash 复制代码
```
sudo nano /etc/wsl.conf
```
添加以下内容：
复制代码
```
[boot]
systemd=true
```
保存退出（Ctrl+O，回车，Ctrl+X），然后关闭WSL：
bash 复制代码
```
wsl --shutdown
```
重新打开Ubuntu终端。
在WSL2中安装OpenClaw
bash 复制代码
```
curl -fsSL https://openclaw.ai/install.sh | bash
```
安装完成后，重新加载环境变量：
bash 复制代码
```
source ~/.bashrc
```
验证安装
bash 复制代码
```
openclaw --version
```

Docker部署提供了最佳的隔离性和可移植性，适合需要长期稳定运行的场景。

安装Docker Desktop

从Docker官网下载并安装Windows版Docker Desktop。安装时确保勾选"Use the WSL 2 based engine"选项。
启动Docker Desktop

等待Docker状态显示为"Running"。
运行OpenClaw容器

打开PowerShell：
powershell 复制代码
```
docker run -d --name openclaw -p 18789:18789 --restart unless-stopped openclaw/openclaw:latest
```
--restart unless-stopped参数确保容器在系统重启或崩溃后自动启动。
验证容器运行状态
powershell 复制代码
```
docker ps
```
你应该看到openclaw容器状态为"Up"。

无论使用哪种部署方式，都需要完成以下初始化步骤：

运行新手引导
powershell 复制代码
```
openclaw onboard --flow quickstart
```
按照向导提示完成：
- 选择AI模型提供商（支持Claude、OpenAI、DeepSeek、Kimi等）
- 输入对应的API密钥
- 配置聊天通道（推荐Telegram，配置最简单）
启动OpenClaw服务
powershell 复制代码
```
openclaw start
```
安装为系统服务（可选）

让OpenClaw在系统启动时自动运行：
powershell 复制代码
```
openclaw gateway install
```
访问Web管理界面

打开浏览器访问：http://localhost:18789

在这里你可以查看日志、管理技能、配置更多通道。

问题现象	可能原因	解决方案
`openclaw: command not found`	环境变量未生效	关闭所有PowerShell窗口后重新打开，或重启电脑
ExecutionPolicy报错	脚本执行权限不足	重新执行`Set-ExecutionPolicy RemoteSigned -Scope CurrentUser`
node-gyp编译失败	缺少C++编译工具	下载安装Microsoft Visual Studio Build Tools，勾选"使用C++的桌面开发"工作负载
防火墙拦截	Windows Defender阻止网络访问	在Windows防火墙中允许OpenClaw相关进程通过
WSL2下服务无法访问	跨网络问题	确保WSL2和Windows在同一网络，使用`localhost:18789`访问