折腾过各种“AI 工具箱”的朋友，大概率都会遇到同一个尴尬：看上去功能很多，真正要跑起来却卡在环境、权限、网络和端口上。尤其是 Windows 机器，明明只是想把 OpenClaw 先装起来试试，结果不是脚本没权限，就是依赖装不对，再不然就是跑起来了但网页打不开——心态直接被磨没。

这篇文章我就只做一件事：把 Windows 上安装 OpenClaw 这件事讲清楚、讲顺手。你不用先理解一堆概念，也不需要“照着感觉自己补步骤”。我把安装路径分成两条：一条是更稳妥的 WSL2（更接近 Linux 的官方环境，后续坑更少），另一条是原生 Windows（更快上手，但对 PowerShell 和系统环境更挑剔）。你按自己的习惯选一条走完，最终目标只有一个——在浏览器里打开 http://127.0.0.1:18789，看到 OpenClaw 的界面，这就算成了。

零、彻底卸载 OpenClaw

很多人之前自己尝试装过 OpenClaw，但是报错了，后来放弃了，还留了部分残余，要先处理一下。

#停止网关
openclaw gateway stop
#卸载系统服务（launchd/systemd/schtasks）
openclaw gateway uninstall
# 卸载全局包
npm uninstall -g openclaw
# 删除配置目录（替换为你的用户名，或者手动删除该目录。
Remove-Item -Recurse -Force C:\Users\你的用户名\.openclaw
# 清理缓存
npm cache clean --force
# 验证
openclaw --version

一、打好地基：选择你的安装方案

方案A：通过WSL2安装（推荐大多数用户）

特点：在Windows内创建一个独立的Linux小环境，兼容性最好，后续问题最少
适合谁：希望稳定、长期使用，不介意多几步配置的用户
预计时间：20-30分钟

方案B：原生Windows安装（适合熟悉系统的用户）

特点：直接在Windows环境下运行，更符合Windows用户的操作习惯
适合谁：熟悉PowerShell，希望快速体验，不想折腾WSL的用户
预计时间：10-15分钟

方案C：通过docker安装（略）

二、方案A详细步骤：通过WSL2安装（最稳妥的路径）

第1步：启用Windows的WSL功能

在电脑左下角搜索框输入“PowerShell”
在出现的“Windows PowerShell”应用上，右键单击，选择“以管理员身份运行”（这是关键！）
在弹出的蓝色窗口里，逐一输入下面两条命令，每条输入后按回车：

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

输入完毕后，重启你的电脑
第2步：手动安装Ubuntu系统（避开官方命令的坑）

很多朋友卡在 wsl --install命令，下载进度永远是0%。我们换一种更可靠的手动安装法。

电脑重启后，再次以管理员身份打开PowerShell
输入以下命令并回车，将WSL的默认版本设置为性能更好的第2代：

wsl --set-default-version 2 #切换为wsl2
wsl --list --verbose #查看所有安装的发行版
wsl --unregister Ubuntu-22.04 #卸载已经安装的旧版本Ubuntu-22.04
wsl --install -d Ubuntu-22.04 #在线安装指定版的Ubuntu-22.04

打开你的浏览器（如Edge或Chrome），直接访问以下链接，会开始自动下载一个安装包：

https://aka.ms/wslubuntu2204

下载的文件名类似*Ubuntu2204-221101.AppxBundle*，请记住它的保存位置（通常在“下载”文件夹里）

回到刚才的管理员PowerShell窗口。我们需要导航到下载目录，例如：

cd D:\TDDOWNLOAD

请将“路径”替换成你自己电脑的路径

然后执行安装命令（请确保文件名一致）：

 Add-AppxPackage Ubuntu2204-221101.AppxBundle

看到提示“操作成功完成”后，关闭这个窗口。

第3步：初始化Linux系统

点击屏幕左下角的“开始”菜单，找到并点击新出现的 “Ubuntu 22.04 LTS” 图标
首次启动会进行安装，等待几分钟后，会提示你 “Enter new UNIX username:”，意思是让你设置一个Linux系统的用户名（比如 openclawuser），输入后回车
接着会提示你设置密码。输入时屏幕不会显示任何字符，这是正常的，凭感觉输完回车即可。请务必记住这个密码

至此，一个完美的Linux环境就准备好了。后续所有操作，除非特别说明，都在这个 “Ubuntu” 窗口里进行。

第4步，Ubuntu 中安装 OpenClaw

1. 更新系统包列表

sudo apt update && sudo apt upgrade -y

#2. 安装Git（下载源码用）

sudo apt install git -y

