WSL Ubuntu 安装 OpenClaw 避坑指南 + 一键脚本(2026 实测)
在 WSL Ubuntu 上装 OpenClaw 这件事,看起来就是一行 npm install -g 的事情。
实际呢?Node.js 版本不对装不上,npm 连官方源超时,WSL 把内存吃光整个 Windows 卡死,装完了 openclaw 命令找不到。你要是在国内网络环境下操作,再叠加一个镜像切换的问题。
我写 m78setup.sh 就是因为这些坑自己踩过不止一次。
这个脚本到底干了什么
不是什么黑魔法。就是把你手动装的时候会碰到的问题提前处理掉。
| 环节 | 做了什么 |
|---|---|
| 环境检测 | 确认在 WSL Ubuntu 里跑,apt 可用,Node 版本够(最低 22.14.0,推荐 Node 24) |
| 内存保护 | 检查有没有 .wslconfig,没有就提示创建,限制 WSL 吃内存(默认 4GB + 2 核) |
| 内存余量 | 安装前检查可用内存是否至少 500MB,不够就等,防止 npm install 中途 OOM |
| 镜像选择 | 先探测 npmjs 官方源,不通就自动切 npmmirror 中国镜像 |
| 缓存清理 | 先清一遍 npm 缓存,防止之前的损坏文件影响安装 |
| 全局安装 | npm install -g openclaw@latest,权限不够自动 sudo |
| 五重验证 | 检查二进制文件、版本号、npm list、package.json 元数据、bin 入口 |
| PATH 配置 | npm 全局 bin 目录加进 PATH |
脚本全程有日志,跑完会告诉你日志文件在哪。出问题可以直接查。
系统要求
Windows 11 + WSL2 + Ubuntu(20.04 / 22.04 / 24.04)。
Node.js 最低 22.14.0,推荐 Node 24。脚本会自动检查,不够会明确告诉你。
网络方面,能连上 npmjs 或者 npmmirror 就行。脚本会自己探测哪个快。
一句话:如果你不是 WSL Ubuntu 环境,这个脚本不适合你。原生 Linux 或 Docker 直接看 OpenClaw 官方安装文档。
怎么用
下载发布包:
wget https://m78armor.com/downloads/m78setup-release-v2026.04.11.zip
unzip m78setup-release-v2026.04.11.zip
加执行权限:
chmod +x m78setup.sh
跑起来:
./m78setup.sh
跟着提示走就行。
脚本会问你要不要创建 .wslconfig。选 Y。不限制的话,WSL 能把你整台机器的内存吃光,Chrome 加几个 Tab 系统就冻住了。已经有 .wslconfig 的话脚本会读取现有配置并更新,同时保留备份。
选了 Y 之后,脚本会提示你在 PowerShell 里运行 wsl.exe --shutdown 重启 WSL,然后重新跑一遍脚本。
装完之后终端会显示后续步骤:
==================================================
OpenClaw 安装已完成
==================================================
后续步骤:
1. 运行引导式首次设置:
$ openclaw onboard
2. 如需更改设置,可稍后使用:
$ openclaw configure
3. 查看免费的加固检查清单:
访问:https://m78armor.com
==================================================
几个你可能碰到的问题
提示"此候选脚本仅适用于中国 WSL Ubuntu P0 通道"?
脚本在启动时会检查运行环境。如果不是 WSL + Ubuntu + apt 可用,直接退出。这不是 bug,是设计决定。脚本对环境假设很严格,不支持的场景宁可不跑也不给你一个半成品安装。
装到一半卡住了?
先查网络。脚本探测 npmjs 和 npmmirror 两个源,如果两个都不通会直接报错退出。如果只是慢,脚本有内置重试机制(最多 15 次,每次间隔 30 秒)。
如果一直超时,手动指定镜像试试:
npm config set registry https://registry.npmmirror.com
装完了但 openclaw 命令不存在?
脚本会自动把 npm 全局 bin 目录加进 PATH。如果你的 shell 配置比较特殊,手动加一下:
export PATH="$(npm config get prefix)/bin:$PATH"
写进 ~/.bashrc 让它永久生效。
报 sudo: a password is required?
全局安装需要 sudo。确认你的用户有 sudo 权限,提示时输密码就行。
装完之后呢?
脚本只管装。不动安全配置。
这是故意的。安装和加固是两件事,混在一起容易出问题。装完之后你的 OpenClaw 跑的是默认配置——网关可能对公网敞着,认证可能没开,技能安装策略可能是开放的,v2026.4.2+ 的 host exec 还可能是 YOLO 模式。
你至少应该过一遍安全检查。
我写了一份 18 步加固清单,覆盖 CVE 修复、网关锁定、凭证保护、技能审查、浏览器隔离这些关键项。每一步都附了命令,手动走完大概 60-90 分钟。完整的图文版发在 CSDN 上了:
👉 https://blog.csdn.net/m78armor/article/details/160090522
如果你觉得手动走 18 步太费时间,M78Armor 自动化加固脚本(¥88 基础版 / ¥188 专业版)能把这个过程压到 10 分钟内,还自带 ClawHavoc 恶意技能签名识别。本地运行,不传数据。
👉 Afdian 页面:https://ifdian.net/a/m78armor
免责
脚本按原样提供,不附带任何形式的保证。维护者对因使用此脚本或 OpenClaw 导致的网络暴露、配置错误或数据丢失不承担责任。安装后务必检查安全配置。
碰到问题在评论区说,或者发邮件到 support@m78armor.com。
更多推荐



所有评论(0)