OpenClaw 一键安装部署教程｜可视化搭建桌面 AI 自动化智能体
适配系统：Windows10/11 64 位
当前版本：v2.7.8（虾壳云版）
核心优势：全程可视化操作，无需命令行、无需手动配置 Python/Node.js 运行环境，整合全套运行依赖，5 分钟即可完成部署，新手也能轻松完成搭建。
核心前置提醒（保障安装顺利的关键）
安装、解压、启动程序前，需要关闭全部安全防护软件，包含 360 安全卫士、腾讯电脑管家、火绒以及 Windows Defender 实时防护。OpenClaw 需要控制系统进程、读写本地文件、模拟键鼠动作，容易被安全软件误识别为风险项目，文件被拦截删除会直接造成安装失败，项目为开源项目，可前往 GitHub 核验源码安全性。
第一步：获取一键部署资源包
下载地址：OpenClaw Windows 一键部署包 v2.7.8
压缩包体积约 45.8MB，推荐使用系统自带浏览器或迅雷进行下载，降低下载中断概率。下载完成后在下载目录或桌面找到压缩资源。
第二步：解压资源并启动安装程序，自定义安装目录
优先选用 WinRAR 或 7-Zip 进行解压，系统自带解压工具容易出现文件损坏问题；右键压缩包选择解压至当前文件夹，生成Openclaw-win文件夹。
打开文件夹，双击带有红色龙虾图标的「Openclaw Windows 一键启动.exe」，若弹出 Windows SmartScreen 安全拦截弹窗，点击更多信息，选择仍要运行即可进入安装页面。
进入 OpenClaw 欢迎界面后点击「开始使用」跳转路径配置页，安装目录需要遵循规范：
- 路径必须为纯英文，不能包含中文、空格、￥&・等特殊符号；
- 不推荐安装至 C 盘，系统盘权限限制较多；
推荐路径：
D:\OpenClaw、E:\AI\OpenClaw错误路径示例：D:\软件\OpenClaw、D:\小龙虾
勾选用户协议与免责声明，点击开始安装。
第三步：全自动部署，无需人工操作
点击安装后程序自动执行整套部署流程，整体耗时 3~5 分钟，时长由设备硬件配置决定，安装阶段不要关闭软件窗口，避免部署终止。自动化执行内容如下：
- 扫描本机运行环境，自动补齐 Git、Node.js、Python 等缺失依赖组件；
- 部署 OpenClaw 核心资源文件，适配 Windows 系统环境；
- 装配浏览器控制、键鼠模拟相关工具，支撑自动化操作能力；
- 生成适配系统的.env 配置文件，完成系统注册并生成桌面快捷启动图标。 安装进度拉满至 100% 后，软件自动打开主程序。
第四步：第一次启动，核验部署成果
安装结束自动进入初始化页面，页面提示「正在等待 Gateway 就绪...」，第一次启动需要初始化后台服务，等待 1~3 分钟属于正常情况，后续再次启动仅需要短短数秒。
页面右上角显示「Gateway 在线」就代表部署顺利完成，软件各功能分区说明：
- 右上角：查看 Gateway 运行状态、重启服务、查看运行日志、查看剩余 Tokens 资源；
- 左侧：切换本地与渠道分类，新建对话、翻阅历史聊天记录；
- 中间对话区：默认 AI 助手，支持多模型切换、代码内容高亮展示；
- 底部输入框：自然语言指令输入，Enter 发送内容，Shift+Enter 换行，支持普通、自动两种运行模式。
第五步：下发指令，体验自动化能力
部署完毕后直接在输入框填写自然语言需求，软件自主拆分任务、调用各类工具操控电脑执行任务，描述越详尽，任务执行精度越高。
新手可用测试指令
- 帮我整理 D 盘下载文件夹，按文件类型分类创建文件夹
- 打开记事本，输入 “OpenClaw 部署成功”，保存到桌面
- 查询当前电脑的磁盘可用空间，整理成文字告诉我
常见问题快速排查
1. 安装失败 / 程序无响应
确认各类安全软件已经全部关闭，依旧异常则重新解压安装包重试。
2. Gateway 长期离线
①检查安装路径是否全英文，剔除中文与特殊字符；②点击右上角重启按钮重置服务；③关闭程序后右键选择管理员身份启动。
3. 启动提示网络异常
第一次初始化需要少量网络资源，保持设备网络连通，关闭代理与 VPN 后重试。
4. 无法输入、发送指令
等待 Gateway 完成初始化并显示在线状态后再使用输入框，故障持续则重新安装程序。
实用部署建议
- 优先选用剩余可用空间≥5G 的磁盘分区安装，预留空间用于后续功能拓展与模型缓存；
- 桌面快捷方式生成后，后续直接双击图标启动，不用重复解压安装；
- 需要对接微信、飞书等通讯软件，在软件设置 - 聊天渠道中完成配置即可实现在聊天界面下发任务；
- 版本更新时直接下载新版安装包覆盖原有文件夹，不用卸载旧版本。
