今天这篇推文，保证你能顺利打开OpenClaw管理界面，真正实现“一键部署、直接能用”。

核心目标：浏览器打开 http://127.0.0.1:18789 ，看到OpenClaw界面，就算成功！

一、先选对路线：两种安装方案，按需Pick

Windows部署OpenClaw，就两条路，不用纠结，根据自己的情况选：

✅ 方案A：WSL2安装（推荐新手/长期使用者）

特点：在Windows里搭建独立Linux小环境，兼容性最好，后续几乎不踩坑，是官方更推荐的方式

适合人群：想长期稳定使用，不介意多花几分钟配置，怕后续出问题的朋友

预计耗时：20-30分钟

✅ 方案B：原生Windows安装（适合老手/快速尝鲜）

特点：直接在Windows环境运行，不用额外装Linux，上手最快，操作更贴合Windows用户习惯

适合人群：熟悉PowerShell，只想快速体验OpenClaw，不想折腾WSL的朋友

预计耗时：10-15分钟

二、方案A：WSL2安装（最稳妥，少踩坑）

第1步：启用Windows的WSL功能（关键一步）

1. 电脑左下角搜索框输入“PowerShell”，右键单击“Windows PowerShell”，选择“以管理员身份运行”（一定要管理员！）

2. 在弹出的蓝色窗口中，逐一输入以下两条命令，每条输入完按回车：

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

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

3. 两条命令都执行完后，重启电脑（必须重启，否则不生效）

第2步：手动安装Ubuntu系统（避开官方命令坑）

很多人卡在wsl --install命令，下载进度一直为0%，咱们换手动安装，更稳妥：

1. 电脑重启后，再次以管理员身份打开PowerShell，输入以下命令并回车（设置WSL默认版本为2）：

wsl --set-default-version 2

2. 打开浏览器（Edge/Chrome均可），访问以下链接，自动下载Ubuntu安装包：

https://aka.ms/wslubuntu2204

3. 记住安装包保存位置（通常在“下载”文件夹），文件名类似Ubuntu_2204.221101.AppxBundle

4. 回到管理员PowerShell窗口，导航到下载目录（替换“你的用户名”为自己电脑的用户名）：

cd C:\Users\你的用户名\Downloads

5. 执行安装命令（确保文件名和下载的一致）：

Add-AppxPackage .\Ubuntu_2204.221101.AppxBundle

6. 看到“操作成功完成”，关闭PowerShell窗口即可。

第3步：初始化Linux系统

1. 点击屏幕左下角“开始”菜单，找到并点击“Ubuntu 22.04 LTS”图标

2. 首次启动会自动安装，等待几分钟后，提示“Enter new UNIX username:”，设置一个Linux用户名（比如openclawuser），输入后回车

3. 接着提示设置密码，输入时屏幕不会显示任何字符（正常现象），输完回车即可，务必记住这个密码

✅ 到这里，Linux环境就准备好了，后续所有操作（除特别说明），都在这个Ubuntu窗口里进行。

三、方案B：原生Windows安装（最快上手）

第1步：安装Node.js运行环境

OpenClaw基于Node.js开发，必须先安装这个环境，步骤很简单：

1. 访问Node.js官网下载页面：https://nodejs.org/zh-cn/download/

2. 下载Windows安装程序（.msi），优先选择长期支持版（LTS），目前推荐Node.js 22.x版本

3. 双击下载的.msi文件，按照向导提示，一路默认下一步，完成安装

4. 验证是否安装成功：打开普通PowerShell（无需管理员），输入以下两条命令，能正常显示版本号即成功：

node --version

npm --version

第2步：放宽PowerShell执行权限

OpenClaw安装脚本需要执行权限，必须调整PowerShell安全策略：

1. 开始菜单搜索“PowerShell”，右键单击“Windows PowerShell”，选择“以管理员身份运行”

2. 输入以下命令，按回车：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force

3. 系统询问是否更改执行策略时，输入Y并回车即可。

第3步：一键安装OpenClaw

1. 保持管理员PowerShell窗口打开，输入以下命令，开始一键安装：

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

2. 安装过程会持续几分钟，期间如果弹出安全警告，一律选择“是”或“允许”，不要取消。

3. 看到成功提示，就说明安装完成了。

第4步：验证安装是否成功

1. 在PowerShell中，执行以下命令，启动配置向导：

openclaw onboard

2. 配置向导快速设置（新手直接按这个来）：

- 遇到任何风险提示，都选Y

- Onboarding模式选择QuickStart

- 配置模型和渠道时，选择Skip for now

3. 打开浏览器，输入http://127.0.0.1:18789，能看到OpenClaw的Web管理界面，就说明安装成功啦！

四、安装后必看：操作指南+常见问题（避坑关键）

1. 常用操作命令（记好，后续常用）

- 方案A（WSL2）：所有操作在Ubuntu终端完成

启动配置向导：openclaw onboard

查看实时日志：openclaw logs follow

- 方案B（原生Windows）：所有操作在PowerShell完成

启动配置向导：openclaw onboard

查看实时日志：openclaw logs follow

2. 两种方案核心区别（纯文本，方便查看）

