OpenClaw 一键安装完整教程｜AI 聊天网关一键部署平台实操
适配系统：Windows10/11 64 位 | 当前版本：Openclaw Windows (虾壳云) v2.7.8 安装包大小：45.8MB 安装资源下载：OpenClaw Windows 一键部署包
工具亮点：全自动部署、不用手动配置运行环境、支持 OpenAI/Claude/Gemini 等多款大模型对接，配套技术服务支撑，简单操作即可完成 AI 网关搭建。
一、安装前期准备事项
安装程序、解压文件或是第一次启动 Gateway 前，务必全部退出电脑内安全防护软件，包含 360 安全卫士、腾讯电脑管家、火绒杀毒、Windows Defender 实时防护。 软件具备系统文件读写、服务注册能力，安全软件容易误拦截隔离程序文件，一旦核心文件被隔离，会出现安装失败、网关离线、软件显示在线但无法正常调用模型等问题。
二、分步安装操作
步骤 1：获取安装压缩包
打开上方下载链接获取安装资源，文件体积 45.8MB，推荐使用浏览器内置下载工具或迅雷下载，减少文件下载损坏、中断问题，文件默认保存至桌面或浏览器默认下载目录。
步骤 2：自定义安装目录，确认安装协议
解压安装包后，打开程序启动文件，进入安装页面自定义安装路径：
- 路径硬性规范：必须使用全英文目录，不允许出现中文、空格、特殊符号，不建议安装在 C 盘；
- 推荐路径：
D:\OpenClaw - 磁盘参考：D 盘剩余空间 191.1GB（总容量 238.5GB），软件部署所需空间约 2.5GB，优先选择剩余存储空间充裕的磁盘。
- 推荐路径：
- 勾选《用户协议》与《免责声明》，协议注明软件按现状提供，用户对接第三方 API 需要遵守对应服务商规则，使用风险由使用者自行承担，勾选完成后点击开始安装。
步骤 3：全自动等待部署进程
点击安装后全程自动化运行，安装过程禁止关闭程序窗口，关闭会直接终止部署流程。软件后台依次执行：
- 检测本机运行环境，自动校验并安装 Git、Node.js、pnpm、Python 等全部缺失依赖； 示例环境校验结果：Git 2.47.1.windows.2、Node.js v22.16.0、pnpm10.28.2、Python3.12.10
- 部署 OpenClaw 项目源码，通过 pnpm 批量拉取项目依赖包；
- 自动安装 browser-use 浏览器控制组件、键鼠自动化工具；
- 生成项目专属.env 配置文件，完成安装注册、自动生成桌面快捷方式。
整体部署耗时在 4 分钟左右，进度到达 100% 后软件自动跳转至主程序初始化界面。
三、第一次启动校验 Gateway 运行状态
安装结束自动弹出初始化页面，页面提示「正在等待 Gateway 就绪...」，第一次启动需要 1~3 分钟进行服务初始化预热，后续打开仅需数秒。 当软件右上角状态栏显示「Gateway 在线」，代表整套部署流程顺利完成。
软件界面分区说明
- 右上角：Gateway 运行状态、重启与日志查看按钮、可用 Tokens 余额（内置 28.00 万额度，额度耗尽可在界面充值）；
- 左侧：本地对话、多渠道配置切换栏，支持新建对话、查阅历史会话记录；
- 中间：AI 对话主窗口，v2.7.8 版本支持多款大模型自由切换、代码内容高亮展示；
- 底部：自然语言指令输入框，Enter 快捷键发送消息、Shift+Enter 实现换行，可切换自动 / 普通运行模式。
提示：部署完成后建议前往设置页面配置对应 API Key，保障 AI 模型正常调用。
四、常见安装 & 启动故障处理方案
- 安装失败：优先核查安全软件是否全部关闭，防护程序未彻底退出是安装失败高频诱因，关闭防护后重新解压安装包重试；
- Gateway 持续离线：检查安装路径是否含中文 / 特殊字符，修改为全英文路径后点击右上角重启网关，无效则右键软件选择管理员身份启动；
- 网络报错：第一次初始化网关需要联网加载资源，关闭本机代理、VPN 工具后重试；
- 无法发送对话指令：等待 Gateway 状态栏显示在线后再输入内容，长期异常建议完整重装软件；
- Tokens 额度不足：内置额度支撑基础使用，额度消耗完毕可在软件右上角充值入口补充。
五、使用优化小贴士
- 优先把软件安装在剩余空间≥5G 的磁盘分区，预留空间存放模型缓存与后续功能拓展文件；
- 桌面快捷方式生成完毕后，后续直接双击快捷方式启动，无需重复解压安装包；
- 需要对接飞书、微信等聊天渠道，可在软件「设置 - 聊天渠道」内完成配置；
- 版本迭代升级时，直接下载新版安装包覆盖原安装目录即可，不用卸载旧版本。
新版安装包下载地址：https://xiake.yun/api/download/package/17?promoCode=IV4E9B04A80C
