OpenClaw Windows 环境部署完整教程

本教程详细介绍如何在 Windows 系统上本地部署 OpenClaw（原 Clawdbot/Moltbot）AI 助手。

项目地址

OpenClaw 是 2026 年 GitHub 上增长最快的开源 AI 助手项目，核心能力包括：

读写本地文件、执行终端命令、运行脚本（PowerShell/Batch）；Chrome/Edge 自动化、网页截图、数据提取；Outlook 邮件读取、日历事件管理、待办事项；Office等办公软件操作；WhatsApp、Telegram、Discord、Slack、企业微信、飞书、钉钉等多渠道交互

• 项目地址：https://github.com/openclaw/openclaw

• 官网：https://openclaw.ai

WSL2 + Ubuntu 部署（强烈推荐）

这是官方推荐的 Windows 部署方式，提供最完整的 Linux 环境支持。

1. 启用 WSL2

以管理员身份打开 PowerShell，执行：

# 启用 WSL 功能
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

# 设置 WSL 2 为默认版本
wsl --set-default-version 2

重启计算机。

2. 安装 Ubuntu

方法 ：Microsoft Store 安装（推荐）

1. 打开 Microsoft Store

2. 搜索「Ubuntu 22.04 LTS」或「Ubuntu 24.04 LTS」

3. 点击「获取」并安装

4. 首次启动设置用户名和密码

安装完成后会自动打开 Ubuntu 终端，按提示设置用户名和密码。

3. 更新 Ubuntu 系统

在 Ubuntu 终端中执行：

# 更新软件包列表
sudo apt update && sudo apt upgrade -y

# 安装基础工具
sudo apt install -y curl git wget build-essential

4. 安装 Node.js 22+

# 添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

# 安装 Node.js
sudo apt install -y nodejs

# 验证版本（必须 ≥ 22.x）
node -v
npm -v

5. 安装 OpenClaw

方法 A：一键脚本安装

curl -fsSL https://openclaw.ai/install.sh | bash

6. 验证安装

# 查看版本
openclaw --version

# 查看帮助
openclaw --help

# 查看系统状态
openclaw status

7. 配置 Windows 访问 WSL2 服务

由于 OpenClaw 运行在 WSL2 中，需要配置端口转发以便 Windows 访问。

创建启动脚本 start-openclaw.bat：

@echo off
echo Starting OpenClaw Gatewayin WSL2...
wsl -d Ubuntu-22.04 -u root service openclaw start
timeout /t 3
start http://localhost:18789

或直接在 WSL2 中启动：

# 在 WSL2 Ubuntu 终端中
openclaw gateway run --port 18789

然后在 Windows 浏览器访问 http://localhost:18789

PowerShell 原生部署

适合不想使用 WSL2 的纯 Windows 用户。

1. 安装 Node.js 22+

方法 ：官网下载安装

1. 访问 https://nodejs.org/zh-cn

2. 下载 Windows 安装包（LTS 版本 22.x）

3. 运行安装程序，勾选「自动安装必要的工具」

2. 验证 Node.js 安装

# 打开 PowerShell
node -v
npm -v

3. 以管理员身份安装 OpenClaw

重要：必须以管理员身份运行 PowerShell。

# 安装最新稳定版
npm install -g openclaw@latest

# 或安装汉化版
npm install -g @qingchencloud/openclaw-zh@latest

4. 解决安装权限问题

如果遇到权限错误：

# 方法 A：启用 PowerShell 脚本执行
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

# 方法 B：修改 npm 安装目录
npm configset prefix"C:\npm"
npm configset cache"C:\npm-cache"

# 将目录添加到 PATH
[Environment]::SetEnvironmentVariable("Path",$env:Path +";C:\npm","User")

5. 验证安装

openclaw --version
openclaw --help

6. 解决常见问题

问题：sharp 模块加载失败

# 清理 npm 缓存
npm cache clean --force

# 重新安装
npm install -g openclaw@latest --force

问题：Windows Defender 阻止

将 OpenClaw 安装目录添加到 Windows Defender 排除项：

C:\Users\你的用户名\AppData\Roaming\npm
C:\Users\你的用户名\.openclaw

初始化配置

安装完成后，需要运行初始化向导。

启动初始化向导

openclaw onboard --install-daemon

配置 AI 模型提供商

OpenClaw 需要对接 AI 模型才能工作。

以配置Anthropic Claude（推荐）为例：

# WSL2 或 PowerShell
openclaw models auth add anthropic

# 输入 API Key: sk-ant-xxx

绑定消息渠道

1. Telegram创建 Bot：

1. 在 Telegram 搜索 @BotFather

2. 发送 /newbot 创建机器人

3. 保存 Bot Token

配置：

openclaw channels add telegram
openclaw configset channels.telegram.botToken"your-bot-token"
openclaw gateway restart

2. WhatsApp

# 登录 WhatsApp（显示二维码）
openclaw channels login whatsapp

# 用手机 WhatsApp 扫码

3. 企业微信（国内推荐）

# 安装企业微信插件
openclaw plugins install @m1heng-clawd/wework

# 配置
openclaw configset channels.wework'{"enabled":true,"corpId":"xxx","agentSecret":"xxx"}' --json

4. 飞书（国内推荐）

# 安装飞书插件
openclaw plugins install @m1heng-clawd/feishu

# 配置
openclaw configset channels.feishu'{"enabled":true,"appId":"cli_xxx","appSecret":"xxx"}' --json

常用命令速查

系统管理

配置管理