OpenClaw小龙虾支持哪些系统？

OpenClaw（小龙虾）是一款对操作系统兼容性要求严格的技术工具，仅原生支持主流平台的特定版本：Windows 10 22H2+/11全系列（依赖WSL2）、Ubuntu/Debian/Fedora等指定Linux发行版（性能最优），以及macOS Sonoma 14.5+/Sequoia 15.0+（实验性、仅限ARM64原生运行）；而Win7/8.1、Windows Server、Android、iOS、ChromeOS及非x86_64/ARM64架构系统均被明确排除，启动失败时会报出如“Failed to initialize Gateway core”或“Unsupported architecture”等精准错误提示——想顺畅使用OpenClaw？先确认你的系统是否踩在官方认证的“安全线”上。

如果您尝试在某台设备上运行 OpenClaw（小龙虾），但启动失败或功能异常，则可能是由于操作系统不满足最低兼容要求。以下是 OpenClaw 官方确认支持的操作系统及其具体适配说明：

一、Windows 系统支持范围

OpenClaw 官方提供完整 Windows 适配，但仅限于 Windows 10 22H2 及以上版本、Windows 11 全系列（含 22H2、23H2、24H2）。Windows Server 系列未被官方支持，运行可能出现 Gateway 启动失败、浏览器控制工具加载异常等问题。安装过程强制依赖 WSL2 子系统模拟层，因此必须启用 WSL2 功能并安装 Linux 内核更新包。

1、按下 Win+R，输入 wsl --install 并回车，完成 WSL2 基础环境部署

2、前往 Microsoft Store 安装 Ubuntu 22.04 LTS 发行版（OpenClaw 内置脚本默认调用该版本）

3、在 PowerShell 中执行 wsl --set-default-version 2，确保新发行版默认使用 WSL2

二、Linux 系统原生支持列表

OpenClaw 在 Linux 下为原生运行，无需 WSL 层转换，性能与稳定性最优。官方明确验证通过的发行版包括：Ubuntu 22.04 LTS、Ubuntu 24.04 LTS、Debian 12（bookworm）、Fedora 39。其他基于上述内核的衍生版（如 Linux Mint 21/22、Pop!_OS 22.04）可正常运行，但需手动补全 libgbm1 与 libasound2 库。

1、打开终端，执行 sudo apt update && sudo apt install -y libgbm1 libasound2

2、确认系统时区设置为 Asia/Shanghai（部分技能模块依赖本地时区解析时间指令）

3、运行 cat /proc/sys/fs/inotify/max_user_watches，若返回值小于 524288，需执行 echo 524288 | sudo tee /proc/sys/fs/inotify/max_user_watches

三、macOS 系统支持状态

macOS 目前处于实验性支持阶段，仅适配 macOS Sonoma 14.5 及以上、Sequoia 15.0 正式版。不支持 Apple Silicon（M 系列芯片）的 Rosetta 2 转译模式，必须以原生 ARM64 架构运行。关键限制在于浏览器自动化模块依赖 Chromium 的特定沙箱策略，macOS 默认启用的 Gatekeeper 会拦截部分动态注入行为。

1、在终端中执行 defaults write com.apple.security.cs.disable-library-validation true

2、重启 Safari 或 Chrome，并在地址栏输入 chrome://flags/#unsafely-treat-insecure-origin-as-secure，启用对应标记

3、将 OpenClaw 应用程序拖入“访达 → 应用程序”后，右键选择“显示简介”，勾选 “仍要打开” 选项

四、不支持的操作系统及明确报错特征

OpenClaw 明确不支持 Windows 7/8.1、所有 Windows Server 版本、Android、iOS、ChromeOS、FreeBSD 及任何非 x86_64/ARM64 架构系统。在不支持系统中启动时，会立即触发以下任一错误：「Failed to initialize Gateway core」、「No compatible browser driver found」、「WSL2 subsystem not detected」、「Unsupported architecture: aarch64_be」。

1、查看系统架构命令为 uname -m，仅接受输出为 x86_64 或 aarch64

2、检查内核版本命令为 uname -r，Linux 要求 ≥ 5.15，Windows 要求 ≥ 10.0.22621

3、若出现 "FATAL: kernel too old" 提示，表明内核版本低于 OpenClaw 最低运行阈值

今天关于《OpenClaw小龙虾支持哪些系统？》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！