OpenClaw 装好之后右上角一直显示「Gateway 离线」或者 Gateway 终于在线了一输入指令却提示模型通道没有配置——这两个问题在群里经常被混在一起问。前者是本地后台服务没起来后者是模型请求缺凭据。先把前者按原文第七节 Q3 的顺序修关掉 360、火绒、Windows Defender 的实时防护确认安装路径是纯英文再重启 Gateway 服务或完全重启软件后者再去 TaoToken 取一把 Key填到 OpenClaw 的模型通道。TaoToken 的官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册后创建 API Key需要填 Base URL 的地方统一写 https://taotoken.net/api 末尾不要加 /v1。下面按「先修 Gateway再补模型通道」的顺序拆开讲每一步尽量给出能直接照抄的字段。1. Gateway 离线不是模型报错先分清 OpenClaw 的两层1.1 右上角「Gateway 在线」代表本地服务不代表模型通道可用OpenClaw 的界面状态栏其实是两个独立信号叠在一起。一个信号叫 Gateway它是装在你 Windows 本机上的后台服务负责接收界面指令、调度文件操作、模拟键鼠、跟浏览器打交道另一个信号是模型通道OpenClaw 要把自然语言拆成动作得先把你的指令发给大模型拿到返回后再执行。Gateway 离线表现是主界面发灰、按钮点不动、状态栏一直转圈或显示红色离线模型通道没配好表现是 Gateway 明明在线你输入「整理下载文件夹」之后它回一句缺少 API Key、401、模型不存在或者干脆卡在「思考中」。原文第七节 Q3 专门处理「Gateway 状态长期显示离线」给出的动作很具体确认全部防护软件已关闭、安装路径符合规范点击界面重启 Gateway 服务或者完全关闭软件后重新启动。这套动作只解决本地服务进程的问题不解决模型请求。很多人看到「离线」就去重装结果装了三遍还是离线也有人 Gateway 已经在线却继续按离线教程关杀毒模型通道依旧报错。先把两层分开后面的排查才不会来回绕。判断顺序建议这样先看状态栏是不是「Gateway 在线」。如果不在线直接跳到第 1.2 到 1.4 节按本地服务修。如果在线再输入一条只调用模型、不碰文件的短指令看报错内容。报错里带 401、404、model not found、API key就转到第 3 节配 TaoToken 的 Key。报错是 Gateway timeout、离线、服务未响应就回到本地服务继续查。这个分流动作能省掉大量无效重装。1.2 先按原文关防护360、火绒、Windows Defender 的顺序OpenClaw 被安全软件拦不是它做了什么见不得人的事而是它的工作方式太像风险程序模拟键鼠、读写系统文件、操作浏览器、生成临时进程这些行为在杀毒软件的规则里天然敏感。原文提醒关闭 360 安全卫士、360 杀毒、腾讯电脑管家、火绒安全软件以及 Windows Defender 实时防护。注意这里说的是实时防护不是让你永久卸载安全软件装完、跑通之后再按需恢复或者把 OpenClaw 的安装目录和 Gateway 进程加进白名单。操作顺序上建议先关任务栏里能看到的 360 和火绒再进 Windows 安全中心关「实时保护」。Windows Defender 有时会在你关闭第三方杀毒后自动接管所以别只关一个。关完之后不要立刻启动 OpenClaw先去任务管理器看有没有残留的 OpenClaw、Gateway、Node 相关进程有就结束掉再重新启动。安全软件拦截不一定弹窗它可能静默把 Gateway 的核心文件移进隔离区表现就是状态栏永远离线。如果安装包已经被隔离删除原文给出的做法是去隔离区恢复对应文件再重新解压部署。这一步不要跳过因为 zip 里少一个文件后面解压出来的文件夹就是不完整的Gateway 服务启动时找不到依赖照样离线。恢复之后重新用 WinRAR 或 7-Zip 解压不要覆盖旧目录换一个干净目录例如 D:\OpenClaw能减少旧缓存干扰。1.3 安装路径必须是纯英文D:\OpenClaw 和 E:\AI\OpenClaw原文把「安装存放路径必须为纯英文」标成硬性规范路径里不能出现中文、空格、特殊符号。原因不复杂Gateway 服务启动时会用系统路径拼命令行和临时文件中文目录在部分组件里会编码错乱空格会被当成参数分隔符特殊符号更麻烦。推荐路径就是 D:\OpenClaw、E:\AI\OpenClaw 这种短、纯英文、层级浅的目录。不推荐放在 C 盘系统根目录也不推荐放在「我的文档」「桌面」这类带中文的默认位置。如果你之前装在中文路径下最稳的排障方式不是改环境变量而是重新解压到纯英文目录然后重新走一遍安装向导。OpenClaw 的配置文件会记录安装路径手动改路径容易让 Gateway 找不到服务文件。重新安装前把旧目录里的个人配置备份一下尤其是你填过的模型通道信息没有备份就直接重填。磁盘空间原文给的最低要求是 1.6GB实际建议预留 3GB 以上因为依赖构建阶段会生成临时缓存。路径改完之后再点界面里的「重启 Gateway 服务」。如果软件没有这个按钮就完全退出 OpenClaw确认任务管理器里没有残留进程再重新打开。路径问题是 Gateway 离线的常见根因尤其是第一次安装就离线的情况优先查这一项。1.4 重启 Gateway 服务与完全重启软件的区别原文 Q3 给了两个动作点击界面重启 Gateway 服务或者完全关闭软件后重新启动。这两个动作力度不同。界面重启只重启后台服务进程适合你刚改过路径、刚关完杀毒、刚恢复隔离文件之后完全重启软件会把主进程、托盘、子进程全部清掉适合状态栏卡死、服务重启按钮没反应、或者你刚更新过运行依赖。完全重启的正确姿势是先点软件里的退出不是点右上角叉号如果托盘还有龙虾图标右键退出然后打开任务管理器找 OpenClaw、Gateway、Openclaw Windows 一键启动相关进程全部结束等十秒再双击桌面快捷方式。第一次启动 Gateway 需要初始化原文说等待 1 到 3 分钟属于正常后续会快很多。别在初始化阶段反复点重启那样反而会让服务注册表混乱。如果重启多次仍然离线回到第 1.2 和 1.3 节复查防护软件是否真的全关、路径是否真的纯英文、安装包是否完整。三件事都确认后再考虑换一个解压目录重新部署。Gateway 离线绝大多数不是模型问题先把本地服务修到「在线」再进入模型通道配置。2. 回到 Openclaw-Windows-2.7.9.zip解压和启动 .exe 的排障版2.1 解压工具别用系统自带WinRAR 或 7-Zip原文明确不建议用 Windows 自带的解压工具理由是容易出现组件丢失、文件损坏。这个提醒在排障时更重要如果你之前用系统自带解压Gateway 离线可能不是安全软件拦的而是压缩包解压不完整。标准做法是拿到 Openclaw-Windows-2.7.9.zip 之后右键选择 WinRAR 或 7-Zip 的「解压到当前文件夹」等待一到两分钟生成独立的 Openclaw-win 文件夹。不要直接在 zip 里双击运行也不要把 zip 放到中文目录再解压。解压完成后检查文件夹里是否有 Openclaw Windows 一键启动.exe以及配套的依赖目录。如果缺少文件重新下载安装包。下载时优先用浏览器自带下载工具或迅雷避免网络中断导致压缩包损坏。安装包大小原文写的是约 45.8MB如果你拿到的文件明显偏小先校验再解压别急着点安装。2.2 双击 Openclaw Windows 一键启动.exe 被拦截怎么办打开 Openclaw-win 文件夹找到带红色龙虾标识的 Openclaw Windows 一键启动.exe双击启动。如果弹出「Windows 已保护你的电脑」这是 SmartScreen 的常规拦截不是病毒报错。按原文操作点击「更多信息」再点「仍要运行」就能进入安装界面。注意这个弹窗和杀毒软件的隔离不是一回事SmartScreen 放行之后如果 360 或火绒还在后台仍可能拦截 Gateway 进程所以第 1.2 节的关防护要在双击之前完成。如果双击后没有任何反应先看任务管理器有没有进程一闪而过再检查安全软件的拦截记录。有些拦截不会弹窗只在日志里留一条。把 OpenClaw 安装目录加入信任区重新双击。仍然没反应就换一个纯英文目录重新解压排除路径和文件损坏。2.3 第一次初始化 1–3 分钟别把等待当死机安装向导走完之后软件会自动启动第一次加载 Gateway 后台服务需要完整初始化原文说等待 1 到 3 分钟属于正常。这个阶段界面可能白屏、转圈、按钮点不动不要强杀进程也不要连续双击图标。初始化完成后右上角会显示「Gateway 在线」这才代表部署流程走完。如果超过五分钟仍然离线再按第 1 节排查不要一直等。后续再次打开软件Gateway 加载会明显加快。如果你每次开机都要等很久可能是安全软件在启动时扫描安装目录把目录加入白名单能缓解。注意这里说的是本地服务初始化和模型通道无关Gateway 在线只说明 OpenClaw 能跑桌面自动化不代表它能调用大模型。3. Gateway 恢复后模型调用报错去 TaoToken 创建 Key 补上模型通道3.1 打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册并创建 YOUR_API_KEYGateway 在线之后你在 OpenClaw 里输入第一条指令可能会看到「未配置模型」「API Key missing」「401 Unauthorized」之类的提示。这不是 Gateway 坏了而是 OpenClaw 还没拿到调用大模型的凭据。打开 TaoToken 注册账号进入控制台创建 API Key。创建时给 Key 起一个能认出来的名字例如 openclaw-desktop方便后面在用量列表里对账。复制出来的 Key 先放到记事本不要带空格、引号、换行后面填进 OpenClaw 时原样粘贴。TaoToken 在这里的角色是统一 API 通道你不需要在 OpenClaw 里分别配置多家模型的官方 Key也不用为了切换模型改代码。Key 从官网创建填到 OpenClaw 的模型通道里Base URL 统一指向 https://taotoken.net/api 。注意这个地址末尾不要加 /v1也不要加斜杠很多 404 就是多写了路径导致的。Key 用占位符 YOUR_API_KEY 表示实际填你创建出来的那一串。3.2 OpenClaw 模型通道的三个字段Base URL、Key、模型 IDOpenClaw 的版本界面可能把模型配置叫「模型服务」「API 设置」「自定义供应商」或「模型通道」但核心字段通常只有三个Base URL、API Key、模型 ID。供应商类型如果让你选选「OpenAI 兼容」或「自定义」不要选需要官方登录的选项。Base URL 填 https://taotoken.net/api API Key 填 YOUR_API_KEY模型 ID 从模型广场复制完整字符串。模型 ID 不要自己拼也不要凭记忆写以 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 模型广场当时列表为准。如果你在 OpenClaw 里看到「添加供应商」按钮点进去新建一个自定义供应商名称随便写比如 TaoToken协议选 OpenAI 兼容。保存之后回到模型通道选中这个供应商再发测试指令。部分版本会把配置写进本地文件但排障阶段优先用界面改避免手改文件导致格式错误。界面里能保存成功说明字段格式基本正确。3.3 界面字段对照表和可复制填写建议下面这张表可以直接对照 OpenClaw 的模型设置页填写。不同版本的标签可能略有差异认准「地址」「密钥」「模型」这三个语义即可。设置项填入值说明供应商类型OpenAI 兼容 / 自定义不要选官方 OpenAI 登录Base URLhttps://taotoken.net/api末尾不要加 /v1API KeyYOUR_API_KEY从 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建模型 ID以模型广场为准复制完整 ID不要手写超时时间默认或 60 秒桌面自动化建议别设太短填完之后点保存然后回到主界面。如果保存时报字段错误优先检查 Base URL 是不是被自动补了 /v1或者 Key 里混入了空格。模型 ID 如果下拉框里没有就手动粘贴模型广场里的完整 ID。不要为了「看起来像」而编造带日期后缀的模型名模型广场没有的 ID 调用必然失败。4. 让 OpenClaw 跑一条最小指令验证模型通道4.1 先别跑文件整理用一句话测试模型通道保存后不要立刻让它整理 D 盘、遍历桌面 Word 或操作浏览器。先用一条只调用模型、不碰文件的短指令例如「只回复四个字通道正常」。这条指令不会触发键鼠模拟也不会读写文件能干净地验证 Key、Base URL、模型 ID 是否匹配。如果它正常返回说明模型请求通了如果报错错误信息更纯粹不会和文件权限、路径问题混在一起。测试时保持 Gateway 在线。如果 Gateway 在测试过程中掉线先回到第 1 节修本地服务再测模型。测试通过之后再逐步放开桌面自动化指令从简单的「在桌面新建一个 txt 文件」开始确认 OpenClaw 能调模型也能执行本地动作。这个顺序能把模型问题和执行问题分开。4.2 看返回和日志401、404、模型不存在分别怎么改401 通常表示 Key 不对复制时少了字符、多了空格、Key 被删除或禁用。回到 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 重新创建一个 Key覆盖 OpenClaw 里的旧值。404 通常是 Base URL 写错有人填成 https://taotoken.net/api/v1有人填成 https://taotoken.net 正确写法是 https://taotoken.net/api 。模型不存在表示模型 ID 不在当前通道支持列表里去模型广场复制当时可用的 ID。超时和连接失败要看 Gateway 状态。Gateway 离线时OpenClaw 可能先报模型超时实际根因是本地服务没起来。先确认状态栏在线再重试。如果返回 403 或提示额度去控制台看用量和套餐不要反复重试刷日志。错误信息里如果出现 HTML 页面而不是 JSON多半是 Base URL 指到了官网页面把地址改回 https://taotoken.net/api 即可。4.3 验证通过后再回去跑桌面自动化模型通道验证通过后再回到原文第六节的实操指令例如整理下载文件夹图片、打开浏览器检索资讯并汇总 Excel、遍历桌面 Word 提取内容、清理缓存和整理桌面。这些指令会真正调用键鼠和文件系统建议先拿一个测试文件夹试确认 OpenClaw 的分类逻辑符合预期再让它处理真实目录。桌面自动化一旦跑起来中途不要手动抢鼠标否则容易打断操作链。如果某条指令能调模型但执行到一半失败那通常是文件权限、路径不存在或安全软件拦截不是模型通道问题。把报错贴回 OpenClaw 对话让它解释可能原因涉及本地命令、SQL 或编译运行的仍然由你在本地执行再把结果贴回去不要让 AI 工具直接连生产环境去操作。5. 高频故障对照Gateway 离线、模型 401、404、超时5.1 Gateway 还是离线先关防护再查路径再重启服务。顺序不要反安全软件没关重启多少次都可能被再次拦截路径带中文重装多少次都可能起不来。完全退出软件后在任务管理器里结束残留进程再启动。如果安装包曾被隔离去隔离区恢复文件并重新解压到纯英文目录。第一次启动等 1 到 3 分钟超过五分钟再进入下一轮排查。仍然离线就换目录重新部署排除旧缓存和文件损坏。5.2 模型通道 401 / 404 / 超时401 回官网重新创建 Key注意复制完整。404 检查 Base URL 是否为 https://taotoken.net/api 不要加 /v1 或其它路径。模型不存在就去模型广场复制 ID不要自己拼。超时先看 Gateway 是否在线再看网络是否稳定最后看超时时间是否设得太短。403 或额度提示去控制台看用量。把这些错误分开处理比反复重装 OpenClaw 有效得多。5.3 杀毒软件二次拦截与路径复发有些安全软件在你重启电脑后会重新开启实时防护Gateway 再次被拦。把 OpenClaw 安装目录、Gateway 进程、启动 .exe 加入信任区或白名单比每次手动关防护更省事。路径方面不要为了「好找」把目录改成中文名也不要放到带空格的 Program Files 子目录。更新 OpenClaw 版本时先退出软件、关防护、解压到新的纯英文目录再迁移模型通道配置避免旧文件残留导致离线。6. 配通之后模型列表、用量和下一步入口6.1 去 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 看模型广场和用量OpenClaw 能正常返回之后建议回 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 看一眼模型广场和用量记录。模型广场用来确认你填的模型 ID 是否还在列表里切换模型时也从这里复制新 ID。用量记录用来核对 OpenClaw 的调用是否记上账如果刚才测试成功但用量里没有记录检查是不是填了别的 Key 或别的通道。控制台里还能管理 API Key删除测试用 Key换成正式 Key。6.2 文末 deep link模型对话、Coding Plan、创建 Key、Claude Code 文档配通 OpenClaw 的模型通道之后可以顺手做三件事。先用同一把 Key 打开 TaoToken 模型对话 发一条测试消息确认 Key 和模型 ID 在对话场景也正常如果打算长期让 OpenClaw 跑桌面自动化去 Coding Plan 看看套餐是否够用需要新建或更换 Key在 控制台 API Keys 操作。之后如果也想把 Claude Code 接到同一套通道环境变量对照看 Claude Code 接入文档 即可。OpenClaw 的 Gateway 离线按本地服务修模型通道按 Base URL 和 Key 补两件事分开做桌面自动化才能稳定跑起来。