OpenClaw 系统环境配置大全｜Windows、macOS、Linux 三大平台逐项实操

本系列第五篇：三大平台全覆盖——从 WSL2 到 Homebrew，让 OpenClaw 在任意操作系统上稳定运行在上一篇中，我们完成了跨平台的环境预检清单。但实际操作中，Windows、macOS 和 Linux 三者在系统配置层面有着本质差异——权限体系不同、命令工具不同、网络环境不同。这篇文章，我们针对三大平台分别进行完整的实操配置。无论你使用的是 Windows PC、Mac 电脑还是 Linux 服务器，都能在这里找到对应的配置方案。Windows 用户会重点讲解 WSL2 的完整安装流程（这是官方强烈推荐的路径），macOS 用户会涉及 TCC 权限管理和 Apple Silicon 架构问题，Linux 用户则聚焦于依赖管理和系统服务配置。一、先确认操作系统版本正式动手之前，先确认你手上的设备满足最低版本要求：操作系统最低版本推荐版本WindowsWindows 10 (2004+)Windows 11macOSmacOS 12 (Monterey)macOS 14 (Sonoma) 或更新版本LinuxUbuntu 20.04+ / Debian 11+Ubuntu 22.04 LTS各平台验证命令：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：powershellwsl --install -d Ubuntu-22.04推荐使用 Ubuntu 22.04 LTS 版本，这是官方文档中推荐的主流 Linux 发行版。设置为 WSL2 默认版本：powershellwsl --set-default-version 2查看已安装的发行版：powershellwsl --list --verbose确认 Ubuntu 的 VERSION 列显示为 2。首次启动 Ubuntu 子系统/