OpenClaw，您的智能未来伙伴，精心打造于现代科技的基石之上，专为追求高效与创新的您设计。跨越操作系统的界限，OpenClaw在macOS的最新力作与Linux的多样性之间游刃有余，无论是Intel的强劲心脏还是Apple的硅基革命，它都能无缝融合。对于windows爱好者，WSL2的引入让兼容性不再是难题，拥抱未来，从Windows 10的前沿版到Windows 11的每一个角落。不仅如此，Android用户也能通过Termux的智慧之门，体验AI的力量，尽管道路稍显曲折，但探索的乐趣无穷。云服务器上的稳定驻足，确保了业务的高效运行，Ubuntu与CentOS的云端之旅，更是技术精英的理想选择。然而，它不是无处不在的魔法，避开旧系统的限制，OpenClaw确保在每一步都稳健前行，引领您进入一个全新的自动化AI时代，共同探索智能生活的无限可能。
如果您希望部署 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;
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 白名单。
End