稳定性：

方案A（WSL2）⭐⭐⭐⭐⭐（官方推荐）

方案B（原生Windows）⭐⭐⭐⭐

兼容性：

方案A（WSL2）⭐⭐⭐⭐⭐（与Linux完全一致）

方案B（原生Windows）⭐⭐⭐⭐（依赖Windows环境）

安装复杂度：

方案A（WSL2）⭐⭐⭐（需额外配置WSL）

方案B（原生Windows）⭐⭐（直接安装）

后续维护：

方案A（WSL2）⭐⭐⭐（需在Linux环境操作）

方案B（原生Windows）⭐⭐⭐⭐（在熟悉的Windows环境操作）

适合人群：方案A适合追求稳定、长期使用的用户；方案B适合熟悉Windows、想快速体验的用户

3. 高频问题一键解决（遇到问题先看这里）

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

解决方案：检查网络连接，若使用代理，确保代理设置正确；方案A可尝试手动下载Ubuntu安装包，方案B可稍后重试安装命令。

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

解决方案：全程必须用“管理员身份”运行PowerShell；方案A安装Ubuntu时，也要用管理员PowerShell操作。

问题3：18789端口被占用（无法打开界面）

解决方案：先查看哪个程序占用端口，再关闭该程序，或修改OpenClaw默认端口；查看端口命令：

方案A（Ubuntu）：sudo netstat -tulpn | grep 18789

方案B（PowerShell）：netstat -ano | findstr 18789

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

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

五、进阶配置：让OpenClaw真正“能用、好用”

安装成功只是第一步，接下来配置AI大脑和沟通渠道，让它从“能打开”变成“能干活”。

1. 配置AI大脑（对接通义千问，最简单）

OpenClaw需要连接大语言模型才能“思考”，这里以通义千问为例，步骤超简单：

1. 启动OpenClaw配置向导（openclaw onboard），选择Qwen（通义千问）模型

2. 选择OAuth授权方式，会自动弹出网页，用通义千问账号登录即可（无账号可免费注册）

3. 登录成功后，自动完成对接，AI就能正常回答问题了。

2. 配置飞书机器人（随时在飞书和AI对话）

核心难点：飞书服务器需要访问公网地址，而我们的OpenClaw在本地运行，用ngrok做内网穿透即可解决。

① 用ngrok创建公网隧道

1. 访问ngrok官网（https://ngrok.com/），注册一个免费账号

2. 登录后，在后台找到自己的Authtoken，复制下来

3. 打开普通PowerShell（无需管理员），输入以下命令配置token（替换“你的Authtoken”为复制的内容）：

ngrok config add-authtoken 你的Authtoken

4. 配置完成后，执行以下命令创建隧道：

ngrok http 18789

5. 命令行运行后，会显示一个公网地址（格式：https://xxx.ngrok-free.app），复制这个地址，不要关闭PowerShell窗口！

② 飞书开放平台配置机器人

1. 浏览器访问飞书开放平台（https://open.feishu.cn/），用飞书APP扫码登录

2. 点击右上角“创建应用”，选择“企业自建应用”，填写应用名称（如“我的OpenClaw助手”）和描述，点击创建

3. 进入应用后，完成以下3步：

a. 添加能力：点击“添加能力”，启用“机器人”功能

b. 配置权限：点击“权限管理”，搜索并添加3个权限：im:message、im:message:send_as_bot、im:message:read_feature，添加后点击“批量开通”

c. 配置事件订阅（核心）：点击“事件订阅”，在“请求地址”中粘贴刚才复制的ngrok公网地址，末尾加上固定路径，最终格式：https://你的ngrok地址/api/channels/feishu/webhook；点击“重新生成”Verification Token，复制保存；添加事件im.message.receive_v1，点击底部“保存”

4. 点击“凭证与基础信息”，记录下App ID、App Secret（和刚才的Verification Token一起保存）

③ OpenClaw绑定飞书

1. 回到Ubuntu窗口（方案A）或PowerShell（方案B），执行命令：openclaw channel feishu

2. 跟随向导，依次粘贴刚才保存的App ID、App Secret、Verification Token

3. 配置完成后，重启服务：openclaw gateway restart

④ 测试飞书机器人

1. 回到飞书开放平台，点击“版本管理与发布”，创建版本（版本号如1.0.0），可用范围选择“全员”或指定成员，点击“发布”

2. 飞书APP搜索应用名称，添加后，私聊发送“你好”，能收到AI回复，就说明配置成功了！

六、写在最后

其实OpenClaw部署真的不难，难的是避开那些不必要的坑——权限不够、命令输错、端口占用，只要跟着这篇教程，复制命令、按步骤操作，新手也能轻松搞定。

成功安装只是起点，后续你可以继续配置更多大模型、接入微信等其他渠道，再设置专属技能和工作流，让OpenClaw真正成为能帮你分担工作的AI助手。

如果部署过程中遇到问题，欢迎在留言区留言，我会一一帮你排坑～

💡 新手小贴士：纯新手优先选方案A（WSL2），虽然多几步配置，但后续几乎不踩坑；所有命令尽量复制粘贴，避免手敲出错哦！