夜雨聆风本系列第五篇：三大平台全覆盖——从 WSL2 到 Homebrew，让 OpenClaw 在任意操作系统上稳定运行
在上一篇中，我们完成了跨平台的环境预检清单。但实际操作中，Windows、macOS 和 Linux 三者在系统配置层面有着本质差异——权限体系不同、命令工具不同、网络环境不同。
这篇文章，我们针对三大平台分别进行完整的实操配置。无论你使用的是 Windows PC、Mac 电脑还是 Linux 服务器，都能在这里找到对应的配置方案。Windows 用户会重点讲解 WSL2 的完整安装流程（这是官方强烈推荐的路径），macOS 用户会涉及 TCC 权限管理和 Apple Silicon 架构问题，Linux 用户则聚焦于依赖管理和系统服务配置。
一、先确认操作系统版本
正式动手之前，先确认你手上的设备满足最低版本要求：
各平台验证命令：
Windows：在 PowerShell 中运行
winvermacOS：在终端中运行
sw_versLinux：在终端中运行
lsb_release -a或cat /etc/os-release
如果版本偏低，建议先完成系统升级再继续后续步骤。
二、国内网络优化——三平台通用
在正式开始系统配置之前，有一个贯穿全平台的准备工作：网络优化。OpenClaw 及其依赖的下载源位于海外，国内用户如果不做优化，可能会遇到依赖下载超时、安装脚本卡住、技能无法获取等一系列问题。
好消息是，2026 年 4 月 2 日，火山引擎与 OpenClaw 官方正式合作共建了 ClawHub 中国镜像站，地址为 https://mirror-cn.clawhub.com。
该镜像站完整同步全球技能库，支持中文搜索，对中国开发者更友好。ClawHub 官方技能库目前已有超过 4.3 万个 Skills，覆盖全场景。
在后续配置中，建议将 ClawHub 镜像站设为技能查找的默认入口。例如，当你需要搜索某个技能时，可以使用以下指令：
“通过 clawhub 寻找 youtube 技能，registry 使用镜像站 https://mirror-cn.clawhub.com”
即可快速接入镜像站、下载并使用相应的技能。
三、Windows 平台完整配置指南
3.1 为什么必须用 WSL2？
这是 Windows 用户最关键的一个决策。
OpenClaw 官方文档明确指出：推荐在 Windows 上通过 WSL2 运行 OpenClaw（推荐 Ubuntu）。CLI + Gateway 网关在 Linux 内运行，这能保持运行时一致，并使工具链兼容性高得多（Node/Bun/pnpm、Linux 二进制文件、Skills）。
原生 Windows 虽然也在逐步完善支持，但 WSL2 仍然是官方推荐的路径。
3.2 步骤一：以管理员身份打开 PowerShell
按下 Win 键，搜索 PowerShell，右键选择 “以管理员身份运行” 。
这一步至关重要。后续所有 WSL2 的安装和配置操作都必须在管理员权限下执行。
3.3 步骤二：安装 WSL2 并配置 Ubuntu
安装 WSL2：
powershell
wsl --install -d Ubuntu-22.04推荐使用 Ubuntu 22.04 LTS 版本，这是官方文档中推荐的主流 Linux 发行版。
设置为 WSL2 默认版本：
powershell
wsl --set-default-version 2查看已安装的发行版：
powershell
wsl --list --verbose确认 Ubuntu 的 VERSION 列显示为 2。
首次启动 Ubuntu 子系统： 安装完成后，在开始菜单中找到并启动 Ubuntu，系统会提示你创建用户名和密码（该密码用于子系统内的 sudo 操作，可以与 Windows 登录密码不同）。
3.4 步骤三：配置 WSL2 资源限制（可选但推荐）
在 Windows 用户目录下创建 .wslconfig 文件，限制 WSL2 的内存和 CPU 使用量，避免 OpenClaw 长期运行时占用过多宿主机资源：
powershell
# 在 PowerShell 中执行notepad "(whoami)"
安装 OpenClaw Gateway 用户服务（需要先完成 OpenClaw 安装，详见第 6 篇）：
openclaw gateway install在 Windows 启动时自动启动 WSL（以管理员身份打开 PowerShell）：
powershell
schtasks /create /tn "WSL Boot" /tr "wsl.exe -d Ubuntu --exec /bin/true" /sc onstart /ru SYSTEM将 Ubuntu 替换为你实际使用的发行版名称。
3.8 Windows 原生运行（备选方案）
如果你确实需要在原生 Windows 上运行 OpenClaw（不通过 WSL2），请注意以下事项：
通过
install.ps1使用网站安装器可以完成安装本地 CLI 用法（如
openclaw --version、openclaw doctor）在原生 Windows 上运行良好但当前仍有一些限制，WSL2 是更稳妥的选择
四、macOS 平台完整配置指南
4.1 为什么 macOS 是“养虾”的理想平台？
社区公认，Mac Mini（M1/M2/M4 芯片）是运行 OpenClaw 的理想宿主，能效比高，适合 24 小时挂机。
硬件推荐：推荐使用 M1/M2/M4 芯片的 Mac，并配有至少 16GB 内存。虽然 8GB 也能运行，但在处理复杂自动化脚本时，内存压力会导致响应延迟。
系统版本：建议升级至 macOS 14 (Sonoma) 或更高版本，以获得最佳的磁盘访问权限管理。
4.2 步骤一：安装 Homebrew（macOS 包管理器）
Homebrew 是 macOS 上安装和管理软件的最便捷工具。
/bin/bash -c "(npm root -g)/openclaw/node_modules/node-llama-cpp/bins/应包含 arm64 相关文件名
4.6 步骤五：系统权限配置（TCC）
macOS 使用 TCC（Transparency, Consent, and Control）机制管控对敏感资源的访问（如磁盘、摄像头、麦克风等）。
OpenClaw 需要访问文件系统和执行系统命令，可能会触发 TCC 权限提示。你需要：
在 系统设置 → 隐私与安全性 → 完全磁盘访问权限 中，添加终端应用（如 Terminal.app 或 iTerm.app）
在 系统设置 → 隐私与安全性 → 自动化 中，授权终端控制其他应用（如需要）
如果遇到权限错误，可以安装权限修复工具：
npm install -g @stakeswky/openclaw-permctl该工具会自动检测 TCC 权限错误并引导修复。
4.7 步骤六：开启远程 SSH 访问（无头服务器可选）
如果你将 Mac 作为无头服务器（不连接显示器），建议开启 SSH 远程访问：
系统设置 → 通用 → 共享 → 远程登录，开启服务并添加允许的用户。
这样你就可以从局域网内其他设备通过 SSH 登录和管理 OpenClaw。
4.8 macOS 菜单栏配套应用
OpenClaw 还提供了一个 macOS 菜单栏配套应用（OpenClaw.app），它拥有权限在本地管理/附加到 Gateway 网关（通过 launchd 或手动），并作为节点向智能体暴露 macOS 功能。
安装 OpenClaw 主程序后，可以访问官方文档获取配套应用的下载链接。
五、Linux 平台完整配置指南
5.1 推荐发行版
OpenClaw 对 Linux 的支持非常完善，官方推荐使用 Ubuntu 22.04 LTS 或更新版本。Ubuntu 22.04 LTS 具有以下优势：
长期支持（5 年安全更新）
内核版本 ≥ 5.4，支持容器化部署
apt 软件源丰富，依赖安装便捷
5.2 步骤一：更新系统并安装基础依赖
sudo apt update && sudo apt upgrade -ysudo apt install -y git curl wget build-essential
5.3 步骤二：安装 Node.js 22 LTS
方案一：使用 NodeSource 官方源（推荐）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -sudo apt-get install -y nodejs
方案二：使用 nvm（Node Version Manager）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bashsource ~/.bashrcnvm install 22nvm use 22
验证安装：
node -v # 应显示 v22.x.xnpm -v
5.4 步骤三：安装 Docker（生产环境强烈推荐）
# 安装 Dockercurl -fsSL https://get.docker.com -o get-docker.shsudo sh get-docker.sh# 将当前用户添加到 docker 组（避免每次 sudo）sudo usermod -aG docker USER
5.6 步骤五：国内网络优化（可选）
配置 npm 镜像源：
npm config set registry https://registry.npmmirror.com配置 ClawHub 镜像站：在技能查找时，指定使用中国镜像站 https://mirror-cn.clawhub.com。
六、配置验证——三大平台通用
完成以上平台专属配置后，建议运行 OpenClaw 官方提供的环境预检脚本，确保一切就绪：
curl -fsSL https://openclaw.ai/env-check.sh | bash预期输出：All checks passed——表示环境合格，可以进入安装阶段。
如果输出 Failed：按提示升级对应软件后重新检测。
七、三大平台配置速查清单
| 包管理器 | |||
| Node.js | brew install node@22 | ||
| Git | sudo apt install git | brew install git | sudo apt install git |
| Docker | curl -fsSL https://get.docker.com | sh | ||
| 权限要点 | |||
| 国内优化 | |||
| 开机自启 | |||
| 无头服务器 |
八、平台专属踩坑指南
以下整理了各平台最容易踩的坑，建议配置前先看一眼：
Windows：
未以管理员身份运行 PowerShell → WSL2 安装失败 → 务必右键“以管理员身份运行”
虚拟化未开启 → WSL2 无法运行 → 在 BIOS 中启用 VT-x/AMD-V
Windows 版本低于 2004 → WSL2 不支持 → 升级 Windows 版本
忘记配置 .wslconfig → WSL2 占用内存过高 → 限制为 4-6GB
macOS：
终端在 Rosetta 模式下运行 → 架构检测错误 → 在终端简介中取消勾选“使用 Rosetta 打开”
TCC 权限未授予 → 文件访问被拒绝 → 在系统设置中授权终端完全磁盘访问权限
未安装 Docker → 无法启用沙箱隔离 → 强烈建议安装 Docker Desktop
Linux：
Node.js 版本低于 22 → 安装脚本报错 → 使用 NodeSource 源安装最新 LTS
未安装 Docker 或版本过低 → 沙箱模式不可用 →
docker --version确认 ≥ 20.10用户未加入 docker 组 → 每次执行 Docker 命令都需要 sudo →
sudo usermod -aG docker $USER
九、配置完成后的检查清单
完成本章所有平台专属配置后，请逐项核对：
wsl --list --verbose | |||
wsl -d Ubuntu | |||
node -v | |||
git --version | |||
docker --version | |||
npm config get registry | |||
curl -fsSL https://openclaw.ai/env-check.sh | bash | |||
node -e "console.log(process.arch)" | |||
完成以上所有步骤后，你的系统环境已经为 OpenClaw 的安装做好了万全准备。
十、下一步做什么？
系统环境配置完成后，你将进入 OpenClaw 的正式安装阶段：
第 6 篇：《OpenClaw 一键安装教程》——全平台通用，3 分钟完成部署
第 7 篇：《阿里云部署 OpenClaw 保姆级教程》——10 分钟云端极速上线
第 8 篇：《OpenClaw 开发者版安装教程》——npm/pnpm + 源码编译，适合进阶用户
第 9 篇：《OpenClaw Docker 部署完整指南》——沙箱隔离 + 容器化运行最佳实践
如果你已经完成了所有配置项的检查，可以直接跳到第 6 篇开始安装。如果你是 Windows 用户并且已经完成了 WSL2 的配置，你可以在 Ubuntu 子系统中直接执行一键安装命令——整个过程会顺畅很多。
💡 安全提醒：无论你使用哪个平台，都强烈建议安装 Docker。2026 年 3 月，官方因早期版本默认权限过高引发的安全隐患，紧急“封印”了 Agent 核心功能——默认配置仅保留“消息发送+会话管理”权限。后续的安全配置篇会详细讲解如何安全地开启系统命令执行、文件操作等高级功能，Docker 沙箱是实现安全运行的基础设施。
下一篇预告：我们将正式进入 OpenClaw 的安装环节——第 6 篇《OpenClaw 一键安装教程》，提供全平台通用的 3 分钟快速部署方案，并附赠国内网络优化的完整配置。
