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