【新手入门】完整版 OpenClaw 配置教学 附常见故障解决办法（含安装包）
OpenClaw（小龙虾）本地安装与配置
龙虾开发者社区 OpenClaw 一键安装包｜可视化部署，简化环境配置流程
✨适配系统：Windows10/11 64 位 当前版本：v2.7.9（虾壳云版） ✨核心优势：全程可视化操作，不用命令行、不用手动配置 Python/Node.js，内置全部运行依赖，5 分钟完成部署，新手也能轻松上手！
✨下载地址：安卓版本 https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C 苹果系统版本 https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C
🔴核心前置提醒（安装成功关键！）
安装 / 解压 / 运行前，务必彻底关闭所有杀毒软件（360 安全卫士 / 杀毒、腾讯电脑管家、火绒、Windows Defender 实时防护）！OpenClaw 因需操控系统、读写文件、模拟键鼠操作，易被杀毒软件误报为风险程序，拦截 / 删除核心文件会导致安装失败，关闭后操作即可放心使用（开源项目，可在 GitHub 验证安全性）。
📥第一步：访问下载页，获取一键安装包
打开安装包下载页面：
安卓版本 https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C
苹果系统版本 https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C 点击页面「下载大龙虾一键安装部署」按钮，直接获取最新版安装包。下载完成后，在浏览器下载文件夹 / 桌面找到压缩包（文件大小约 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% 后，程序将自动启动 OpenClaw 主程序。
✅第四步：第一次启动，确认部署成功
安装完成后自动进入启动初始化界面，显示「正在等待 Gateway 就绪...」，第一次启动因初始化服务，需耐心等待 1-3 分钟（后续启动仅需数秒，属于正常现象）。
当主界面右上角显示「Gateway 在线」，即代表部署成功！此时可看到界面包含核心功能区：
- 右上角：Gateway 状态、重启 / 日志按钮、剩余可用 Tokens（内置 28.00 万使用额度，可直接体验）
- 左侧：「本地」「渠道」切换栏，可创建新对话、查看历史记录
- 中间：对话窗口，默认助手 AI 智能体，支持多模型切换、代码高亮
- 底部：自然语言指令输入框（Enter 发送，Shift+Enter 换行），支持「自动 / 普通模式」切换
🚀第五步：开始使用，快速下达 AI 指令
部署成功后，不用额外配置，直接在底部输入框发送自然语言指令，OpenClaw 将自动拆解任务、调用工具、操控电脑完成操作，指令越具体，执行效果越精准！
📝新手快速测试指令（直接复制可用）
- 帮我整理 D 盘下载文件夹，按文件类型分类创建文件夹
- 打开记事本，输入 “OpenClaw 部署成功”，保存到桌面
- 查询当前电脑的磁盘可用空间，整理成文字告诉我
⚠️常见问题快速排查（启动 / 安装失败必看）
- 安装失败 / 启动无响应：检查是否彻底关闭杀毒软件，若已关闭仍失败，重新解压安装包后再次尝试。
- Gateway 一直显示离线：①确认安装路径为纯英文，无中文 / 特殊字符；②点击右上角「重启」按钮，重新启动 Gateway 服务；③关闭程序后以管理员身份重新运行。
- 提示网络错误：第一次启动需要少量网络完成依赖初始化，确保电脑网络通畅，关闭代理 / VPN 后重试。
- Tokens 额度不足提示：内置 28 万使用额度可正常体验基础功能，后续可在界面点击「充值」补充，不影响核心操作。
- 界面无输入 / 无法发送指令：检查是否完成 Gateway 初始化，等待「Gateway 在线」后再操作，若仍异常，重新安装即可。
💡温馨建议
- 建议将 OpenClaw 安装在磁盘空间≥5G 的盘符，预留足够空间用于后续技能扩展、模型缓存。
- 桌面快捷方式创建成功后，后续可直接双击快捷方式启动，不用重新解压安装。
- 若需对接飞书 / 微信等聊天渠道，部署成功后可在主界面「设置」→「聊天渠道」完成配置，实现聊天下达指令。
- 后续如需更新版本，直接下载最新一键安装包，覆盖原有文件夹即可，不用卸载旧版本。
下载安装包：安卓版本 https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C 苹果系统版本 https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C