#3. 安装Node.js（LTS版，OpenClaw核心依赖）

方法1：用官方源安装（推荐，版本新）

#下载并执行Node.js 22.x的源配置脚本 #安装 Node.js 22.x（含 npm）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 卸载node和npm，便于重装
sudo apt remove -y nodejs npm
# 清理残留文件
sudo apt autoremove -y

方法2：若方法1失败，用Ubuntu默认源（版本可能稍旧）

sudo apt install nodejs npm -y

验证安装（显示版本号即成功）

node -v
npm -v
git --version

4.安装 OpenClaw（全局安装）

依赖装好后，在终端执行 Ubuntu 下的 OpenClaw 安装命令：

#全局安装最新版OpenClaw，这一部时间可能较长

sudo npm install -g openclaw@latest #总是出错，不知道什么原因，使用下面的官方命令吧
官方命令：curl -fsSL https://openclaw.ai/install.sh | bash
# 验证安装（显示版本号即成功）
openclaw --version #简写成这样好像也可以openclaw -v

第5步，Ubuntu 中启动 OpenClaw 并访问控制界面

1. 先完成初始化配置（解决“Missing config”报错）

openclaw setup

# 按提示选“local”模式，回车默认即可

2. 启动网关（默认端口18789）

openclaw gateway

# 或临时跳过配置快速启动
# openclaw gateway --allow-unconfigured --mode local

三、方案B详细步骤：原生Windows安装（最直接的路径）

如果你不想配置WSL，希望直接在Windows环境下运行，可以按照以下步骤操作：

[图片上传失败...(image-f0fcad-1771912166473)]

第1步：安装运行环境

1.1 OpenClaw基于Node.js开发，所以首先需要安装Node.js环境。

访问Node.js官网下载页面：

https://nodejs.org/zh-cn/download/
下载 Windows安装程序 (.msi)，建议选择 长期支持版(LTS)，目前是Node.js 22.x版本
双击下载的.msi文件，按照向导提示完成安装
安装完成后，验证是否安装成功：

在开始菜单搜索“PowerShell”，打开Windows PowerShell（无需管理员权限）
输入以下命令查看版本：

node --version
npm --version

如果两个命令都能正确显示版本号（如v22.x.x），说明安装成功。

1.2 OpenClaw 的部分功能依赖 Git，需要提前安装。

访问 Git 官网：https://git-scm.com/install/windows
点击下载最新版本
双击安装，一路 Next 即可（保持默认选项）

第2步：放宽PowerShell执行权限

由于OpenClaw安装脚本需要执行权限，我们需要调整PowerShell的安全策略。

在开始菜单搜索“PowerShell”
在“Windows PowerShell”上右键单击，选择“以管理员身份运行”
在弹出的窗口中输入以下命令并按回车：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
执行效果：静默、无交互地将当前用户的 PowerShell 执行策略设为 RemoteSigned。
或者以下命令
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
需要交互确认，才能将当前用户的执行策略设为 RemoteSigned。

当系统询问是否更改执行策略时，输入 Y并按回车
查看当前权限

Get-ExecutionPolicy -List
如果 CurrentUser 显示 Restricted，说明不允许运行脚本。
RemoteSigned 的意思是：本地脚本可以运行，从网上下载的脚本需要有签名。

第3步：一键安装OpenClaw

确保你还在刚才的管理员PowerShell窗口中
输入以下命令开始安装：

iwr -useb https://openclaw.ai/install.ps1 | iex

安装过程会自动进行，可能会持续几分钟。期间如果系统弹出安全警告，请选择“是”或“允许”以继续安装
安装完成后，你会看到成功的提示信息

第4步：验证安装

验证安装

openclaw --version # 验证安装成功
openclaw gateway start # 启动 gateway 服务
openclaw onboard # 然后再配置
openclaw --help # 查看所有命令
openclaw gateway status # 查看 gateway 状态
openclaw gateway stop # 停止 gateway
openclaw doctor # 诊断问题

安装完成后，可以直接运行以下命令启动配置向导：

openclaw onboard

为了快速验证，在配置向导中：
遇到任何风险提示都选 Y
Onboarding模式选择 QuickStart
当问及配置模型和渠道时，选择 Skip for now
完成后，在浏览器中访问：

http://127.0.0.1:18789

如果能看到OpenClaw的Web管理界面，说明安装成功。
如果一直提示拒绝连接，可能的原因是OpenClaw Gateway 根本没在监听。
可以通过以下代码检查并处理：

