1. 为什么 Windows 新手装 OpenClaw 总卡在第一步OpenClaw 这个开源 AI 智能体项目圈内人管它叫“小龙虾”核心能力是让 AI 直接操控你的电脑——整理文件、操作浏览器、批量处理表格、发消息相当于一个能动手的数字员工。它和普通对话 AI 最大的区别在于对话 AI 只给建议OpenClaw 直接执行。适合谁办公场景里被重复劳动困住的 Windows 用户不想学编程但想让电脑自己干活的人。但我在帮朋友装的过程中发现新手翻车基本集中在三个地方安全软件把核心文件当病毒删了、安装路径带了中文导致部署中断、Gateway 服务起不来一直显示离线。这三个问题占了报错的八成以上。这篇教程就按“环境准备→安装包获取→首次启动验证”的顺序把每一步拆开配上可复制的配置片段和逐条验证动作。你跟着做十分钟内能让小龙虾跑起来。先明确一个前提OpenClaw 需要读写系统文件、模拟鼠标键盘这类行为在安全软件眼里就是高风险操作。所以整个安装过程中杀毒软件必须彻底关闭不是“退出”而是“关闭所有防护”。这一点后面还会反复强调因为它是绝大多数失败的根源。另外OpenClaw 本身是开源项目代码在 GitHub 上可以查。安装包建议从官方渠道获取避免第三方修改版夹带东西。下面进入具体操作。2. TaoToken 前置准备给小龙虾接上大脑OpenClaw 本身是执行框架它需要一个大模型来理解你的指令。你可以把它理解成小龙虾是手和脚大模型是大脑。没有大脑它不知道你要干什么。所以安装 OpenClaw 之前先把模型接入的事情理清楚。TaoToken 在这里的角色是模型接入层。它提供统一的 API 入口兼容 OpenAI 风格的请求格式OpenClaw 配置里填上 Base URL 和 Key 就能用。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。你需要准备两样东西一个 API Key一个模型 ID。API Key 在控制台的 API Keys 页面创建路径是 https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。创建的时候给它起个名字比如“openclaw-win”方便后面管理。Key 只显示一次复制下来存好。模型 ID 选哪个如果你主要用 OpenClaw 做文件整理、浏览器操作这类任务选一个指令跟随能力强的模型就行。具体模型列表可以在模型对话页面查看https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。选好后把模型 ID 记下来格式类似claude-sonnet-4-20250514这种。如果你打算长期跑自动化任务比如每天定时整理文件、批量处理表格可以考虑 Coding Plan额度更充裕https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。短期测试的话按量付费就够。这里有个关键点OpenClaw 的配置文件里需要同时填 Base URL、API Key、Model ID 三样。少一样都连不上。Base URL 填https://taotoken.net/api注意末尾不加斜杠。Key 填你刚创建的那串。Model ID 填你选的模型标识。配置片段长这样后面安装完 OpenClaw 会用到{ llm: { provider: openai-compatible, base_url: https://taotoken.net/api, api_key: sk-你的Key, model: claude-sonnet-4-20250514 } }这段 JSON 先存着等 OpenClaw 装好之后填到它的设置里。如果你用的是 Claude Code 这类工具做辅助开发接入方式类似文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。3. 可复制配置Windows 安装 OpenClaw 的完整步骤这一节是核心操作每一步都给出具体动作和验证方法。我按顺序拆成五步你跟着做就行。3.1 环境准备与安全软件处理Windows 10/11 64 位系统都可以。先做三件事第一关闭所有安全防护软件。包括 360 安全卫士、360 杀毒、腾讯电脑管家、火绒、Windows Defender 的实时防护。注意不是退出界面而是彻底关闭防护功能。Windows Defender 的关闭路径设置→隐私和安全性→Windows 安全中心→病毒和威胁防护→管理设置→实时保护关掉。第二确认系统盘空间。OpenClaw 本体不大但运行过程中会产生缓存和日志建议 C 盘至少留 5GB 空间。安装路径不要选 C 盘后面会讲。第三准备解压工具。Windows 自带的解压功能对某些压缩包支持不好容易解压出损坏文件。用 7-Zip 或 WinRAR这两个都免费。3.2 获取安装包与解压安装包从官方渠道下载。下载完成后你会得到一个类似Openclaw-Windows-2.7.9.zip的文件。右键点击选择“解压到当前文件夹”或“解压到 Openclaw-Windows-2.7.9”。等 1 到 2 分钟会生成一个Openclaw-win文件夹。解压完成后先别急着启动。检查一下文件夹里有没有Openclaw Windows 一键启动.exe这个文件图标是红色龙虾。如果没有说明解压不完整重新解压。3.3 启动安装程序与路径设置双击Openclaw Windows 一键启动.exe。如果弹出“Windows 已保护你的电脑”提示点“更多信息”再点“仍要运行”。这是 SmartScreen 的常规拦截不代表文件有问题。进入欢迎界面后点“开始使用”。接下来是安装路径设置这一步极其关键路径必须纯英文不能有中文、空格、特殊符号。推荐D:\OpenClaw。错误示例D:\AI工具\OpenClaw、D:\小龙虾。路径不对会直接导致部署失败。勾选用户协议点“开始安装”。程序会自动执行检测运行环境、补齐依赖、部署核心文件、安装浏览器自动化组件、生成配置文件、创建桌面快捷方式。整个过程 3 到 5 分钟不要关闭窗口。3.4 配置模型接入安装完成后OpenClaw 会自动启动。第一次启动 Gateway 服务需要初始化加载 1 到 3 分钟是正常的。进入主界面后找到设置入口把第 2 节准备的 JSON 配置填进去。具体操作打开 OpenClaw 设置→模型配置→选择“OpenAI Compatible”作为提供商→Base URL 填https://taotoken.net/api→API Key 填你的 Key→Model ID 填你选的模型。保存后重启 Gateway 服务。如果你用的是 Codex 或类似工具配置文件通常在~/.codex/auth.json或项目根目录的config.toml里。OpenClaw 的配置路径一般在安装目录下的config/settings.json。用文本编辑器打开把上面的 JSON 片段合并进去。3.5 首次启动验证配置保存后看主界面右上角。显示“Gateway 在线”就说明服务正常。如果显示离线点重启按钮。还是离线的话检查安全软件是否真的关干净了以及安装路径是否纯英文。验证模型是否接通在底部输入框输入“你好请回复你的模型名称”。如果收到正常回复说明模型接入成功。如果报错看第 5 节的排查。4. 验证请求与成功结果确认小龙虾真的在干活配置填完不代表就能用得实际跑一个任务验证。这一步很多人跳过结果后面出问题不知道是配置错了还是任务本身有问题。先做基础连通性验证。在 OpenClaw 输入框里输入请列出当前桌面上所有文件的名称按类型分组正常情况它会调用文件系统工具读取桌面目录返回一个分组列表。如果它回复“我无法访问文件系统”或类似内容说明工具权限没开。去设置里检查“文件操作”权限是否启用。再做模型响应验证。输入请用一句话解释什么是 AI 智能体正常情况3 到 5 秒内返回一段通顺的解释。如果超过 30 秒没反应或者报reading choices错误说明模型接口有问题。检查 Base URL 是否填成了https://taotoken.net/api末尾不要加/v1或斜杠Key 是否复制完整。最后做自动化任务验证。输入在 D 盘新建一个文件夹叫 OpenClaw测试然后在里面创建一个文本文件写入“小龙虾运行正常”正常情况你打开 D 盘能看到OpenClaw测试文件夹里面有新建文本文档.txt内容正确。这个任务同时验证了文件创建、写入、路径解析三个能力。三个验证都通过说明 OpenClaw 已经正常工作。你可以开始试更复杂的任务比如“整理下载文件夹里的图片按日期分类”或“打开浏览器搜索今天的天气并保存到桌面”。如果某个验证失败对照下面的排查表处理。5. 本篇常见错排查401、local proxy failed、reading choices这一节列出实际安装中最常遇到的报错和解决方法。每个都给出具体错误信息和处理步骤。报错一401 Unauthorized现象OpenClaw 日志里出现401或invalid api key。原因API Key 填错、过期、或者复制时带了空格。解决去 TaoToken 控制台重新创建一个 Key复制时注意不要多选空格。填到 OpenClaw 配置里后重启 Gateway 服务。验证方法在模型对话页面发一条测试消息确认 Key 本身可用。报错二local proxy failed 或 connection refused现象OpenClaw 提示local proxy failed或ECONNREFUSED。原因Base URL 填错或者本地网络无法访问 API 地址。解决确认 Base URL 是https://taotoken.net/api不要加/v1不要加末尾斜杠。如果公司网络有防火墙限制换一个网络环境测试。注意这里不涉及任何代理工具只是确认网络能正常访问 HTTPS 地址。报错三reading choices 或 response format error现象模型返回了内容但 OpenClaw 解析失败报reading choices或unexpected response。原因模型返回格式和 OpenClaw 预期的不一致通常是 Model ID 填错了。解决确认 Model ID 和 TaoToken 模型列表里的一致。比如你选的是claude-sonnet-4-20250514就不要填成claude-sonnet-4。去模型对话页面核对准确的 ID 字符串。报错四OAuth 相关错误现象如果你用 Claude Code 或类似工具做辅助可能出现OAuth token expired或authentication failed。原因OAuth 凭证过期。解决重新走一遍授权流程或者改用 API Key 方式接入。OpenClaw 本身用 API Key 就够了不需要 OAuth。报错五Gateway 一直离线现象右上角始终显示“离线”重启也没用。原因安全软件拦截了 Gateway 进程或者端口被占用。解决彻底关闭所有安全软件包括后台进程重新解压安装包再启动。如果还不行检查 8080 或 3000 端口是否被其他程序占用在设置里换一个端口。报错六安装路径包含中文现象安装过程中提示“路径无效”或直接卡住。原因路径里有中文、空格、特殊符号。解决换成D:\OpenClaw这种纯英文路径重新安装。排查的时候记住一个原则先看日志。OpenClaw 的日志文件在安装目录的logs文件夹里打开最新的.log文件搜索error或fail能看到具体原因。比盲目重装快得多。6. 接入文档与后续操作OpenClaw 跑起来之后你可以做几件事让它更好用。第一把常用任务存成快捷指令。OpenClaw 支持保存任务模板比如“每日整理下载文件夹”“每周生成工作汇总表”下次直接调用不用重新描述。第二接入更多工具。OpenClaw 支持浏览器自动化、文件系统、命令行等工具集。你可以在设置里按需开启。如果要做复杂流程比如“打开网页→提取数据→写入表格→发送邮件”需要把多个工具串起来。第三模型切换。如果你发现某个模型在文件操作任务上表现不好可以换一个。TaoToken 的模型列表里有多款可选在模型对话页面可以对比效果。长期跑自动化任务的话Coding Plan 的额度更划算。接入文档和详细配置说明在这里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。API Key 管理在 https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。模型对话测试在 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。如果你在安装过程中遇到这篇没覆盖的报错先把日志里的错误信息复制出来对照第 5 节的格式排查。大部分问题集中在 Key、Base URL、路径、安全软件这四个点上。把这四个确认一遍基本都能解决。最后提醒一句OpenClaw 的自动化能力很强但给它下指令的时候尽量具体。比如“整理下载文件夹”不如“把下载文件夹里所有 .jpg 文件按修改日期移到对应月份文件夹”。指令越清晰执行越准。