openclaw部署需满足五类要求:一、硬件需2核cpu/4gb内存/20gb ssd(推荐i5/8gb/40gb nvme);二、系统需win10+/ubuntu20.04+/macos12+,node.js v22 lts,git与pnpm;三、网络需开放18789端口,带宽≥1mbps,配置有效api密钥;四、部署方式适配wsl2/docker compose v2/ubuntu24.04等;五、沙箱需挂载docker套接字,浏览器自动化需gpu加速,建议隔离环境运行。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您计划在本地或云端部署OpenClaw,但不确定设备是否满足运行条件,则可能是由于硬件规格、软件环境或网络配置未达基础门槛。以下是明确区分最低与推荐要求的配置说明:
一、硬件配置要求
OpenClaw对计算资源存在明确下限,低于该阈值将导致服务无法启动或响应严重延迟。CPU、内存与存储需协同满足最小可用性标准。
1、CPU:最低要求为2核x86架构处理器;推荐使用Intel i5/Ryzen 5及以上型号,以支撑多技能并发与模型加载。
2、内存:最低要求为4GB RAM;若运行7B及以上规模大模型或启用代理沙箱,推荐8GB或16GB以上。
3、存储空间:最低需20GB SSD可用空间(含系统、依赖、模型缓存);推荐40GB NVMe SSD或50GB SSD,尤其用于存放本地模型文件与日志。
二、软件与操作系统要求
OpenClaw依赖特定版本的运行时与工具链,版本不匹配将引发安装失败、模块缺失或运行时崩溃。
1、操作系统:支持Windows 10(2004+)、Windows 11(22H2+)、Ubuntu 20.04+、CentOS 8+、macOS 12+;其中Ubuntu 22.04 LTS 或 Windows 11 为官方推荐首选。
2、Node.js:最低版本为v18.0;必须使用v22 LTS(22.0.0 及以上),严禁使用v23或v24开发版(已知兼容性问题)。
3、其他工具:必须预装Git与pnpm(非npm);Windows用户须确保Git已正确加入PATH且SSH配置已切换为HTTPS方式。
三、网络与安全凭证要求
OpenClaw本身不内置大模型,需通过API密钥连接外部推理服务,因此网络连通性与凭证有效性是功能启用的前提。
1、网络端口:默认监听18789端口;本地部署需确保该端口未被占用;云服务器需在安全组中放行此端口。
此技能为 OpenClaw 安装并配置 Tablestore Mem0 插件。Tablestore Mem0使用阿里云表格存储作为向量存储后端。
2、带宽建议:基础聊天场景要求公网带宽≥1Mbps;若高频调用搜索、网页抓取等技能,建议≥5Mbps;本地模型直连场景可离线运行。
3、大模型API密钥:必须从支持OpenAI API协议的平台获取有效Key,包括但不限于阿里云百炼、Minimax、Claude(Anthropic)、Ollama(本地);密钥须填入.env文件中OPENCLAW_API_KEY字段。
四、部署方式适配要求
不同部署路径对底层环境提出差异化约束,选择错误路径将直接导致初始化失败。
1、原生Windows部署:需启用WSL2(仅Win10需手动开启);禁用Windows Defender实时防护(避免误杀openclaw.exe进程)。
2、Docker部署:需安装Docker Desktop(Win/macOS)或 Docker Engine(Linux);Docker Compose版本必须为v2;主机内存不得低于2GB(否则镜像构建将因OOM终止)。
3、WSL子系统部署:仅限Windows;必须使用Ubuntu 24.04 LTS或更新发行版;需额外安装build-essential、cmake、libsdl2-dev系列库以完成源码编译。
五、特殊场景补充要求
部分高级功能启用需额外满足隔离性、图形能力或权限策略,忽略将导致对应模块不可用。
1、代理沙箱(AgentSandbox):启用时需挂载主机Docker套接字,且容器内默认网络策略为network: none;若需外网访问,须显式配置DNS或hosts映射。
2、浏览器自动化工具:需基于openclaw-sandbox:bookworm-slim镜像构建专用浏览器沙箱,并启用GPU加速支持(仅Linux/WSL2环境可行)。
3、隐私与安全:强烈建议在虚拟机、云服务器或专用物理设备上运行;禁止在存有高敏感数据的主力生产机上直接部署。









