1. 为什么小白在 Windows 上跑 OpenClaw 总卡在第一步OpenClaw 这个开源 AI 智能体圈内人管它叫「小龙虾」核心卖点是本地离线运行、无代码操作、能自动操控电脑完成文件整理、表格生成、浏览器批量操作这类重复劳动。它适合谁适合不想学编程、不想租服务器、只想在自己 Windows 电脑上跑一个「数字员工」的办公人群。但问题来了官方仓库给的是源码和命令行部署方式对没有运维经验的人来说光是 Python 环境、依赖冲突、Gateway 服务注册这几步就能劝退一大半。我自己第一次在 Windows 上折腾 OpenClaw 的时候卡在依赖构建阶段整整一个下午报错信息刷了一屏最后发现是某个组件版本和系统里的旧运行库打架。后来换成虾壳云的一键部署包整个流程压缩到十分钟以内全程可视化不用敲一行命令。这篇就聚焦 Windows 单机场景把 OpenClaw v2.7.9 的零服务器部署路径拆成可跟做的步骤包括安装包获取、解压规范、启动拦截处理、Gateway 在线验证以及跑通之后怎么用自然语言下指令。先说清楚一件事OpenClaw 不需要你有一台云服务器也不需要公网 IP它就是一个跑在你本机的桌面程序。虾壳云做的是把运行依赖、环境检测、服务注册这些脏活打包成一个 exe你双击、选路径、等几分钟完事。下面按实际操作顺序走每一步都给出具体动作和预期结果遇到弹窗别慌照着点就行。2. 虾壳云一键部署包获取与 Windows 环境前置检查2.1 安装包下载与文件校验OpenClaw Windows 一键部署包 v2.7.9 的文件大小约 45.8MB下载完成后是一个 zip 压缩包。下载的时候有个小坑尽量用浏览器自带下载工具或者迅雷别用某些会「优化」压缩包的下载器否则解压时可能报「文件损坏」。下载完先看一眼文件大小对不对45.8MB 左右是正常的如果只有几 MB说明没下完重新下。安装包获取入口在虾壳云的下载页Windows 版本对应的是 Openclaw-Windows-2.7.9.zip。下载完成后不要急着双击先确认压缩包完整。2.2 部署前必须关闭的安全防护这一步是小白最容易忽略、也最容易导致部署失败的环节。OpenClaw 的运行机制包含模拟键鼠动作、读写系统底层文件、自动操控浏览器这些行为在安全软件眼里就是「高危操作」会被直接拦截甚至隔离删除核心文件。部署前需要彻底关闭以下防护程序的后台进程防护软件关闭方式注意事项360 安全卫士右下角托盘右键退出确认后台进程也结束360 杀毒托盘右键退出防护单独进程需单独关腾讯电脑管家托盘右键退出关闭实时防护火绒安全软件托盘右键退出关闭文件实时监控Windows Defender设置→隐私和安全性→病毒和威胁防护→实时保护关闭部署完可重新开启注意关闭防护不是让你永久裸奔只是部署和首次启动期间需要。OpenClaw 是开源项目你可以去 GitHub 查看源码核验安全性部署完成后把 Defender 实时保护重新打开不影响已安装的程序运行。2.3 解压工具的选择与规范操作Windows 自带的解压工具在处理包含大量小文件的压缩包时容易出现组件丢失或文件损坏。推荐用 WinRAR 或 7-Zip。标准解压步骤定位到下载完成的Openclaw-Windows-2.7.9.zip右键文件选择【解压到当前文件夹】等待 1 到 2 分钟生成独立的Openclaw-win文件夹解压完成后打开Openclaw-win文件夹你应该能看到一个带红色龙虾标识的Openclaw Windows 一键启动.exe。如果没看到这个 exe说明解压不完整删掉文件夹重新解压。2.4 安装路径的硬性规范这是整个部署流程里最关键的配置项。安装存放路径必须是纯英文路径内不能出现中文、空格、特殊符号。路径格式不达标会直接造成部署失败而且报错信息往往不明确小白很难定位。推荐路径D:\OpenClawE:\AI\OpenClaw不推荐路径包含中文命名的文件夹比如D:\软件\OpenClawC 盘系统根目录比如C:\Program Files\OpenClaw权限问题多磁盘最低存储需求 1.6GB但部署依赖构建阶段会生成临时缓存文件建议预留 3GB 以上空间。3. 可复制配置启动安装与 Gateway 服务初始化3.1 处理 Windows 安全拦截弹窗双击Openclaw Windows 一键启动.exe后如果弹出「Windows 已保护你的电脑」提示这是 SmartScreen 的常规防护机制不是病毒报警。依次点击弹窗内【更多信息】-【仍要运行】即可正常跳转到软件安装界面。如果点了【仍要运行】之后程序没反应检查一下是不是安全软件还在后台运行把托盘里的防护程序全部退出后重试。3.2 安装路径配置与协议确认程序启动后自动弹出欢迎页面点击底部【开始使用】进入安装路径配置页面。在这里填入你准备好的纯英文路径比如D:\OpenClaw。然后勾选用户协议与免责声明点击【开始安装】。这一步的配置本质上是在生成 OpenClaw 的运行目录结构包括 Gateway 服务的注册信息、模型接入的配置文件、以及本地任务队列的存储路径。虽然虾壳云的一键包帮你省去了手动写配置的麻烦但了解它生成了什么对后面排障有帮助。OpenClaw 的核心配置文件在安装目录下的config文件夹里主要包含{ gateway: { host: 127.0.0.1, port: 18789, auto_start: true }, model: { provider: custom, base_url: https://taotoken.net/api, api_key: 你的API Key, model_id: claude-3-5-sonnet }, workspace: { path: D:\\OpenClaw\\workspace, max_file_size_mb: 50 } }这个 JSON 片段是 OpenClaw 接入模型服务时的标准结构。如果你后面要换模型或者调整 Gateway 端口改的就是这个文件。base_url填 TaoToken 的 API 地址https://taotoken.net/apiapi_key填你在控制台生成的 Keymodel_id填你要用的模型 ID。三件套配齐OpenClaw 才能把自然语言指令转成实际的电脑操作。3.3 自动部署进程的执行与等待点击安装按钮后全程无需人工干预等待 3 到 5 分钟。程序会自动完成以下流程环境检测检查系统版本、运行库、磁盘空间依赖组件安装部署 OpenClaw 运行所需的 Python 运行时和第三方库核心服务部署注册 Gateway 后台服务配置文件生成写入默认配置和模型接入模板桌面快捷方式创建部署运行期间切勿关闭程序窗口避免部署进程中断失效。如果进度条卡在某个阶段超过 5 分钟先别急着杀进程打开任务管理器看看 CPU 和磁盘占用如果还在活动就继续等。3.4 第一次启动与服务初始化安装全部结束后软件会自动启动。第一次加载 Gateway 后台服务需要完整初始化等待 1 到 3 分钟属于正常情况后续再次打开软件加载速度会大幅提升。界面右上角显示【Gateway 在线】标识即代表整套部署流程全部完成。如果显示【Gateway 离线】先检查安全软件是否已全部关闭然后点击界面上的重启 Gateway 服务按钮或者完全关闭软件后重新启动。4. 验证请求确认 OpenClaw 服务可用的具体检查动作4.1 Gateway 在线状态与端口监听检查部署完成后第一件事是确认 Gateway 服务真的在跑。打开浏览器访问http://127.0.0.1:18789/health如果返回类似下面的 JSON说明 Gateway 正常{ status: ok, version: 2.7.9, uptime_seconds: 128, gateway_port: 18789 }如果浏览器打不开这个地址说明 Gateway 没启动成功。回到 OpenClaw 主界面看右上角状态标识点重启服务。还不行的话检查安装目录下的logs文件夹看gateway.log里的报错信息。4.2 模型接入连通性测试Gateway 在线只代表本地服务跑起来了不代表模型接入通了。在 OpenClaw 主界面底部输入框里输入一句简单的测试指令你好请回复当前时间如果 OpenClaw 能正常返回结果说明模型接入配置正确。如果返回错误常见的是 401 未授权说明 API Key 填错了或者没填。这时候去检查config文件夹里的配置文件确认base_url、api_key、model_id三件套是否完整。TaoToken 的 API Key 在控制台的 API Keys 页面生成生成后复制到配置文件里。如果你还没生成 Key先去控制台创建一个。4.3 实操指令验证文件整理任务模型接入通了之后跑一个实际任务验证 OpenClaw 的自动化能力。在输入框里输入整理 D 盘下载文件夹内全部图片文件按照文件创建日期新建对应分类文件夹存放预期结果OpenClaw 会自动扫描D:\下载文件夹识别图片文件jpg、png、gif 等按创建日期创建2024-01-15这样的文件夹把图片移动进去。整个过程你可以在界面上看到执行日志。如果任务执行到一半停了看日志里的报错。常见的是路径权限问题或者目标文件夹不存在。OpenClaw 的工作目录默认在安装目录下的workspace文件夹确保这个文件夹有读写权限。4.4 常用指令参考与执行精度指令描述越详细自动化执行精准度越高。以下是我实测下来比较稳定的几类指令指令类型示例预期动作文件整理整理桌面所有 Word 文档按修改日期分类扫描桌面 .docx 文件创建日期文件夹并移动数据汇总打开浏览器检索 AI 行业资讯汇总生成 Excel 保存至桌面启动浏览器搜索抓取结果生成 xlsx内容提取遍历桌面所有 Word 文档提取核心文字生成汇总表格读取 docx提取文本写入表格清理任务清理电脑多余缓存垃圾文件分类整理桌面杂乱文件扫描临时目录删除缓存整理桌面提示涉及删除操作的指令建议先在测试文件夹里跑一遍确认 OpenClaw 的行为符合预期后再对真实数据执行。5. 本篇常见错排查401、local proxy failed、reading choices 报错对照5.1 401 未授权错误报错原文Error: 401 Unauthorized - invalid api key原因API Key 填错、过期、或者没填。OpenClaw 在调用模型服务时如果 Key 无效服务端会返回 401。解决打开config文件夹里的配置文件检查api_key字段。去 TaoToken 控制台重新生成一个 Key复制粘贴进去保存后重启 Gateway 服务。注意 Key 前后不要有空格。5.2 local proxy failed 错误报错原文Error: local proxy failed - connection refused原因Gateway 服务没启动或者端口被占用。OpenClaw 的本地代理依赖 Gateway 在 18789 端口监听如果这个端口被其他程序占了代理就连不上。解决打开命令提示符运行netstat -ano | findstr 18789看有没有其他进程占用这个端口。如果有要么关掉那个进程要么在配置文件里把 Gateway 端口改成别的比如 18790。改完重启服务。5.3 reading choices 报错报错原文Error: reading choices - unexpected end of JSON input原因模型服务返回的响应格式不对通常是base_url填错了。比如把https://taotoken.net/api写成了https://taotoken.net少了/api路径服务端返回的是网页而不是 JSONOpenClaw 解析失败。解决检查配置文件里的base_url确保是https://taotoken.net/api。改完保存重启 Gateway。5.4 OAuth 相关报错报错原文Error: OAuth token expired - please re-authenticate原因如果你用的是需要 OAuth 的模型服务token 过期了。OpenClaw 本身不处理 OAuth 流程它只负责调用 API。解决去模型服务商的控制台重新授权获取新的 token更新到配置文件里。如果你用的是 TaoToken 的 API Key 方式不会遇到这个问题因为 API Key 不需要 OAuth 刷新。5.5 Gateway 长期离线如果界面右上角一直显示【Gateway 离线】按以下顺序排查确认所有安全软件已关闭包括 Windows Defender 实时保护检查安装路径是否纯英文有没有中文或空格打开logs\gateway.log看最后的报错信息点击界面重启 Gateway 服务按钮完全关闭软件重新双击桌面快捷方式启动如果以上都不行删掉安装目录重新解压安装包换一个纯英文路径重新部署。部署前记得把安全软件全部退出。6. 从单机部署到长期编码OpenClaw 的模型接入与 Coding PlanOpenClaw 跑起来之后你会发现它的能力上限取决于背后接入的模型。默认配置里用的是通用对话模型处理文件整理、表格生成这类任务够用但如果你想让 OpenClaw 帮你写代码、做代码审查、或者跑更复杂的 Agent 任务就需要接入更强的模型。TaoToken 的 Coding Plan 就是为长期编码和 Agent 场景设计的。它提供稳定的 API 接入支持 Claude 系列模型适合 OpenClaw 这种需要频繁调用模型服务的桌面智能体。配置方式和前面 JSON 片段里写的一样把base_url指向https://taotoken.net/apiapi_key填 Coding Plan 对应的 Keymodel_id填你需要的模型 ID。如果你还没决定用哪个模型可以先去模型对话页面试试不同模型的效果确认哪个更适合你的任务类型。接入文档里有完整的配置示例和参数说明包括 Claude Code 的接入方式如果你后面想从 OpenClaw 扩展到 Claude Code 做开发配置逻辑是相通的。OpenClaw 的单机部署只是起点。跑通之后你可以把它当成一个本地自动化入口把重复性的电脑操作交给它自己专注在更需要判断力的事情上。安装包和 API Key 都准备好了剩下的就是动手试。