“Gateway 离线”这个状态差点让人以为 OpenClaw v2.7.9 白装了。按原文把 360 安全卫士、腾讯电脑管家、火绒以及 Windows Defender 实时防护全部关闭安装路径也改成了纯英文的 D:\OpenClaw界面右上角却仍然显示离线。遇到这种离线TaoToken 提供了一条排查思路前往 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建 API Key再把 OpenClaw 的模型通道 Base URL 填成 https://taotoken.net/api不要带 /v1重启 Gateway 服务就能看到“Gateway 在线”。这时候就能确认离线原因不是安全软件或路径而是模型通道的地址写错了。1. 现象与判断杀毒关了、路径也改了Gateway 仍然离线1.1 为什么反复重启没用原文把“Gateway 离线”归因为安全软件拦截或路径不规范。这两点在初次部署时确实最容易踩也是最基础的要求安全软件退出后OpenClaw 的模拟键鼠动作、读取系统底层文件才能正常执行纯英文路径则能避开 Windows 下常见的编码问题。可当你把这两条全部做到状态栏依然是离线再点几次“重启 Gateway 服务”也不太可能有变化因为 Gateway 进程已经启动起来了真正没通的是它背后的模型通道。很多人把问题想成“服务没起来”于是反复重启软件、重装部署包。实际上 OpenClaw 的界面状态是通过内部心跳请求来显示的Gateway 进程存在但心跳请求打到错误的模型地址时界面就会进入离线保护。与其反复折腾环境不如先确认模型通道这一层。1.2 离线常见原因地址多了 /v1OpenClaw 的模型通道设置里需要填一个 API 地址。很多模型服务商的要求是 Base URL 末尾带 /v1而 OpenClaw 自己的配置示例却往往不带两者一混就出错。模型通道地址就像寄快递的地址Base URL 是门牌号/v1 是门牌号后面多余的备注备注写错了快递员找不到收件人Gateway 就会一直显示离线。常见的错误写法有https://taotoken.net/api/v1多写了 /v1https://taotoken.net/api/末尾多了一条斜杠http://taotoken.net/api少了 s这些都会让请求落在不存在的路由上Gateway 状态自然长期离线。记住一个原则OpenClaw 模型通道里只填根地址不带 /v1。2. 准备材料先在 TaoToken 拿一把可用的 API Key2.1 TaoToken 在 OpenClaw 里扮演什么角色TaoToken 不参与 OpenClaw 的文件整理、浏览器操作、消息推送这些功能它只做一件事把模型通道的接入地址统一起来。对 OpenClaw 这种图形化工具来说模型供应商越多地址格式越杂越容易因为一个斜杠写错导致离线。TaoToken 的做法是把接入地址收敛成同一个根地址https://taotoken.net/apiKey 和模型 ID 在官网控制台统一管理。这样配置表单里可变的量就很少了排障也简单。2.2 创建 Key 的具体操作打开官网 TaoToken注册并登录进入控制台后找到 API Keys 页面点击创建新 Key。创建完成后复制保存这就是配置 OpenClaw 时要用的YOUR_API_KEY。注意Key 不会在页面上第二次完整显示复制之后先粘贴到记事本或密码管理器里。如果你不确定选哪个模型可以在官网的模型广场里先看看当前有哪些可用模型模型列表以当时页面显示为准。先选一个你常用或想试的模型把它记下来后续填到 OpenClaw 模型通道的“模型 ID”字段里。3. 模型通道表单把 Base URL 填成 https://taotoken.net/api3.1 打开 OpenClaw 的模型通道设置启动 OpenClaw进入主界面后找到“模型通道”或英文 Model Provider 的设置入口。如果你之前手动添加过其他模型供应商先删掉或停用避免 OpenClaw 自动选择错误的通道。新增一条通道后按下面的参数填写。3.2 参数对照表在 OpenClaw 的模型通道表单中通常有三个字段Base URL、API Key、Model ID。按下表填写字段填写内容说明Base URLhttps://taotoken.net/api根地址不要带 /v1API KeyYOUR_API_KEY从 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建Model ID以 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 模型广场当时列表为准在官网查询当前可用模型 ID注意这里的 Base URL 和官网落地页不是同一个用途。官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 只用来注册账号、创建 Key、查看模型广场和用量而https://taotoken.net/api是填进 OpenClaw 的接口地址两者不要混用。3.3 关于 /v1 的补充说明如果你的上一个供应商要求填https://xxx/v1换成 TaoToken 之后一定要把末尾的 /v1 删掉。OpenClaw 在请求模型时会自动补全后续路径你多写一个 /v1它就多拼一段最终请求路径就会变成/api/v1/...接口自然返回 404。保存配置后不要急着点“在线检测”直接重启 Gateway 服务让新配置生效。4. 重启 Gateway 服务验证“Gateway 在线”4.1 重启动作保存模型通道配置后点击界面上的“重启 Gateway 服务”按钮。如果找不到这个按钮就完全退出 OpenClaw 再重新启动。第一次重启 Gateway 会重新初始化后台服务等待 1 至 3 分钟属于正常现象这和原手册里第一次启动的等待逻辑是一样的。4.2 用一条指令验证看到“Gateway 在线”后用一条整理类的指令测试“整理桌面所有 Word 文档提取每份文档核心文字内容生成汇总表格”。如果指令能被拆分并开始执行说明模型通道、API Key、模型 ID 三者的组合没问题。如果状态变成在线但指令执行时报错往下看高频报错对照。5. 高频报错对照401、404、路径错误5.1 401 Unauthorized状态栏可能短暂显示在线但一调用就报 401。这代表 API Key 无效。可能是复制时带了换行也可能是 Key 本身没复制完整。回到官网重新创建一把新 Key粘贴到 OpenClaw 模型通道时注意首尾不要留空格。5.2 404 Not Found请求到达了服务器但路径不对。90% 的情况是因为最后多写了 /v1或者 Base URL 误填成了https://taotoken.net/api/。回模型通道里把地址改成https://taotoken.net/api保存后重启。TaoToken 的 API 地址是统一的这类由路径不同导致的 404 在修正后不会反复出现。5.3 路径错误提示如果你已经按原手册关掉所有安全软件、路径也是纯英文仍然遇到路径错误提示观察一下 OpenClaw 安装目录里是否存在上次失败部署留下的临时文件夹或残留快捷方式。建议删除整个目录后重新解压再走一次部署流程。这个问题和模型通道无关但也会伪装成 Gateway 离线。6. 跑通之后去控制台对一下这次调用6.1 用模型对话页再验证一次OpenClaw 跑通后建议去 TaoToken 模型对话 里用同一把 Key 发送一条测试消息。如果网页端能正常回复而 OpenClaw 里报错问题只差在 OpenClaw 表单的 Model ID 或 Base URL 写法上。6.2 看用量和后续计划打开控制台的 API Keys 页面能看到这把 Key 的调用记录这一次调用是否记账一目了然。如果你打算长期让 OpenClaw 帮你整理文件、处理办公数据可以打开 Coding Plan 看看按套餐使用是否更合适。完整的环境变量和接入参数对照可以参考 Claude Code 接入文档虽然针对的是 Claude Code但里面关于 Base URL 和 Key 的说明同样适用于 OpenClaw。
)