# 启动配置向导（按提示完成）
openclaw onboard
# 查看版本
openclaw --version
# 启动网关
openclaw gateway start
# 查看状态
openclaw status
openclaw gateway run --verbose
$ netstat -ano | findstr 18789
Get-Process -Id 2144 -ErrorAction SilentlyContinue | Select-Object Id,ProcessName,Path,StartTime
Start-Process -FilePath openclaw -ArgumentList 'gateway','run','--verbose' -WindowStyle Hidden
#把 openclaw gateway run --verbose 作为后台进程启动了：
openclaw gateway run --verbose
#前台跑，日志会直接显示在当前窗口里，关掉窗口通常就停了

四、安装后的重要提醒

无论你选择了方案A还是方案B，安装成功后都需要注意以下几点：

1、如果你选择了方案A（WSL2路径）：

所有后续的OpenClaw操作（如配置、更新、查看日志）都需要在Ubuntu终端中进行
启动命令是：在Ubuntu终端输入 openclaw onboard
查看日志命令是：在Ubuntu终端输入 openclaw logs follow

2、如果你选择了方案B（原生Windows路径）：

所有后续的OpenClaw操作都需要在PowerShell中进行
启动命令是：在PowerShell输入 openclaw onboard
查看日志命令是：在PowerShell输入 openclaw logs follow

3、两个方案的区别总结：

对比项	方案A（WSL2）	方案B（原生Windows）
稳定性	⭐⭐⭐⭐⭐（官方推荐）	⭐⭐⭐⭐
兼容性	⭐⭐⭐⭐⭐（与Linux完全一致）	⭐⭐⭐⭐（依赖Windows环境）
安装复杂度	⭐⭐⭐（需额外配置WSL）	⭐⭐（直接安装）
后续维护	⭐⭐⭐（需在Linux环境操作）	⭐⭐⭐⭐（在熟悉环境操作）
适合人群	追求稳定、长期使用的用户	熟悉Windows、想快速体验的用户

4、常见问题处理：

问题1：安装过程中网络连接失败

解决方案：检查网络连接，特别是如果使用了代理，请确保代理设置正确。对于方案A，可以尝试手动下载安装包；对于方案B，可以稍后重试。

问题2：权限不足导致安装失败

解决方案：确保全程使用管理员身份运行PowerShell。对于方案A，安装Ubuntu时也要用管理员PowerShell。

问题3：端口冲突（18789端口被占用）

解决方案：可以修改OpenClaw的默认端口，或者关闭占用该端口的程序。运行以下命令查看端口占用：

# 在方案A的Ubuntu中

问题4：杀毒软件或防火墙阻止安装

解决方案：暂时关闭第三方杀毒软件（如360、腾讯电脑管家）或Windows Defender防火墙，安装完成后再重新开启。

成功安装OpenClaw只是第一步，就像刚装好操作系统的电脑。为了让你的AI助手真正“活”起来，后续还需要：

配置AI大脑：连接大语言模型（如通义千问、GLM等），让OpenClaw能够思考
配置沟通渠道：接入飞书、微信等，让你能在常用工具中与AI对话
配置技能和工作流：让AI学会处理特定任务，如总结文档、安排日程等

五、接入智慧

1.配置通义千问AI大脑，免费

OpenClaw需要连接一个AI大模型才能“思考”。我们以阿里云的通义千问为例，采用更安全的OAuth授权方式。这一步最简单，选择Qwen就会弹出网页，登录即可，没有账号的可以注册一个。

2. 美团龙猫 LongCat，每天免费额度，普通人完全够用

注册龙猫平台
打开：https://longcat.chat/platform/usage

手机号注册，- 完成实名认证（必须，不然不给API）以前美团实名过的可以直接用。

获取 API Key https://longcat.chat/platform/api_keys
每天都有免费 token，轻度使用完全不花钱。

配置项	值
Api	openai-completions
Api Key	ak_**************************X9z
Base Url	https://api.longcat.chat/openai
models - id	LongCat-Flash-Thinking-2601
models - name	LongCat-Flash-Thinking-2601

具体的配置可以参考这里：https://longcat.chat/platform/docs/zh/OpenClaw.html
简单的办法是直接修改这个文件 ~/.openclaw/openclaw.json

六：打开窗口——配置飞书机器人通道

最后一步，让我们能在最常用的飞书里和AI助手对话。
建议直接参考官方文档配置就可以 https://docs.openclaw.ai/zh-CN/channels/feishu

核心挑战是：飞书服务器需要能把消息发送到一个公网可访问的地址，而我们的OpenClaw只在本地运行。解决办法是使用“内网穿透”工具 ngrok。

1）、用ngrok创建公网隧道

