全网详细 OpenClaw 本地部署学习笔记

OpenClaw 一键安装包｜可视化部署，简化环境配置流程

✨适配系统：Windows10/11 64 位 当前版本：v2.7.5（虾壳云版）

✨核心优势：全程可视化操作，不用命令行、不用手动配置 Python/Node.js，内置全部运行依赖，5 分钟完成部署，新手也能轻松上手！

✨下载地址：https://xiake.yun/api/download/package/16?promoCode=IVA44F9E6173

🔴核心前置提醒（安装成功关键！）

安装 / 解压 / 运行前，务必彻底关闭所有杀毒软件（360 安全卫士 / 杀毒、腾讯电脑管家、火绒、Windows Defender 实时防护）！OpenClaw 因需操控系统、读写文件、模拟键鼠操作，易被杀毒软件误报为风险程序，拦截 / 删除核心文件会导致安装失败，关闭后操作即可放心使用（开源项目，可在 GitHub 验证安全性）。

📥第一步：访问下载页，获取一键安装包

打开安装包下载页面：https://xiake.yun/api/download/package/16?promoCode=IVA44F9E6173

点击页面「下载大龙虾一键安装部署」按钮，直接获取最新版安装包下载完成后，在浏览器下载文件夹 / 桌面找到压缩包（文件大小约 45.7MB，建议用浏览器自带下载 / 迅雷，避免中断）

📂第二步：解压并启动安装程序，选择安装路径

推荐用 WinRAR/7-Zip 解压（避免系统自带解压工具导致文件损坏），右键压缩包选择「解压到当前文件夹」，得到Openclaw-win文件夹打开解压后的文件夹，双击「Openclaw Windows 一键启动.exe」

（红色龙虾图标，易识别），若弹出 Windows SmartScreen 拦截，点击「更多信息」→「仍要运行」

即可启动后进入 OpenClaw 欢迎界面，点击底部红色「开始使用」，进入安装路径选择页面

✅安装路径要求

• 必选纯英文路径，不能包含中文、空格、特殊字符（如￥、&、・）
• 不建议安装在 C 盘（避免占用系统盘空间）
• 推荐路径：D:\OpenClaw/E:\AI\OpenClaw
• 错误路径：D:\软件\OpenClaw/D:\小龙虾

勾选「我已阅读并同意《用户协议》和《免责声明》」，点击「开始安装」

⏳第三步：等待自动安装，全程无需手动干预

点击开始安装后，程序将全自动完成所有部署步骤，不用任何操作，全程约 3-5 分钟（取决于电脑配置），请勿关闭安装窗口，否则会导致部署中断。

自动安装内容包含：

1. 检测电脑运行环境，自动补充缺失的 Git/Node.js/Python 等依赖
2. 部署 OpenClaw 核心项目文件，适配 Windows 系统
3. 安装浏览器控制工具、键鼠模拟工具，支持自动化操作
4. 生成系统专属.env 配置文件，完成注册与桌面快捷方式创建

安装进度达到 100% 后，程序将自动启动 OpenClaw 主程序

✅第四步：第一次启动，确认部署成功

安装完成后自动进入启动初始化界面，显示「正在等待 Gateway 就绪...」，第一次启动因初始化服务，需耐心等待 1-3 分钟（后续启动仅需数秒，属于正常现象）

当主界面右上角显示「Gateway 在线」，即代表部署成功！此时可看到界面包含核心功能区：

• 右上角：Gateway 状态、重启 / 日志按钮、剩余可用 Tokens（内置 28.00 万使用额度，可直接体验）
• 左侧：「本地」「渠道」切换栏，可创建新对话、查看历史记录
• 中间：对话窗口，默认助手 AI 智能体，支持多模型切换、代码高亮
• 底部：自然语言指令输入框（Enter 发送，Shift+Enter 换行），支持「自动 / 普通模式」切换

🚀第五步：开始使用，快速下达 AI 指令

部署成功后，不用额外配置，直接在底部输入框发送自然语言指令，OpenClaw 将自动拆解任务、调用工具、操控电脑完成操作，指令越具体，执行效果越精准！

📝新手快速测试指令（直接复制可用）

• 帮我整理 D 盘下载文件夹，按文件类型分类创建文件夹
• 打开记事本，输入 “OpenClaw 部署成功”，保存到桌面
• 查询当前电脑的磁盘可用空间，整理成文字告诉我

⚠️常见问题快速排查（启动 / 安装失败必看）

1. 安装失败 / 启动无响应：检查是否彻底关闭杀毒软件，若已关闭仍失败，重新解压安装包后再次尝试
2. Gateway 一直显示离线：①确认安装路径为纯英文，无中文 / 特殊字符；②点击右上角「重启」按钮，重新启动 Gateway 服务；③关闭程序后以管理员身份重新运行
3. 提示网络错误：第一次启动需要少量网络完成依赖初始化，确保电脑网络通畅，关闭代理 / VPN 后重试
4. Tokens 额度不足提示：内置 28 万使用额度可正常体验基础功能，后续可在界面点击「充值」补充，不影响核心操作
5. 界面无输入 / 无法发送指令：检查是否完成 Gateway 初始化，等待「Gateway 在线」后再操作，若仍异常，重新安装即可

💡温馨建议

• 建议将 OpenClaw 安装在磁盘空间≥5G 的盘符，预留足够空间用于后续技能扩展、模型缓存
• 桌面快捷方式创建成功后，后续可直接双击快捷方式启动，不用重新解压安装
• 若需对接飞书 / 微信等聊天渠道，部署成功后可在主界面「设置」→「聊天渠道」完成配置，实现聊天下达指令
• 后续如需更新版本，直接下载最新一键安装包，覆盖原有文件夹即可，不用卸载旧版本
• 下载安装包：https://xiake.yun/api/download/package/16?promoCode=IVA44F9E6173