OpenClaw 本地 AI 自动化代理双平台安装调试与故障处理指南适配系统Windows10/11 64 位、macOS 12 及以上 当前版本Windows v2.9.3 /macOS v2.7.9在尝试本地 AI 自动化工具的时候很多人都会被复杂的环境问题劝退各种组件版本冲突、依赖缺失调试起来耗费大量时间。OpenClaw 提供完整打包好的程序包全程图形界面操作不需要手动配置 Python、Node.js、Git 等组件普通使用者花费数分钟即可完成整套环境搭建快速体验 AI 操控本地设备的能力。⚠️部署前重要提醒减少各类报错概率解压压缩包、运行安装程序之前请务必关闭电脑上所有安全防护类软件包括 360 安全卫士、腾讯电脑管家、火绒安全同时关闭 Windows Defender 实时保护功能。软件具备文件读写、系统调用、模拟键鼠等自动化能力该类行为容易被安全防护程序判定为风险行为一旦核心程序文件被隔离或者删除就会直接导致安装失败。项目为开源项目有需要的可以前往 GitHub 查看源码进行安全核验。获取对应系统安装包Windows v2.9.3 版本下载链接https://xiake.yun/api/download/package/22?promoCodeIV4E9B04A80CmacOS v2.7.9 版本下载链接https://openclaw.ikidi.top/api/download/package/35?promoCodeIV4E9B04A80C解压文件以及安装路径选择推荐使用 7‑Zip、WinRAR 工具解压压缩包系统自带解压工具容易出现文件损坏、文件缺失的问题。右键压缩包选择解压到当前文件夹生成对应系统的程序文件夹。打开解压后的文件夹找到红色龙虾图标的启动文件双击运行。Windows 系统弹出 SmartScreen 安全拦截弹窗时点击「更多信息」选择「仍要运行」即可继续。进入欢迎页面点击开始使用跳转到安装路径选择界面。关键注意点 安装路径必须全部使用英文禁止中文、空格以及特殊符号。不建议安装至 C 盘避免占用系统盘存储空间。 ✅推荐路径D:\OpenClaw、E:\AITools\OpenClaw ❌错误路径D:\AI 工具 \OpenClaw勾选用户协议和免责声明点击开始安装进入全自动部署流程。自动部署过程无需手动干预点击开始安装后程序会自动完成全部环境适配工作整体耗时 3‑5 分钟电脑硬件配置会影响实际耗时。部署过程请勿关闭程序窗口强行关闭会直接中断部署进程造成安装异常。程序自动执行的工作内容检测本机运行环境自动补齐 Git、Node.js、Python 等缺失依赖根据操作系统适配部署 OpenClaw 全部核心文件安装浏览器控制工具、键鼠模拟组件支撑自动化任务执行生成设备专属配置文件完成初始化并创建桌面快捷方式当安装进度达到 100%程序会自动打开 OpenClaw 主界面。第一次启动验证服务运行状态安装完成后自动进入初始化页面页面提示「正在等待 Gateway 就绪...」。第一次启动需要初始化后台服务等待 1‑3 分钟属于正常现象后续启动软件仅需要数秒。界面右上角显示Gateway 在线就代表部署全部完成。 各个功能区域简单介绍右上角Gateway 运行状态、重启按钮、日志查看入口、Tokens 额度信息左侧面板本地会话、渠道切换栏可以新建对话、查看历史任务记录中间窗口对话交互区域支持切换多套 AI 模型代码片段自动高亮底部输入框输入自然语言任务Enter 发送指令ShiftEnter 换行支持切换运行模式下发自动化任务进行功能测试部署完成无需额外修改配置直接在输入框输入自然语言任务即可。软件会自动解析任务调用各类工具操控电脑完成操作。任务描述越详尽执行效果会更加稳定。可以复制下面示例指令用来测试将 D 盘下载文件夹内文件按照文件类型新建子文件夹完成分类打开记事本输入 “OpenClaw 部署成功”保存文件到桌面获取电脑各个磁盘剩余空间整理成文本展示出来常见问题与解决方案安装失败、启动程序没有任何反应确认所有安全防护软件已经关闭如果问题依旧删除旧解压文件夹重新解压安装包再次尝试安装。Gateway 一直处于离线状态检查安装路径确认不存在中文、空格、特殊符号点击右上角重启按钮重新启动 Gateway 后台服务完全关闭软件右键程序选择以管理员身份运行出现网络错误提示第一次启动需要网络完成初始化关闭代理以及 VPN保证网络通畅后重试。Tokens 额度不足提示内置额度可以满足大部分基础使用场景额度耗尽可以在软件内进行补充不会影响软件核心自动化能力。无法输入、发送指令等待 Gateway 状态变为在线之后再操作问题依旧建议重新安装程序。使用经验分享安装磁盘建议预留 5G 以上存储空间用于存放模型缓存以及后续技能扩展包。桌面快捷方式生成后后续直接双击图标启动不需要重复解压安装。如果想要通过飞书、微信等聊天软件下发任务部署完成后进入设置‑聊天渠道完成相关配置。版本升级直接下载新版本安装包覆盖原有文件夹不需要卸载旧版本。OpenClaw 采用一体化打包方案无广告弹窗不存在捆绑软件部署完成就可以体验 AI 本地自动化能力处理各类重复繁琐的办公工作。后续会持续更新技能拓展、本地大模型接入、多渠道联动相关实操教程。安装包下载地址Windows v2.9.3 版本https://xiake.yun/api/download/package/22?promoCodeIV4E9B04A80CmacOS v2.7.9 版本https://openclaw.ikidi.top/api/download/package/35?promoCodeIV4E9B04A80C