访问 ngrok 官网 (https://ngrok.com/) 注册一个免费账号。
登录后，在后台找到你的 “Authtoken”，并复制它。
在Windows下（不是在Ubuntu里），打开一个新的普通PowerShell窗口（无需管理员）。输入以下命令来配置你的token：

ngrok config add-authtoken 你复制的Authtoken
配置成功后，运行以下命令创建隧道：

ngrok http 18789
命令行会运行起来，并显示重要的转发信息。你会看到一行类似这样的内容：

Forwarding https://a1b2-34-56-78-90.ngrok-free.app -> http://localhost:18789

请复制**https://a1b2-...**这个开头的完整地址，这就是你本地服务的公网大门。让这个PowerShell窗口保持运行，不要关闭！

2）、在飞书开放平台配置机器人

浏览器访问 飞书开放平台：https://open.feishu.cn/，用飞书APP扫码登录。
点击右上角 “创建应用”，选择 “企业自建应用”。
填写应用名称（如“我的工作助手”）和描述，点击创建。
进入应用后，在左侧菜单栏完成以下子步骤：

a. 添加能力：点击“添加能力”，启用 “机器人”。
b. 配置权限：点击“权限管理”，搜索并添加以下三个权限：
im:message(获取与发送单聊、群聊消息)
im:message:send_as_bot(以机器人身份发送消息)
im:message:read_feature(接收消息v2.0)

添加后，点击“批量开通”。
c. 配置事件订阅（核心）：

点击“事件订阅”。
在 “请求地址” 中，粘贴你从ngrok获得的地址，并在其末尾加上固定的路径，最终格式必须是：

https://你获得的ngrok地址.ngrok-free.app/api/channels/feishu/webhook
点击 “重新生成” 按钮生成 Verification Token，并立即复制保存。
点击 “添加事件”，搜索并添加事件 im.message.receive_v1。
点击页面最下方的 “保存” 按钮。

d. 获取凭证：点击“凭证与基础信息”页面，记录下 App ID和 App Secret。

现在，从飞书平台我们得到了三样东西：App ID、App Secret、Verification Token。

3）、在OpenClaw中绑定飞书

回到你的Ubuntu窗口，运行飞书渠道配置命令：

openclaw channel feishu
跟随交互式向导，依次粘贴你刚才记下的 App ID、App Secret和 Verification Token。
配置完成后，再次重启服务：

openclaw gateway restart

4）、发布飞书应用并测试

回到飞书开放平台的应用管理页面。
在左侧找到 “版本管理与发布”，点击 “创建版本”。
填写一个版本号（如1.0.0），在 “可用范围” 选择“全员”或指定部分成员。
点击“保存”，然后点击 “发布”。等待几分钟审核（企业自建应用通常秒过）。
审核通过后，在飞书APP的聊天列表顶部搜索你刚创建的应用名称（如“我的工作助手”），找到后点击“打开”或“添加”。
现在，你可以在飞书里直接私聊这个机器人，或者把它拉入群聊，然后@它并发送一句“你好”。稍等片刻，你应该就能收到来自通义千问的回复了！

七、openclaw升级

openclaw出现新版本时会有提示：Update available: v2026.3.11 (running v2026.3.8).
升级前建议
停止服务（避免文件占用）：
openclaw gateway stop
备份配置文件（~/.openclaw 或项目目录）。
查看当前版本：
升级：
openclaw update --yes --no-restart
openclaw update 在 Windows 上有个常见坑：它自己正在从 node_modules/openclaw 运行时，npm 需要重命名同一个目录就会报 EBUSY；我改用包管理器在外部直接升级（不走自更新），一般就能绕开这个锁。
pnpm -v
npm config get prefix
npm install -g openclaw@2026.3.11
升级完成后：
openclaw --version #版本检查
openclaw doctor # 健康检查
openclaw gateway restart # 重启服务

八、总结

到这里，其实你已经完成了最关键的一步：让 OpenClaw 在你的 Windows 机器上“站起来”，并且能稳定访问管理界面。后面的事情就不再是“装不装得上”，而是“用不用得顺”——把大模型接上去，让它能回答；把飞书/微信这类渠道接上去，让它能在你日常工具里出现；再把技能和工作流配起来，让它从“会聊天”变成“能干活”。

成功安装只是起点。接下来，你可以把它变成一个真正能帮你分担工作的助手。
Docker方式:https://mp.weixin.qq.com/s/tqTbun3hEa2-feAQxIRsUA

别再折腾了！这篇可能是Windows下部署OpenClaw最省心的保姆级教程