openclaw仅支持windows 10 22h2+/11全系列（需wsl2）、ubuntu/debian/fedora等指定linux发行版（原生运行）、macos sonoma 14.5+/sequoia 15.0+（实验性，需arm64原生），不支持win7/8.1、server、android、ios等。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试在某台设备上运行 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 最低运行阈值
