OpenClaw 本地 AI 智能体部署图形化安装与排坑完整手册适配系统Windows10/11 64 位、macOS12 Windows 版本v3.1.0虾壳云版 macOS 版本v2.7.9工具概述OpenClaw 属于可以操控本机电脑的 AI 智能体工具传统部署方式需要处理 Git、Python、Node.js 等一大堆组件对普通使用者门槛较高。而一键安装包把全部运行依赖内置打包整套操作全部可视化不用敲任何命令数分钟就可以完成整套环境搭建。各系统安装包下载地址Windows v3.1.0https://xiake.yun/api/download/package/28?promoCodeIV4E9B04A80CmacOS v2.7.9https://openclaw.ikidi.top/api/download/package/35?promoCodeIV4E9B04A80CWindows 端压缩包大小约 45.8MB建议使用浏览器自带下载或者迅雷避免下载中断导致文件损坏。部署前重要提醒在解压、运行安装程序之前务必关闭电脑上全部安全防护软件包括 360 安全卫士、腾讯电脑管家、火绒同时关闭 Windows Defender 实时防护模块。该工具具备文件读写、键鼠模拟、系统层面调度能力安全软件很容易将其判定为风险程序。一旦防护组件拦截、删除内部文件就会直接造成安装失败。项目为开源项目感兴趣的用户可以前往 GitHub 查阅源码进行核验关闭防护软件之后再执行后续流程。1、获取对应平台安装压缩包复制对应操作系统的下载链接获取压缩包下载完毕后在浏览器下载目录或者桌面找到该压缩文件。2、解压文件启动安装向导优先使用 WinRAR、7‑Zip 进行解压系统自带解压程序容易出现文件丢失损坏。右键压缩包选择解压到当前文件夹生成 Openclaw‑win 文件夹。进入解压后的目录双击Openclaw Windows 一键启动.exe红色龙虾图标方便识别。如果弹出 Windows SmartScreen 安全阻止弹窗点击更多信息 → 仍要运行即可继续。进入欢迎界面点击底部「开始使用」跳转至安装路径选择界面。⚠️重要约束安装路径必须全部为英文字符不能包含中文、空格、特殊符号。不建议放置在 C 盘防止占用系统盘存储空间。 ✅合理路径示例D:\OpenClaw、E:\AI\OpenClaw❌错误路径示例D:\工具集合\OpenClaw、D:\龙虾工具勾选同意《用户协议》以及《免责声明》点击「开始安装」。3、全自动后台部署无需人为干预点击开始安装之后全部部署工作交由程序自动执行使用者不需要做任何操作。整体耗时 3‑5 分钟实际耗时取决于电脑硬件配置。不要关闭安装窗口中断窗口会直接终止部署流程。程序自动完成的工作项扫描本机运行环境自动补齐 Git、Node.js、Python 等缺失依赖部署 OpenClaw 核心项目文件适配 Windows 运行环境部署浏览器驱动、键鼠模拟组件支撑自动化任务执行生成本机专属.env配置文件完成初始化同步生成桌面快捷方式进度条到达 100% 之后软件会自动拉起 OpenClaw 主程序。4、第一次启动确认 Gateway 服务状态安装结束自动跳转初始化页面页面提示「正在等待 Gateway 就绪...」。第一次启动需要完成服务初始化等待 1‑3 分钟属于正常现象后续再次启动仅需要数秒。页面右上角显示Gateway 在线代表整套部署已经完成。界面各板块说明右上角Gateway 运行状态、重启按钮、日志查看入口展示剩余 Tokens 额度内置 28.00 万 Tokens 额度可供体验各类功能左侧「本地」「渠道」切换栏可以新建对话查看历史会话记录中间对话交互窗口内置 AI 助手智能体支持多模型切换代码片段开启高亮展示底部指令输入区域Enter 发送消息ShiftEnter 实现换行支持自动、普通两种工作模式5、输入自然语言指令执行自动化任务部署完成无需额外配置直接在底部输入框输入自然语言描述OpenClaw 会解析任务逻辑调用工具能力操控电脑完成工作。指令描述越详实执行效果越稳定。新手测试指令直接复制即可使用帮我整理 D 盘下载文件夹按文件类型分类创建文件夹 打开记事本输入 “OpenClaw 部署成功”保存到桌面 查询当前电脑的磁盘可用空间整理成文字告诉我故障排查汇总安装失败、程序启动无响应确认全部安全防护软件已经关闭关闭后依旧异常把压缩包重新解压一遍再次运行安装流程。Gateway 持续离线核对安装路径确认不存在中文、空格以及特殊符号点击界面右上角重启按钮重新拉起 Gateway 服务完全关闭软件右键选择以管理员身份运行程序。网络报错提示第一次启动会消耗网络资源完成初始化工作请确认网络正常关闭代理、VPN 之后重试。Tokens 额度不足内置 28 万 Tokens 可以完成基础功能体验额度耗尽后可在软件界面完成充值不会影响软件本体核心能力。无法输入、消息发送无效等待 Gateway 状态切换为在线之后再进行操作问题依旧存在建议重新安装。使用小贴士安装磁盘建议预留大于等于 5G 空闲存储空间用于后续技能插件、模型缓存存放。桌面快捷方式生成成功后后续直接双击快捷方式启动不需要反复解压安装包。如果需要对接飞书、微信等聊天渠道部署完成后进入「设置」→「聊天渠道」完成配置就可以通过聊天窗口下发任务。版本升级直接下载新版本安装包覆盖原有文件夹不需要卸载旧版本。各系统安装包下载地址Windows v3.1.0https://xiake.yun/api/download/package/28?promoCodeIV4E9B04A80CmacOS v2.7.9https://openclaw.ikidi.top/api/download/package/35?promoCodeIV4E9B04A80C项目持续迭代更新后续会输出技能拓展、本地大模型接入、多渠道联动相关教程可以持续关注项目动态。
AI 桌面自动化 OpenClaw：部署初始化与故障处理全文档
OpenClaw 本地 AI 智能体部署图形化安装与排坑完整手册适配系统Windows10/11 64 位、macOS12 Windows 版本v3.1.0虾壳云版 macOS 版本v2.7.9工具概述OpenClaw 属于可以操控本机电脑的 AI 智能体工具传统部署方式需要处理 Git、Python、Node.js 等一大堆组件对普通使用者门槛较高。而一键安装包把全部运行依赖内置打包整套操作全部可视化不用敲任何命令数分钟就可以完成整套环境搭建。各系统安装包下载地址Windows v3.1.0https://xiake.yun/api/download/package/28?promoCodeIV4E9B04A80CmacOS v2.7.9https://openclaw.ikidi.top/api/download/package/35?promoCodeIV4E9B04A80CWindows 端压缩包大小约 45.8MB建议使用浏览器自带下载或者迅雷避免下载中断导致文件损坏。部署前重要提醒在解压、运行安装程序之前务必关闭电脑上全部安全防护软件包括 360 安全卫士、腾讯电脑管家、火绒同时关闭 Windows Defender 实时防护模块。该工具具备文件读写、键鼠模拟、系统层面调度能力安全软件很容易将其判定为风险程序。一旦防护组件拦截、删除内部文件就会直接造成安装失败。项目为开源项目感兴趣的用户可以前往 GitHub 查阅源码进行核验关闭防护软件之后再执行后续流程。1、获取对应平台安装压缩包复制对应操作系统的下载链接获取压缩包下载完毕后在浏览器下载目录或者桌面找到该压缩文件。2、解压文件启动安装向导优先使用 WinRAR、7‑Zip 进行解压系统自带解压程序容易出现文件丢失损坏。右键压缩包选择解压到当前文件夹生成 Openclaw‑win 文件夹。进入解压后的目录双击Openclaw Windows 一键启动.exe红色龙虾图标方便识别。如果弹出 Windows SmartScreen 安全阻止弹窗点击更多信息 → 仍要运行即可继续。进入欢迎界面点击底部「开始使用」跳转至安装路径选择界面。⚠️重要约束安装路径必须全部为英文字符不能包含中文、空格、特殊符号。不建议放置在 C 盘防止占用系统盘存储空间。 ✅合理路径示例D:\OpenClaw、E:\AI\OpenClaw❌错误路径示例D:\工具集合\OpenClaw、D:\龙虾工具勾选同意《用户协议》以及《免责声明》点击「开始安装」。3、全自动后台部署无需人为干预点击开始安装之后全部部署工作交由程序自动执行使用者不需要做任何操作。整体耗时 3‑5 分钟实际耗时取决于电脑硬件配置。不要关闭安装窗口中断窗口会直接终止部署流程。程序自动完成的工作项扫描本机运行环境自动补齐 Git、Node.js、Python 等缺失依赖部署 OpenClaw 核心项目文件适配 Windows 运行环境部署浏览器驱动、键鼠模拟组件支撑自动化任务执行生成本机专属.env配置文件完成初始化同步生成桌面快捷方式进度条到达 100% 之后软件会自动拉起 OpenClaw 主程序。4、第一次启动确认 Gateway 服务状态安装结束自动跳转初始化页面页面提示「正在等待 Gateway 就绪...」。第一次启动需要完成服务初始化等待 1‑3 分钟属于正常现象后续再次启动仅需要数秒。页面右上角显示Gateway 在线代表整套部署已经完成。界面各板块说明右上角Gateway 运行状态、重启按钮、日志查看入口展示剩余 Tokens 额度内置 28.00 万 Tokens 额度可供体验各类功能左侧「本地」「渠道」切换栏可以新建对话查看历史会话记录中间对话交互窗口内置 AI 助手智能体支持多模型切换代码片段开启高亮展示底部指令输入区域Enter 发送消息ShiftEnter 实现换行支持自动、普通两种工作模式5、输入自然语言指令执行自动化任务部署完成无需额外配置直接在底部输入框输入自然语言描述OpenClaw 会解析任务逻辑调用工具能力操控电脑完成工作。指令描述越详实执行效果越稳定。新手测试指令直接复制即可使用帮我整理 D 盘下载文件夹按文件类型分类创建文件夹 打开记事本输入 “OpenClaw 部署成功”保存到桌面 查询当前电脑的磁盘可用空间整理成文字告诉我故障排查汇总安装失败、程序启动无响应确认全部安全防护软件已经关闭关闭后依旧异常把压缩包重新解压一遍再次运行安装流程。Gateway 持续离线核对安装路径确认不存在中文、空格以及特殊符号点击界面右上角重启按钮重新拉起 Gateway 服务完全关闭软件右键选择以管理员身份运行程序。网络报错提示第一次启动会消耗网络资源完成初始化工作请确认网络正常关闭代理、VPN 之后重试。Tokens 额度不足内置 28 万 Tokens 可以完成基础功能体验额度耗尽后可在软件界面完成充值不会影响软件本体核心能力。无法输入、消息发送无效等待 Gateway 状态切换为在线之后再进行操作问题依旧存在建议重新安装。使用小贴士安装磁盘建议预留大于等于 5G 空闲存储空间用于后续技能插件、模型缓存存放。桌面快捷方式生成成功后后续直接双击快捷方式启动不需要反复解压安装包。如果需要对接飞书、微信等聊天渠道部署完成后进入「设置」→「聊天渠道」完成配置就可以通过聊天窗口下发任务。版本升级直接下载新版本安装包覆盖原有文件夹不需要卸载旧版本。各系统安装包下载地址Windows v3.1.0https://xiake.yun/api/download/package/28?promoCodeIV4E9B04A80CmacOS v2.7.9https://openclaw.ikidi.top/api/download/package/35?promoCodeIV4E9B04A80C项目持续迭代更新后续会输出技能拓展、本地大模型接入、多渠道联动相关教程可以持续关注项目动态。