刚把 OpenClaw v2.7.9 按入门攻略装完右键启动界面是出来了但右上角一直显示 Gateway 离线。你发一句「整理 D 盘图片」输入框像没听见再发「提取网页数据生成 Excel」还是没反应。很多人翻到原文 Q3照着关杀毒、重启软件、卸载重装走一遍Gateway 依旧灰着。这里被漏掉的一环通常是模型渠道OpenClaw 的 Gateway 要连上模型服务才能算在线而各家 Key 的格式、Base URL、模型名不一致时它就会卡在认证这一步。先去 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册并创建一把 TaoToken Key再回 OpenClaw 左侧「渠道」页把模型服务商的 Base URL 填成 https://taotoken.net/api粘贴刚创建的 Key保存后点右上角重启 Gateway离线提示才有机会消失。下面按排障顺序从「为什么只关杀毒没用」讲到「怎么确认 Tokens 真的在消耗」。1. OpenClaw v2.7.9 右上角 Gateway 离线时先别急着重装1.1 离线状态下 OpenClaw 卡在模型认证不是界面崩溃OpenClaw 的界面能打开左侧菜单能点渠道页能保存这已经说明主程序没有崩。右上角那个 Gateway 更像一个本地通信层它替 OpenClaw 去和模型服务说话把指令送出去再把回复拿回来。启动时它会读渠道配置拿到 Base URL、API Key、模型 ID然后向模型服务发一个轻量请求。如果这个请求没有正常返回Gateway 就不会标记为在线哪怕本机进程还活着。所以「Gateway 离线」不等于「OpenClaw 没装好」。它可能只是模型通道没通。你发指令没反应是因为 OpenClaw 根本没拿到模型回复而不是它不会执行「整理 D 盘图片」或「提取网页数据生成 Excel」。排障时先分清这两层能省掉很多次无意义的卸载重装。1.2 原文 Q3 关杀毒、重启、重装为什么没碰到根因原文 Q3 给的处理方式偏系统层杀毒软件可能拦截本地进程重启能解决临时端口占用重装能修复文件损坏。这些动作在特定情况下有效但它们不会修改「渠道」页里的模型服务配置。如果根因是 Key 过期、Base URL 填了别家地址、模型名带了不存在的日期后缀那么你重装十次配置还是旧的Gateway 还是会离线。更常见的情况是你之前配过另一家模型服务Key 已经失效但 OpenClaw 默认还在走那个旧渠道。界面看起来正常日志里却在报 401。原文 Q3 没让你检查模型渠道所以照着做只会把系统层折腾一遍真正该改的 Base URL 和 Key 还在原地。1.3 用一张表判断渠道没通还是 Gateway 没起可以先做一个快速判断。现象不一样优先检查的方向也不一样。现象优先检查原因OpenClaw 界面能开渠道页能保存右上角 Gateway 离线渠道页的 Base URL、Key、模型 IDGateway 已启动但模型认证没通过OpenClaw 双击没反应任务管理器里没有进程杀毒拦截、安装文件、系统权限主程序还没起来轮不到模型渠道Gateway 偶尔在线发指令后马上掉线模型 ID、账号余额、请求超时首次握手成功实际调用失败渠道页保存报错或保存后配置丢失配置文件权限、安装目录写入权限配置没落盘Gateway 读不到新渠道如果你落在第一行下面就不用再纠结杀毒和重装直接去准备一把能统一认证的 Key。2. 去 TaoToken 创建 Key再回 OpenClaw 渠道页2.1 模型广场先确认模型 ID别自己拼日期后缀打开 TaoToken 注册后先别急着复制 Key。先去模型广场看一眼当前可用的模型 ID。OpenClaw 渠道页里要填的模型 ID必须和模型广场当时列表一致。不要自己凭记忆写一个带日期后缀的名字也不要拿别的平台看到的模型名直接套过来。模型 ID 填错时Gateway 可能先显示在线等你一发送指令就报模型不存在然后右上角又变回离线。这种「闪一下在线」最容易被误判成网络问题。模型 ID 以 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 模型广场为准复制完整字符串不要手动改大小写。2.2 控制台创建 API Key文章里只写 YOUR_API_KEY在控制台创建 API Key 后先把它放进密码管理器或本地临时文件。本文所有示例都用YOUR_API_KEY占位你真正填进 OpenClaw 时换成自己刚创建的那把。不要把真实 Key 贴到截图、群聊、公开 issue 或录屏里。Key 从 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建创建后如果怀疑泄露直接删掉重建。OpenClaw 渠道页通常只需要一条 Key。粘贴时注意前后不要带空格也不要手动加Bearer前缀。很多工具会在内部自动拼Authorization: Bearer你再加一次就变成双 Bearer认证直接失败。2.3 各家 Key 格式不一致时OpenClaw 为什么直接离线不同模型服务商的鉴权头、路径、模型名格式不一样。有的走Authorization: Bearer有的走x-api-key有的 Base URL 要带/v1有的不要有的模型名带日期有的不带。OpenClaw 的渠道页如果选错供应商模板它就会按错误格式发请求。请求被拒Gateway 收不到有效响应右上角就离线。TaoToken 在这里做的是统一 API / 兼容通道把认证收口成一种格式你填 Base URL https://taotoken.net/api再贴一把 KeyOpenClaw 不用为每家服务商写不同适配。换模型时也只需要改模型 ID不用重新研究鉴权头。3. OpenClaw v2.7.9 渠道页的 Base URL 到底填什么3.1 渠道页字段对照Base URL https://taotoken.net/api回到 OpenClaw v2.7.9左侧点「渠道」页新增或编辑模型服务商。不同小版本界面文字可能略有差异但核心字段就这几个字段填写内容供应商类型OpenAI 兼容 / 自定义以渠道页实际选项为准Base URLhttps://taotoken.net/apiAPI KeyYOUR_API_KEY模型 ID以 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 模型广场为准默认渠道设为你刚保存的 TaoToken 渠道注意Base URL 末尾不要加/v1。官网落地页https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end是给人注册、创建 Key、看模型广场用的不要填进 Base URL。填进 OpenClaw 的接口地址只有https://taotoken.net/api。3.2 保存后重启 Gateway 的顺序比反复点重启重要正确顺序是先保存渠道确认界面没有报错再点右上角重启 Gateway等图标从灰变绿或显示在线最后才发测试指令。很多人反过来先发指令看到没反应再去点重启然后以为重启没用。其实 Gateway 启动时读的是旧配置你后改的渠道还没被加载。如果渠道页有「测试连接」按钮可以先点一下。测试通过再重启 Gateway。测试不通过就回看 Key、Base URL、模型 ID 三栏不要急着去杀毒软件里加白名单。3.3 多个模型服务商并存时默认渠道别选错渠道页里可能躺着好几个供应商之前试过的、朋友给的、别的项目留下的。OpenClaw 可能按默认渠道或排序第一个来走。你把 TaoToken 配好了但默认渠道还是旧的那个Gateway 照样离线。处理办法很简单把旧渠道禁用或删除如果不想删就把刚保存的 TaoToken 渠道设为默认并确认当前活跃渠道是它。保存后如果日志里出现旧服务商的域名或旧 Key 的报错就说明请求根本没走新渠道。回渠道页检查默认项比反复重启有效。4. 验证 Gateway 在线从「整理 D 盘图片」开始4.1 先让它生成清单和脚本不要直接动文件Gateway 显示在线后先发一个低风险指令比如「整理 D 盘图片」。更稳妥的做法是让它先生成文件清单、分类规则和可执行的脚本你在本地确认后再运行。不要一上来就让它直接移动或删除你的文件。AI 编程工具可以生成、解释、对照代码也可以帮你写脚本但真正执行本地文件操作时最好由你确认每一步。如果 OpenClaw 能把分类步骤列出来说明模型通道已经通了Gateway 不是假在线。接下来再试多步任务。4.2 右上角剩余 Tokens 有没有随调用变化发一条测试消息后看 OpenClaw 右上角剩余 Tokens 是否变化。如果一直不变可能请求没走 TaoToken 通道或者本地缓存了旧结果。打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 控制台看用量和请求日志里有没有这次调用。有记录说明通道通了没记录回渠道页确认默认供应商和 Base URL。这个动作能区分「Gateway 在线」和「模型真的被调用」。有些配置错误会让 Gateway 显示在线但一调用就失败Tokens 自然不动。4.3 多步任务「提取网页数据生成 Excel」怎么观察日志「提取网页数据生成 Excel」通常会触发多次模型调用第一次理解任务第二次生成解析逻辑第三次整理输出格式。你可以在 OpenClaw 日志里观察是否出现多次 request右上角 Tokens 是否逐步下降。如果第一次成功、第二次报错可能是模型 ID 不支持长上下文或者中间结果太长。遇到这种情况让 OpenClaw 把中间结果先输出成文本由你检查后再继续。不要让它直接连接生产库或生产机器执行操作。生成 SQL、解释报错、对照代码都可以执行诊断 SQL 或编译运行请在你本地完成再把结果贴回对话。5. 渠道填完仍离线OpenClaw v2.7.9 排查清单5.1 401、403、模型不存在分别回看哪一栏401 多半是 Key 问题Key 复制少了、多了空格、过期、被删除或者渠道页里重复加了Bearer。403 可能是 Key 权限不足或者模型未开通。模型不存在通常是模型 ID 写错回模型广场复制完整 ID。把报错原文和渠道页字段对照一遍比重装快得多。5.2 Base URL 多了 /v1、少了 /api、填了官网会怎样Base URL 是这一节最容易填错的地方。正确和错误对照如下正确https://taotoken.net/api 错误https://taotoken.net/api/v1 错误https://taotoken.net 错误https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end多写/v1时工具可能再拼一次/v1变成/api/v1/v1。少了/api请求打到官网页面上当然没有模型响应。把官网落地页填进 Base URL同样不会得到接口返回。记住注册、创建 Key、看模型广场用官网填进 OpenClaw 的 Base URL 只用https://taotoken.net/api。5.3 杀毒、端口、Gateway 进程与原文 Q3 的分工如果渠道配置确认无误还是离线再回到原文 Q3 那套系统层检查杀毒软件是否拦截了 OpenClaw 进程防火墙是否阻止本地端口Gateway 进程是否真的在运行。顺序建议是先查渠道再看系统层。否则你关了杀毒、重装了三次渠道里还是旧 Key问题依旧。5.4 日志里找 request、response、status 三行OpenClaw 的日志窗口或日志文件里重点找三行有没有发出 requestrequest 的地址是不是https://taotoken.net/apiresponse 的 status 是多少。如果 request 地址是旧服务商说明默认渠道没切如果 status 是 401回 Key如果是 404回模型 ID。把这些行贴到模型对话里解释可以但记得先把真实 Key 打码。6. 固定 OpenClaw 渠道配置别让 Gateway 再次离线6.1 把 Key、模型 ID、默认渠道记在配置清单里配通之后把渠道页里的关键字段记到自己的配置清单Base URL 是https://taotoken.net/apiKey 用YOUR_API_KEY占位模型 ID 以模型广场为准默认渠道选 TaoToken。下次 OpenClaw 升级或换机器直接照这张清单填不用重新猜。TaoToken 在这里的价值是统一通道你不需要为每个模型服务商记不同的鉴权格式。换模型时只改模型 IDKey 泄露时只换 Key。Base URL 始终是https://taotoken.net/api。6.2 去控制台对一次调用确认 Tokens 真的扣了再发一条测试消息然后打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 控制台看这次调用的用量记录。如果 OpenClaw 显示在线、控制台也有记录说明整条链路通了。如果控制台没记录但 OpenClaw 有回复可能走了本地缓存或别的渠道回渠道页再确认默认项。6.3 下一步模型对话、Coding Plan、创建 Key渠道页保存后别停在 OpenClaw 里反复点重启。去 TaoToken 模型对话 用同一把 Key 发一条测试消息确认模型 ID 和 Base URL 没填错如果你准备让 OpenClaw 长期跑整理图片、提取表格这类任务可以看 Coding Plan 是否够用Key 要换或要新建在 控制台 API Keys 里操作。下一步就是回 OpenClaw 发一条「整理 D 盘图片」盯着右上角剩余 Tokens 是否随任务变化。