在 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。

Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