<blockquote cms-style="blockquote">openclaw官方支持macos 12+、linux主流发行版、wsl2下的windows、termux中的android及云服务器ubuntu/centos；不支持windows原生终端、wsl1、macos 11及以下、arm64 windows原生、ios/ipados/harmonyos；需8gb+内存、2gb存储、x86_64/arm64 cpu、node.js v22.x、python 3.10/3.11；依赖claude/gpt api密钥、telegram bot token等网络凭证，并严格限制文件系统权限与路径访问方式。</blockquote><div class="img_wrapper"><img src="https://k.sinaimg.cn/n/sinakds/438/w280h158//fbff-dd6fee1f59b9267f1127cbca7b18e0bf.jpg/w700d1q75cms.jpg?by=cms_fixed_width" w="280" h="158" wh="1.77"/></div><p cms-style="font-L">　　如果您希望部署 OpenClaw 本地自动化 AI 助手，但不确定当前设备是否满足运行条件，则需明确其官方支持的操作系统与硬件环境。以下是验证兼容性的具体步骤：</p><p cms-style="font-L strong-Bold">　　一、官方支持的操作系统</p><p cms-style="font-L">　　OpenClaw 并非全平台原生兼容，其核心功能依赖 POSIX 兼容环境及特定系统服务（如 systemd、iMessage 协议栈），因此仅在以下操作系统及其变体中被正式验证通过：</p><p cms-style="font-L">　　1、macOS 12 及以上版本，包括 Intel x86_64 与 Apple Silicon（M1/M2/M3）架构；</p><p cms-style="font-L">　　2、Linux 主流发行版：Ubuntu 20.04+、Debian 11+、Fedora 35+、Arch Linux；</p><p cms-style="font-L">　　3、Windows 系统仅通过 WSL2 子系统支持，要求 Windows 10 版本 1903（内部版本 ≥ 18362）或 Windows 11 任意常见版本；</p><p cms-style="font-L">　　4、Android 平台可通过 Termux 环境部署，但需手动编译依赖并禁用部分图形化组件；</p><p cms-style="font-L">　　5、云服务器环境支持 Ubuntu 22.04/24.04 LTS、CentOS 8+，推荐使用 x86_64 架构实例。</p><p cms-style="font-L strong-Bold">　　二、不支持的运行环境</p><p cms-style="font-L">　　OpenClaw 明确排除以下环境，尝试强行部署将导致关键功能缺失或进程崩溃：</p><p cms-style="font-L">　　1、Windows 原生命令提示符、PowerShell 或 CMD 中直接执行 <font cms-style="font-L strong-Bold"><font cms-style="font-L strong-Bold color120">openclaw start</font></font> 命令；</p><p cms-style="font-L">　　2、WSL1 或旧版 WSL（未启用虚拟机平台与适用于 Linux 的 Windows 子系统功能）；</p><p cms-style="font-L">　　3、macOS 低于 12.0 的版本（如 macOS 11 Big Sur），因缺少 Core ML 3.0 与 iMessage WebKit 接口；</p><p cms-style="font-L">　　4、ARM64 架构的 Windows 原生系统（非 WSL2 环境），因缺乏 Chromium Embedded Framework（CEF）适配层；</p><p cms-style="font-L">　　5、iOS、iPadOS 及 HarmonyOS 设备，无终端模拟器与 Node.js 完整运行时支持。</p><p cms-style="font-L strong-Bold">　　三、硬件与运行时依赖要求</p><p cms-style="font-L">　　即使操作系统匹配，若底层硬件或运行时不符合最低规格，OpenClaw 将无法启动浏览器自动化模块或大模型代理服务：</p><p cms-style="font-L">　　1、内存：最低 8GB RAM，<font cms-style="font-L strong-Bold"><font cms-style="font-L strong-Bold color120">推荐 16GB 或以上</font></font>，AI 代理并发执行多个 Chromium 实例时内存占用峰值可达 10GB；</p><p cms-style="font-L strong-Bold">　　2、存储：至少预留 2GB 可用磁盘空间，用于存放插件包、WebDriver 缓存、日志文件及用户记忆数据库；</p><p cms-style="font-L strong-Bold">　　3、CPU 架构：x86_64 或 ARM64，不支持 32 位（i386）指令集；</p><p cms-style="font-L strong-Bold">　　4、Node.js 运行时：必须为 v22.x 系列，<font cms-style="font-L strong-Bold"><font cms-style="font-L strong-Bold color120">v20.x 及更低版本将触发依赖解析失败</font></font>；</p><p cms-style="font-L strong-Bold">　　5、Python 环境：需 Python 3.10 或 3.11，禁止使用系统默认 Python（如 Ubuntu 22.04 自带的 3.10.12 需确认 patch 版本兼容性）。</p><p cms-style="font-L strong-Bold">　　四、网络与凭证前置条件</p><p cms-style="font-L strong-Bold">　　OpenClaw 启动后需即时连接远程服务以完成初始化，离线或受限网络将中断配置流程：</p><p cms-style="font-L strong-Bold">　　1、API 密钥：必须提前获取 <font cms-style="font-L strong-Bold"><font cms-style="font-L strong-Bold color120">Claude 3.5 Sonnet 或 GPT-4o 的有效 API Key</font></font>，OAuth 登录仅限 Anthropic Pro/Max 订阅用户；</p><p cms-style="font-L strong-Bold">　　2、通信信道凭证：Telegram Bot Token 为默认遥控通道，<font cms-style="font-L strong-Bold"><font cms-style="font-L strong-Bold color120">飞书 App ID 与 App Secret 为可选替代方案</font></font>；</p><p cms-style="font-L strong-Bold">　　3、代理配置：所有 HTTP/HTTPS 请求默认走系统代理，若企业防火墙拦截 443 端口，需在 <font cms-style="font-L strong-Bold"><font cms-style="font-L strong-Bold color120">~/.openclaw/config.yaml</font></font> 中显式声明 http_proxy 与 https_proxy；</p><p cms-style="font-L strong-Bold">　　4、浏览器内核：仅支持 Chromium 内核浏览器（Chrome v100+、Edge v100+、Brave v1.50+），Firefox 与 Safari 不支持 WebDriver Manager 自动化注入。</p><p cms-style="font-L strong-Bold">　　五、文件系统与权限限制</p><p cms-style="font-L strong-Bold">　　跨系统路径访问与进程权限管理直接影响 OpenClaw 插件加载与任务持久化能力：</p><p cms-style="font-L strong-Bold">　　1、WSL2 用户不可直接访问 <font cms-style="font-L strong-Bold"><font cms-style="font-L strong-Bold color120">/c/Users/xxx/Downloads</font></font> 类路径，须通过 <font cms-style="font-L strong-Bold"><font cms-style="font-L strong-Bold color120">/mnt/c/Users/xxx/Downloads</font></font> 挂载方式引用；</p><p cms-style="font-L strong-Bold">　　2、Linux/macOS 用户需确保当前账户对 <font cms-style="font-L strong-Bold"><font cms-style="font-L strong-Bold color120">~/openclaw_plugins</font></font> 目录具有读写执行权限（chmod 755）；</p><p cms-style="font-L strong-Bold">　　3、Docker 部署时必须挂载 <font cms-style="font-L strong-Bold"><font cms-style="font-L strong-Bold color120">/dev/shm</font></font> 卷以避免 Chromium 渲染崩溃；</p><p cms-style="font-L strong-Bold">　　4、Termux 用户需执行 <font cms-style="font-L strong-Bold"><font cms-style="font-L strong-Bold color120">termux-setup-storage</font></font> 并授予权限，否则无法保存截图与上传附件；</p><p cms-style="font-L strong-Bold">　　5、云服务器部署禁止使用 root 用户直接运行 openclaw，必须创建专用非特权用户并配置 sudoers 白名单。</p> <div style="font-size: 0px; height: 0px; clear: both;"></div>