1. 为什么零基础用户也需要一个本地 AI 智能体OpenClaw 是一个能在 Windows 上本地运行的桌面自动化智能体你可以把它理解成一个“听得懂人话的电脑操作员”你说“把下载文件夹里的图片按日期分好类”它就会自己打开资源管理器、建文件夹、移动文件。它和普通对话式 AI 最大的区别在于——它不只是聊天而是真的能动手操作你的电脑。适合谁适合每天被重复性文件整理、表格汇总、浏览器批量操作拖住的人尤其是完全不会编程的办公族。我试过在 Windows 11 上从零跑通整套流程实测下来只要路径和防护软件这两关处理对十分钟左右就能看到 Gateway 在线。这篇就按“下载安装包 → 环境准备 → 一键部署 → 启动验证 → 排障”的顺序把每一步拆到你能照着点。文中会给出可复制的配置片段和验证动作确保你不是装完就卡住而是能确认服务真的可用。需要先说明一点OpenClaw 这类工具会模拟键鼠、读写本地文件所以安全软件误报是常态不是病毒。你要做的是在部署阶段临时关闭实时防护装完再按需恢复。下面进入正题。2. 部署前的环境准备与虾壳云安装包获取2.1 系统要求与磁盘空间核对OpenClaw Windows 一键部署包 v2.7.9 面向 Windows 10/11 64 位系统文件大小约 45.8MB。解压后加上依赖组件磁盘最低需要预留 1.6GB但部署依赖构建阶段会生成临时缓存建议直接留 3GB 以上避免中途因空间不足失败。核对方式很简单打开“此电脑”看目标磁盘剩余空间。推荐放在 D 盘或 E 盘不要放 C 盘系统根目录。原因有两个一是 C 盘权限更严二是后续清理缓存时不容易误伤系统文件。2.2 关闭安全防护关键避坑解压、安装、启动之前需要彻底关闭所有安全防护程序包括 360 安全卫士、360 杀毒、腾讯电脑管家、火绒安全软件以及 Windows Defender 的实时防护。不是退出界面就行要在任务栏右下角确认后台进程也退出了。为什么必须这么做因为 OpenClaw 具备模拟键鼠动作、读写系统底层文件、自动操控浏览器的能力这些行为特征和风险程序高度重合安全软件会直接拦截隔离甚至删除核心运行文件导致部署中断。该项目是开源项目你可以去 GitHub 查看源码核验安全性关闭防护后再正常部署即可。Windows Defender 的关闭路径设置 → 隐私和安全性 → Windows 安全中心 → 病毒和威胁防护 → 管理设置 → 关闭“实时保护”。装完记得按需开回来。2.3 获取安装包并规范解压Windows 版本安装包通过虾壳云分发下载地址如下https://xiake.yun/api/download/package/18?promoCodeIVBE1F235167下载小贴士优先用浏览器自带下载工具或迅雷避免网络中断导致压缩包损坏。下载完成后确认是 zip 格式文件名类似Openclaw-Windows-2.7.9.zip。解压不要用 Windows 自带工具系统解压容易出现组件丢失、文件损坏。推荐 WinRAR 或 7-Zip。操作步骤右键压缩包 → 选择【解压到当前文件夹】→ 等待 1 到 2 分钟 → 生成独立的Openclaw-win文件夹。2.4 启动程序并处理系统拦截弹窗进入Openclaw-win文件夹找到带红色龙虾标识的Openclaw Windows 一键启动.exe双击运行。如果弹出“Windows 已保护你的电脑”这是系统常规防护机制依次点击【更多信息】→【仍要运行】即可进入安装界面。到这里环境准备就完成了。接下来是最核心的一键部署环节。3. 可复制的部署配置与安装路径规范3.1 安装路径的硬性规范这是整个流程里最容易翻车的一步。安装存放路径必须是纯英文路径内不能出现中文、空格、各类特殊符号否则会直接造成部署失败。推荐路径D:\OpenClaw E:\AI\OpenClaw不推荐路径包含中文命名的文件夹、C 盘系统根目录、带空格的路径如D:\My Tools\OpenClaw。如果你想把配置固化下来方便复用可以建一个deploy-config.json放在安装目录同级内容如下{ installPath: D:\\OpenClaw, gatewayPort: 18789, autoStart: true, logLevel: info, dataDir: D:\\OpenClaw\\data }注意 JSON 里反斜杠要写成双反斜杠这是转义要求。这个片段不是官方强制文件而是给你一个记录关键参数的模板方便排障时对照。3.2 全自动部署流程进入欢迎界面后点击底部【开始使用】跳转到安装路径配置页。选定纯英文目录勾选用户协议与免责声明点击【开始安装】。点击后全程无需人工干预等待 3 到 5 分钟程序会自动完成环境检测、依赖组件安装、核心服务部署、配置文件生成、桌面快捷方式创建。部署运行期间切勿关闭程序窗口否则进程中断会失效。3.3 第一次启动与服务初始化安装结束后软件自动启动。第一次加载 Gateway 后台服务需要完整初始化等待 1 到 3 分钟属于正常情况后续再打开会快很多。界面右上角显示【Gateway 在线】标识就代表整套部署完成。如果你后续要对接外部模型服务可以在配置里填入兼容 OpenAI 协议的 Base URL 和 Key。比如使用 TaoToken 的 API 地址Base URL: https://taotoken.net/api API Key: 你的密钥 Model ID: 按控制台可选模型填写这三件套要写全缺一个都会导致请求失败。获取 Key 的入口在控制台的 API Keys 页面接入文档里有完整的参数说明。4. 验证请求与成功结果确认4.1 用自然语言指令做首次验证部署成功后直接在软件主界面底部输入自然语言指令AI 会自动完成整套电脑操作。指令描述越详细执行精准度越高。常用验证指令参考整理 D 盘下载文件夹内全部图片文件按照文件创建日期新建对应分类文件夹存放 打开浏览器检索 AI 行业相关资讯汇总全部内容生成 Excel 表格保存至桌面 遍历桌面所有 Word 文档提取每份文档核心文字内容生成统一汇总表格 清理电脑多余缓存垃圾文件分类整理桌面杂乱文件建议第一次先用最简单的指令比如“在桌面新建一个名为 test 的文件夹”确认它能正常操作键鼠再上复杂任务。4.2 确认 Gateway 服务可用除了看界面右上角的【Gateway 在线】你还可以用命令行确认端口监听状态。打开 PowerShell输入netstat -ano | findstr 18789如果返回类似TCP 127.0.0.1:18789 LISTENING说明 Gateway 服务已经在本地端口正常监听。这一步能帮你区分“界面显示在线但实际没起来”的假象。4.3 验证模型请求是否通如果你配置了外部模型服务可以发一条测试指令观察返回。成功时你会看到 AI 正常理解并执行失败时常见的是 401 或连接超时。401 通常是 Key 填错或没填超时多半是 Base URL 写错或网络策略拦截。验证模型对话能力时可以直接在模型对话页面发一条“你好请回复当前时间”确认链路通畅。这一步和 OpenClaw 本地部署是两条线但经常一起用。5. 本篇常见错误排查对照5.1 安装包被杀毒软件隔离删除真实报错表现部署流程中途失败Openclaw-win文件夹里核心 exe 消失或提示“文件不存在”。解决彻底关闭所有安全软件后台进程重新解压完整安装包再次部署。若文件已被隔离前往杀毒软件隔离区恢复对应文件后重试。Windows Defender 要在“保护历史记录”里找到被隔离项并还原。5.2 路径错误导致无法安装真实报错表现系统弹出路径错误提示无法继续安装或安装到一半回滚。解决更换简短纯英文存放路径删除路径内所有中文、空格以及特殊符号。把D:\我的工具\OpenClaw改成D:\OpenClaw即可。5.3 Gateway 长期显示离线真实报错表现界面右上角一直显示【Gateway 离线】指令无响应。解决确认全部防护软件已关闭、安装路径符合规范点击界面重启 Gateway 服务或完全关闭软件后重新启动。如果重启无效检查 18789 端口是否被其他程序占用用前面的 netstat 命令排查。5.4 模型请求报 401 或 local proxy failed真实报错表现指令发出后返回 401 Unauthorized或提示 local proxy failed、reading choices 失败。解决401 是 Key 无效或未填去控制台重新生成 API Keylocal proxy failed 通常是 Base URL 写错确认填的是https://taotoken.net/api而不是带其他路径的地址reading choices 失败多半是返回体格式不匹配检查 Model ID 是否和控制台一致。这三件套——Base URL、Key、Model ID——必须同时正确。5.5 第一次启动加载缓慢真实报错表现软件打开后长时间白屏或转圈。解决属于后台服务初始化的正常现象等待 1 到 3 分钟即可不影响后续功能。如果超过 5 分钟仍无响应按 5.3 的方式重启 Gateway。6. 长期使用与能力扩展建议跑通本地部署只是第一步。如果你打算把 OpenClaw 当成日常数字员工长期用建议把模型接入这块也理顺。本地 Gateway 负责操作电脑模型负责理解指令两者配合才完整。对于需要长期编码、跑 Agent 任务的场景可以了解 Coding Plan它更适合高频调用和持续任务。日常验证模型是否可用直接在模型对话页面测试最直观。所有接入相关的 Key 管理和文档都在 API Keys 和接入文档里路径清晰照着填就行。最后给一个实用技巧把常用指令存成一个文本文件放在桌面需要时直接复制粘贴比每次重新组织语言快得多。指令越具体OpenClaw 执行越准比如“把 D:\Downloads 里所有 .jpg 按月份分文件夹”就比“整理图片”靠谱得多。装完之后先跑三条简单指令热身确认键鼠模拟和文件读写都正常再上批量任务这样出问题也容易定位。
小白也能轻松玩转OpenClaw：虾壳云一键部署，图文对照清晰安装步骤（附最新安装包）
1. 为什么零基础用户也需要一个本地 AI 智能体OpenClaw 是一个能在 Windows 上本地运行的桌面自动化智能体你可以把它理解成一个“听得懂人话的电脑操作员”你说“把下载文件夹里的图片按日期分好类”它就会自己打开资源管理器、建文件夹、移动文件。它和普通对话式 AI 最大的区别在于——它不只是聊天而是真的能动手操作你的电脑。适合谁适合每天被重复性文件整理、表格汇总、浏览器批量操作拖住的人尤其是完全不会编程的办公族。我试过在 Windows 11 上从零跑通整套流程实测下来只要路径和防护软件这两关处理对十分钟左右就能看到 Gateway 在线。这篇就按“下载安装包 → 环境准备 → 一键部署 → 启动验证 → 排障”的顺序把每一步拆到你能照着点。文中会给出可复制的配置片段和验证动作确保你不是装完就卡住而是能确认服务真的可用。需要先说明一点OpenClaw 这类工具会模拟键鼠、读写本地文件所以安全软件误报是常态不是病毒。你要做的是在部署阶段临时关闭实时防护装完再按需恢复。下面进入正题。2. 部署前的环境准备与虾壳云安装包获取2.1 系统要求与磁盘空间核对OpenClaw Windows 一键部署包 v2.7.9 面向 Windows 10/11 64 位系统文件大小约 45.8MB。解压后加上依赖组件磁盘最低需要预留 1.6GB但部署依赖构建阶段会生成临时缓存建议直接留 3GB 以上避免中途因空间不足失败。核对方式很简单打开“此电脑”看目标磁盘剩余空间。推荐放在 D 盘或 E 盘不要放 C 盘系统根目录。原因有两个一是 C 盘权限更严二是后续清理缓存时不容易误伤系统文件。2.2 关闭安全防护关键避坑解压、安装、启动之前需要彻底关闭所有安全防护程序包括 360 安全卫士、360 杀毒、腾讯电脑管家、火绒安全软件以及 Windows Defender 的实时防护。不是退出界面就行要在任务栏右下角确认后台进程也退出了。为什么必须这么做因为 OpenClaw 具备模拟键鼠动作、读写系统底层文件、自动操控浏览器的能力这些行为特征和风险程序高度重合安全软件会直接拦截隔离甚至删除核心运行文件导致部署中断。该项目是开源项目你可以去 GitHub 查看源码核验安全性关闭防护后再正常部署即可。Windows Defender 的关闭路径设置 → 隐私和安全性 → Windows 安全中心 → 病毒和威胁防护 → 管理设置 → 关闭“实时保护”。装完记得按需开回来。2.3 获取安装包并规范解压Windows 版本安装包通过虾壳云分发下载地址如下https://xiake.yun/api/download/package/18?promoCodeIVBE1F235167下载小贴士优先用浏览器自带下载工具或迅雷避免网络中断导致压缩包损坏。下载完成后确认是 zip 格式文件名类似Openclaw-Windows-2.7.9.zip。解压不要用 Windows 自带工具系统解压容易出现组件丢失、文件损坏。推荐 WinRAR 或 7-Zip。操作步骤右键压缩包 → 选择【解压到当前文件夹】→ 等待 1 到 2 分钟 → 生成独立的Openclaw-win文件夹。2.4 启动程序并处理系统拦截弹窗进入Openclaw-win文件夹找到带红色龙虾标识的Openclaw Windows 一键启动.exe双击运行。如果弹出“Windows 已保护你的电脑”这是系统常规防护机制依次点击【更多信息】→【仍要运行】即可进入安装界面。到这里环境准备就完成了。接下来是最核心的一键部署环节。3. 可复制的部署配置与安装路径规范3.1 安装路径的硬性规范这是整个流程里最容易翻车的一步。安装存放路径必须是纯英文路径内不能出现中文、空格、各类特殊符号否则会直接造成部署失败。推荐路径D:\OpenClaw E:\AI\OpenClaw不推荐路径包含中文命名的文件夹、C 盘系统根目录、带空格的路径如D:\My Tools\OpenClaw。如果你想把配置固化下来方便复用可以建一个deploy-config.json放在安装目录同级内容如下{ installPath: D:\\OpenClaw, gatewayPort: 18789, autoStart: true, logLevel: info, dataDir: D:\\OpenClaw\\data }注意 JSON 里反斜杠要写成双反斜杠这是转义要求。这个片段不是官方强制文件而是给你一个记录关键参数的模板方便排障时对照。3.2 全自动部署流程进入欢迎界面后点击底部【开始使用】跳转到安装路径配置页。选定纯英文目录勾选用户协议与免责声明点击【开始安装】。点击后全程无需人工干预等待 3 到 5 分钟程序会自动完成环境检测、依赖组件安装、核心服务部署、配置文件生成、桌面快捷方式创建。部署运行期间切勿关闭程序窗口否则进程中断会失效。3.3 第一次启动与服务初始化安装结束后软件自动启动。第一次加载 Gateway 后台服务需要完整初始化等待 1 到 3 分钟属于正常情况后续再打开会快很多。界面右上角显示【Gateway 在线】标识就代表整套部署完成。如果你后续要对接外部模型服务可以在配置里填入兼容 OpenAI 协议的 Base URL 和 Key。比如使用 TaoToken 的 API 地址Base URL: https://taotoken.net/api API Key: 你的密钥 Model ID: 按控制台可选模型填写这三件套要写全缺一个都会导致请求失败。获取 Key 的入口在控制台的 API Keys 页面接入文档里有完整的参数说明。4. 验证请求与成功结果确认4.1 用自然语言指令做首次验证部署成功后直接在软件主界面底部输入自然语言指令AI 会自动完成整套电脑操作。指令描述越详细执行精准度越高。常用验证指令参考整理 D 盘下载文件夹内全部图片文件按照文件创建日期新建对应分类文件夹存放 打开浏览器检索 AI 行业相关资讯汇总全部内容生成 Excel 表格保存至桌面 遍历桌面所有 Word 文档提取每份文档核心文字内容生成统一汇总表格 清理电脑多余缓存垃圾文件分类整理桌面杂乱文件建议第一次先用最简单的指令比如“在桌面新建一个名为 test 的文件夹”确认它能正常操作键鼠再上复杂任务。4.2 确认 Gateway 服务可用除了看界面右上角的【Gateway 在线】你还可以用命令行确认端口监听状态。打开 PowerShell输入netstat -ano | findstr 18789如果返回类似TCP 127.0.0.1:18789 LISTENING说明 Gateway 服务已经在本地端口正常监听。这一步能帮你区分“界面显示在线但实际没起来”的假象。4.3 验证模型请求是否通如果你配置了外部模型服务可以发一条测试指令观察返回。成功时你会看到 AI 正常理解并执行失败时常见的是 401 或连接超时。401 通常是 Key 填错或没填超时多半是 Base URL 写错或网络策略拦截。验证模型对话能力时可以直接在模型对话页面发一条“你好请回复当前时间”确认链路通畅。这一步和 OpenClaw 本地部署是两条线但经常一起用。5. 本篇常见错误排查对照5.1 安装包被杀毒软件隔离删除真实报错表现部署流程中途失败Openclaw-win文件夹里核心 exe 消失或提示“文件不存在”。解决彻底关闭所有安全软件后台进程重新解压完整安装包再次部署。若文件已被隔离前往杀毒软件隔离区恢复对应文件后重试。Windows Defender 要在“保护历史记录”里找到被隔离项并还原。5.2 路径错误导致无法安装真实报错表现系统弹出路径错误提示无法继续安装或安装到一半回滚。解决更换简短纯英文存放路径删除路径内所有中文、空格以及特殊符号。把D:\我的工具\OpenClaw改成D:\OpenClaw即可。5.3 Gateway 长期显示离线真实报错表现界面右上角一直显示【Gateway 离线】指令无响应。解决确认全部防护软件已关闭、安装路径符合规范点击界面重启 Gateway 服务或完全关闭软件后重新启动。如果重启无效检查 18789 端口是否被其他程序占用用前面的 netstat 命令排查。5.4 模型请求报 401 或 local proxy failed真实报错表现指令发出后返回 401 Unauthorized或提示 local proxy failed、reading choices 失败。解决401 是 Key 无效或未填去控制台重新生成 API Keylocal proxy failed 通常是 Base URL 写错确认填的是https://taotoken.net/api而不是带其他路径的地址reading choices 失败多半是返回体格式不匹配检查 Model ID 是否和控制台一致。这三件套——Base URL、Key、Model ID——必须同时正确。5.5 第一次启动加载缓慢真实报错表现软件打开后长时间白屏或转圈。解决属于后台服务初始化的正常现象等待 1 到 3 分钟即可不影响后续功能。如果超过 5 分钟仍无响应按 5.3 的方式重启 Gateway。6. 长期使用与能力扩展建议跑通本地部署只是第一步。如果你打算把 OpenClaw 当成日常数字员工长期用建议把模型接入这块也理顺。本地 Gateway 负责操作电脑模型负责理解指令两者配合才完整。对于需要长期编码、跑 Agent 任务的场景可以了解 Coding Plan它更适合高频调用和持续任务。日常验证模型是否可用直接在模型对话页面测试最直观。所有接入相关的 Key 管理和文档都在 API Keys 和接入文档里路径清晰照着填就行。最后给一个实用技巧把常用指令存成一个文本文件放在桌面需要时直接复制粘贴比每次重新组织语言快得多。指令越具体OpenClaw 执行越准比如“把 D:\Downloads 里所有 .jpg 按月份分文件夹”就比“整理图片”靠谱得多。装完之后先跑三条简单指令热身确认键鼠模拟和文件读写都正常再上批量任务这样出问题也容易定位。