参考本篇的安装步骤，不需要科学上网，小白都可以轻松上手

安装之前我们说下wsl2 （windows subsystem linux）的事情

根据官方文档，Windows 部署 OpenClaw 不强制要求 WSL2，但强烈推荐，有和没有两重安装方式的区别如下：

特性	WSL2 (推荐)	原生 Windows (不推荐)
兼容性	✅ 完整 Linux 环境，所有功能可用	⚠️ 部分功能受限
浏览器自动化	✅ 正常	⚠️ 可能有问题
技能支持	✅ 大部分 Linux 技能可用	❌ 很多技能仅支持 Linux/macOS
编码问题	✅ 无	⚠️ 中文输出可能乱码
系统服务	✅ systemd 支持	⚠️ 使用 Windows Task Scheduler
安装复杂度	中等	简单但问题多

原生 Windows 的已知问题

• 1.Git依赖 ：需要单独安装 Git for Windows

• 2.路径问题 ：npm global bin 目录需要手动添加到 PATH

• 3.编码问题 ：PowerShell 输出中文可能乱码（代码页问题）

• 4.技能限制 ：很多技能标注了 os: ["darwin", "linux"]，在 Windows 上不可用

• 5.浏览器控制 ：某些自动化功能可能不稳定

基于上述原因，我们采用WSL2的方式部署openclaw，开始正式安装。
 

一 、环境准备

1、安装wsl2

安装前先要打开这个配置（控制面板-程序和功能-启用或关闭Windows功能）：
 

windows :
Windows 10：版本 2004+（Build 19041+）
windows 11 都支持

# 可以先查看下线上有哪些版本
wsl --list --verbose
# 2、安装Ubuntu-24.04 
wsl --install Ubuntu-24.04 
# 3、安装完后查看一下 
wsl --list --verbose 
# 4、安装完后可以安装一下OpenSSH，让ssh客户端连接（非必须） 
sudo apt install openssh-server

建议直接选用用Ubuntu-24.04：

安装需要一段时间，完成后界面如下：

wsl更新会很慢或更新失败，大家可以尝试以下几种方法：
1、hosts加上：20.205.243.166 packages.microsoft.com
2、采用离线安装，下载地址：https://github.com/microsoft/WSL/releases，选择最新稳定版下载
下载后双击安装即可

二、安装步骤

方式、一键安装（推荐）

步骤 1：安装基础依赖

# 更新包列表 
sudo apt update 
# 安装 curl、git、build-essential 
sudo apt install -y curl git build-essential 
# 安装 Node.js 22（如果系统版本低于 22） 
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - 
sudo apt install -y nodejs

步骤 2：运行安装脚本

# 下载并执行安装脚本 
curl -fsSL https://openclaw.ai/install.sh | bash

直接安装因为需要科学上网，所以可能会一直卡在Installing OpenClaw v2026.3.X，设置淘宝镜像即可

# 1. 设置 npm 淘宝镜像 
npm config set registry https://registry.npmmirror.com 
# 2. 设置 pnpm 淘宝镜像 
pnpm config set registry https://registry.npmmirror.com

安装界面如下：

步骤 3：选择安装选项（当然可以跳过，后续再配置，这里主要的选项我都配了一下）

最后验证是否安装成功

# 检查版本 
openclaw --version 
# 检查状态 
openclaw status 
# 检查 Gateway 
openclaw gateway status

登录web ui，如果gateway采用默认端口18789，则访问地址一般是：http://127.0.0.1:18789/chat?session=main,看到下面页面就大功搞成了！！！！！（星球后面会陆续出linux安装教程，配置注意事项以及最佳实践（特别是安全相关），如何和飞书机器人打通，技能安装，skills 开发，多agent配置和协作，多agent记忆如何隔离等）

中间加个广告：

欢迎加入本人新开的星球【盗火笔记】

 

https://t.zsxq.com/lwnvs

【盗火者的技术手札】：多年首席架构师，CTO经历，15年+横跨通信/汽车/金融科技/跨境的复合型技术布道者。从0到1参与主导多个中大型业务中台数据中台建设；AI算法方面，理论扎实，实战经验丰富。

你可以获得：

1、最新最前沿的AIGC的发展趋势分享；

2、不定期AI工程化落地经验的分享；

3、CTO视角的团队管理经验分享；

4、个人有意思的项目分享；

三、可能会遇到的问题

1、安装完后，如果遇到不能识别openclaw命令的问题，大概率是 PATH 环境变量问题，通过下面解决：

步骤 1：找到 npm global bin 目录 
# 查看 npm 全局包安装位置 
# 我的是/home/fuxb/.npm-global 
npm config get prefix 步骤 
2：添加到 PATH 
echo 'export PATH=$HOME/.npm-global/bin:$PATH' >> ~/.bashrc 
步骤 3：刷新配置，最后再验证 
source ~/.bashrc

2、安装完后，如果打开web ui界面遇到下面问题，首次打开的时候地址上带上token就行

# token 在配置文件里 openclaw.json,一般地址是：/home/user/.openclaw/ http://127.0.0.1:18789/?token=自己的token值
3、安装的时候配置选项都可以先跳过，后续直接修改配置文件，或者执行下面的命令，再次运行配置向导

# 启动交互式配置 openclaw onboard --install-daemon