OpenClaw Windows 环境部署完整教程

type

Post

status

Published

date

Feb 6, 2026

slug

openclaw-windows-setup-guide

summary

本教程详细介绍如何在 Windows 系统上本地部署 OpenClaw（原 Clawdbot/Moltbot）AI 助手。OpenClaw 是 2026 年 GitHub 上增长最快的开源 AI 助手项目，核心能力包括：读写本地文件、执行终端命令、运行脚本（PowerShell/Batch）；Chrome/Edge 自动化、网页截图；WhatsApp、Telegram、Discord、Slack、企业微信、飞书、钉钉等多渠道交互

项目地址

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，执行：

重启计算机。

2. 安装 Ubuntu

方法：Microsoft Store 安装（推荐）

打开 Microsoft Store

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

点击「获取」并安装

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

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

3. 更新 Ubuntu 系统

在 Ubuntu 终端中执行：

4. 安装 Node.js 22+

5. 安装 OpenClaw

方法 A：一键脚本安装

6. 验证安装

7. 配置 Windows 访问 WSL2 服务

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

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

或直接在 WSL2 中启动：

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

PowerShell 原生部署

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

1. 安装 Node.js 22+

方法：官网下载安装

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

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

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

2. 验证 Node.js 安装

3. 以管理员身份安装 OpenClaw

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

4. 解决安装权限问题

如果遇到权限错误：

5. 验证安装

6. 解决常见问题

问题：sharp 模块加载失败

问题：Windows Defender 阻止

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

初始化配置

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

启动初始化向导

配置 AI 模型提供商

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

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

绑定消息渠道

1. Telegram创建 Bot：

在 Telegram 搜索 @BotFather

发送 /newbot 创建机器人

保存 Bot Token

配置：

2. WhatsApp

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

4. 飞书（国内推荐）

常用命令速查

系统管理

命令	功能
`openclaw --version`	查看版本
`openclaw status`	查看系统状态
`openclaw health`	健康检查
`openclaw update`	更新 OpenClaw
`openclaw doctor`	诊断系统问题

配置管理

命令	功能
`openclaw onboard`	初始化向导
`openclaw configure`	交互式配置
`openclaw config get <key>`	查看配置项
`openclaw config set <key> <value>`	修改配置项
`openclaw config unset <key>`	删除配置项