OpenClaw 一键安装：Windows/macOS/Linux 全平台教程

OpenClaw 2.7.8 支持 Windows、macOS、Linux 三大操作系统，全程可视化操作，无需命令行、无需手动配置环境，小白也能快速完成本地 AI 智能体部署。本文提供全平台统一安装流程与注意事项，帮助用户快速完成部署。

一、安装包信息

OpenClaw Windows 一键部署包大小约45.8MB下载地址：https://xiake.yun/api/download/package/17?promoCode=IV4E9B04A80C

二、安装前通用准备

1. 关闭安全软件Windows 需退出 360、电脑管家、火绒、Windows Defender 实时防护；macOS/Linux 关闭相关安全监控工具，避免文件被拦截。
2. 路径规范安装目录必须为纯英文、无中文、无空格、无特殊字符，推荐路径示例：D:\OpenClaw（Windows）、/Users/xxx/OpenClaw（macOS/Linux）。
3. 空间要求确保磁盘可用空间 ≥ 2.5GB，优先使用非系统盘。

三、Windows 安装步骤

1. 运行安装程序，点击开始使用。
2. 选择英文安装路径，勾选协议，点击开始安装。
3. 等待自动部署，程序自动安装依赖、配置环境。
4. 第一次启动等待 1–3 分钟，界面显示Gateway 在线即为成功。

四、macOS 安装步骤

1. 下载对应安装包，解压到英文路径。
2. 右键打开程序，绕过系统权限验证。
3. 按照界面指引完成自动部署。
4. 第一次启动加载完成后即可正常使用。

五、Linux 安装步骤

1. 解压安装包至用户目录下的英文路径。
2. 赋予程序运行权限，执行一键启动脚本。
3. 等待环境检测与依赖安装完成。
4. 启动后确认 Gateway 状态正常。

六、通用启动验证

启动成功判断标准：

• 界面右上角显示Gateway 在线
• 可进入聊天界面，支持模型切换与对话交互

七、常见问题

1. 启动失败检查安全软件是否关闭、路径是否含中文、磁盘空间是否充足。
2. 第一次启动加载慢属于正常现象，服务初始化需要时间，等待 1–3 分钟即可。
3. 环境依赖安装失败保持网络通畅，重新运行一键部署程序。

八、总结

OpenClaw 2.7.8 实现 Windows、macOS、Linux 全平台统一部署体验，可视化界面、自动配置环境、无需命令行，降低本地 AI 智能体使用门槛。按本文步骤操作，可快速完成跨系统安装与启动。

OpenClaw Windows 一键部署包大小约45.8MB下载地址：https://xiake.yun/api/download/package/17?promoCode=IV4E9B04A80C