OpenClaw 升级到 2026.4.9 之后最容易把人卡住的不是模型而是控制台旧地址http://127.0.0.1:18789打不开新的 gateway 默认端口变成18790登录页的网关 Token 又变成空白。这里先把 TaoToken 的角色说清楚它只提供模型请求的 Key 和 Base URL不负责改 OpenClaw 的 gateway 端口也不负责往登录页填网关 Token。你如果需要一条统一的模型 API 通道可以打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentopenclaw49 注册并创建 Key。下面按排障顺序走先确认18790能打开再从.openclaw\openclaw.json的gateway.auth.token回填最后把模型通道接到https://taotoken.net/api。1. OpenClaw 4.9 升级后先别重装18790 控制台和空 Token 两个症状升级完成之后很多人第一反应是 OpenClaw 服务挂了于是开始重装、回滚、清配置结果越弄越乱。实际上 2026.4.9 这版更常见的是两个独立问题gateway 默认端口从18789变成了18790控制台地址需要跟着换同时登录页要求的网关 Token 可能没有自动带出来导致页面能打开却登不进去。先分清这两件事排障会快很多。1.1 18789 变成 18790先换控制台地址再谈登录如果你还在用旧书签访问http://127.0.0.1:18789/看到的可能是连接被拒绝、白屏或者一直转圈。这不代表 OpenClaw 没有启动而是新版本的 gateway 默认监听端口已经换了。先把浏览器地址改成http://127.0.0.1:18790/如果这一步仍然打不开再检查本机端口有没有进程在监听。Windows 可以用 PowerShellnetstat -ano | findstr 18790macOS 或 Linux 可以用lsof -iTCP:18790 -sTCP:LISTEN能看到监听记录说明 gateway 至少已经起来了。接下来重点就不是“服务有没有启动”而是“登录页要求的网关 Token 从哪里来”。如果端口没有任何监听再去检查 OpenClaw 是否真的启动、是否被安全软件拦了或者openclaw.json里的gateway.port是否被手动改成了别的值。1.2 登录页网关 Token 为空不是模型 Key 丢了打开http://127.0.0.1:18790/之后更磨人的是登录页里“网关 Token”字段是空的。有人会下意识拿模型 API Key 去填结果当然登不进去。网关 Token 管的是本地 gateway 控制台登录鉴权模型 API Key 管的是向模型服务发起请求两者不是同一套凭证。升级后这个字段被清空通常需要在.openclaw\openclaw.json里找回原来的gateway配置节把auth.token里的编码复制回登录页。这个编码可能是普通字符串也可能是带、带下划线的编码串。复制时不要只复制一半也不要在前后加空格或换行。OpenClaw 的登录页要的是完整值差一个字符都会提示无效。1.3 gateway Token 与 TaoToken API Key 各管一段排障时最容易混的是两个 Key一个是 OpenClaw 本地 gateway 的auth.token另一个是模型通道的 API Key。前者解决“我能不能进127.0.0.1:18790的控制台”后者解决“控制台里的对话能不能请求到模型”。TaoToken 在这里只负责后者你在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentopenclaw49 创建YOUR_API_KEY再把模型通道的 Base URL 填成https://taotoken.net/api。端口和网关 Token 仍然按 OpenClaw 自己的配置文件处理别把两件事混在一起改。2. 打开 .openclaw\openclaw.json 找回 gateway.auth.token控制台地址换到18790之后真正的登录问题通常落在openclaw.json。这个文件里既有 gateway 的 host、port也有auth.token这类登录凭证。升级过程如果没有正确迁移旧配置登录页就会显示空 Token。处理原则很简单先备份再定位gateway配置节最后把auth.token原样回填。2.1 Windows 下定位 openclaw.json 的实际路径Windows 默认用户目录一般在%USERPROFILE%\.openclaw\openclaw.json如果你把 OpenClaw 装在便携目录、绿色目录或者自定义数据目录openclaw.json也可能在程序同级目录里。先确认你正在改的是当前启动实例读取的那一份不要把旧版本的配置文件改了半天启动时读的却是另一个路径。打开之前先复制一份备份例如在 PowerShell 里Copy-Item $env:USERPROFILE\.openclaw\openclaw.json $env:USERPROFILE\.openclaw\openclaw.json.bak备份不是形式主义。这个文件里可能还有 provider、模型、端口、路径等配置改错一个逗号都可能导致 OpenClaw 启动失败。备份后再用编辑器打开重点只找gateway这一节。2.2 读 gateway 配置节auth.token 的编码格式在openclaw.json里找到类似结构{ gateway: { host: 127.0.0.1, port: 18790, auth: { token: 这里是你原有的网关 Token 编码 } } }你本机的字段顺序、缩进可能不同这没关系。关键是gateway.auth.token这一项。如果升级后它还在文件里只是登录页没显示那就把双引号里面的完整编码复制出来。复制时保留原始字符不要自己补空格也不要把YOUR_API_KEY填进去。如果文件里的auth.token也变成了空字符串先看同目录下的.bak备份、旧版本配置或者系统还原里的旧文件。没有旧值的情况下需要按 OpenClaw 当前版本文档重新生成网关 Token而不是拿模型 Key 顶替。2.3 回填登录页后保存并重载 gateway拿到auth.token后回到http://127.0.0.1:18790/登录页把编码粘贴进“网关 Token”字段。如果页面已经打开很久先刷新一次再填。填完能进入控制台说明端口和 gateway 鉴权这条线已经恢复。如果仍然提示无效检查三件事第一openclaw.json保存后是否重启或重载了 OpenClaw gateway有些安装方式不会自动热加载第二你是不是改对了配置文件路径第三复制时有没有漏掉末尾字符。重启入口按你的安装方式走托盘、服务管理器或启动脚本不要为了图快直接杀进程避免配置还没落盘又丢一次。3. 控制台能登进去后再把 OpenClaw 模型通道接到 TaoTokengateway 端口和auth.token修好后OpenClaw 控制台应该能正常进入。但这只解决了“本地控制台登录”如果升级前模型通道也依赖旧配置升级后可能还会遇到请求断、401、404 或者模型列表对不上。把模型请求接到 TaoToken 的统一 API 通道可以少维护几套供应商配置。注意TaoToken 只提供 Key 和 Base URL不负责改 OpenClaw 的 gateway 端口也不负责填登录页的网关 Token。3.1 在 TaoToken 创建 Key 并确认模型 ID打开 TaoToken注册后进入控制台创建 API Key把它保存为占位符YOUR_API_KEY。不要在文章、截图或聊天记录里暴露真实 Key。接着看模型广场复制你要用的模型 ID先记成YOUR_MODEL_ID。模型 ID 以模型广场当时列表为准不要凭记忆写日期后缀或猜测名称否则请求会报模型不存在。这一步只产生两样东西YOUR_API_KEY和YOUR_MODEL_ID。它们会填到 OpenClaw 的模型供应商配置里。至于 gateway 的auth.token仍然用第 2 节从openclaw.json找回的那一个不要混用。3.2 在 openclaw.json 里改模型通道的 Base URL 与 Key不同版本的 OpenClaw 对模型供应商字段命名可能略有差异常见会在openclaw.json里有providers、modelProviders或类似的供应商节点。先看你本机文件里已有的结构沿用原有字段名只替换值。需要改的核心是三项配置项要填的值说明Base URL / baseUrlhttps://taotoken.net/api末尾不要加/v1也不要加 UTMAPI Key / apiKeyYOUR_API_KEY从 TaoToken 控制台创建Model / modelYOUR_MODEL_ID以模型广场当时列表为准如果文件里原本有 OpenAI 兼容供应商可以按下面这种结构改如果你本机字段名不是modelProviders就按你原文件的字段名替换不要凭空新增一套不存在的结构{ modelProviders: { taotoken: { type: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: YOUR_API_KEY, model: YOUR_MODEL_ID } } }保存后重启 OpenClaw让模型通道配置重新加载。这里再次强调https://taotoken.net/api是填进工具的 Base URL结尾不带/v1也不需要加任何查询参数。官网落地页才用于注册、创建 Key、看模型广场和看用量。3.3 不要把 gateway Token 填进模型 Key有些报错看起来像 Key 错其实是把两种凭证填反了。登录页要的是gateway.auth.token模型供应商要的是YOUR_API_KEY。如果你把 gateway Token 填到模型通道模型服务会返回 401如果你把 TaoToken 的 API Key 填到登录页OpenClaw 控制台会拒绝登录。排障时先看报错发生在哪一层进不了127.0.0.1:18790是 gateway 鉴权能进控制台但对话报错才是模型通道。4. 验证 OpenClaw 4.9控制台能进、模型请求不再断配置改完不要只看页面能不能打开。OpenClaw 有两个独立链路本地 gateway 登录链路和模型请求链路。验证要分开做一次只测一条错了才知道该回去改哪一段。4.1 用 18790 控制台发一条最小消息先确认http://127.0.0.1:18790/能进网关 Token 粘贴后不会提示无效。进入控制台后新建一个最小对话只发一句只回复 ok不要一上来就跑长任务、挂自动化或加载复杂上下文。最小消息能减少变量方便判断是鉴权、模型 ID、Base URL 还是上下文配置的问题。如果这条消息能正常返回说明 gateway 登录和模型通道至少都通了。如果控制台能进但对话报错继续看下一节。4.2 看日志区分 gateway auth 失败与模型 401OpenClaw 的日志会把两类错误分得比较清楚。登录页进不去、提示网关 Token 无效属于 gateway auth 失败回去检查openclaw.json的gateway.auth.token和当前实例读取的配置路径。能进控制台但对话报 401通常是模型 API Key 不对、Key 被删、复制不完整或者把网关 Token 填到了模型 Key 位置。对话报 404则优先检查 Base URL 是不是多写了/v1或者模型 ID 不在模型广场列表里。日志里如果出现连接超时还要看当前网络是否允许访问https://taotoken.net/api。但注意这属于正常的 API 请求通道不需要也不应该把 TaoToken 理解成网络代理。它提供的是兼容 API 接入不是用来处理网络访问问题的工具。4.3 去 TaoToken 控制台对一下这次调用最小消息成功后打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentopenclaw49_verify用同一把YOUR_API_KEY在模型对话里再发一条测试消息。这样能确认两件事Key 本身有效模型 ID 和你填进openclaw.json的一致。如果网页端能通、OpenClaw 端报错问题就在 OpenClaw 配置或本地日志里如果网页端也报错先回控制台检查 Key 和模型权限。5. OpenClaw 4.9 升级后排障对照表排障最怕到处猜。升级到 2026.4.9 后和本篇相关的问题基本集中在旧端口、空 Token、凭证混用、Base URL 多/v1、模型 ID 不存在这几类。下面按现象对照处理别一次改五个地方。5.1 旧书签仍打开 18789现象是浏览器提示无法连接或者页面加载失败。处理方式是把地址换成http://127.0.0.1:18790/再用netstat或lsof确认18790有监听。不要先重装 OpenClaw。端口变化已经在 2026.4.9 这个版本里出现先改地址是最小成本动作。5.2 登录页 Token 仍空或提示无效先回到%USERPROFILE%\.openclaw\openclaw.json检查gateway.auth.token是否存在。存在就完整复制为空就找备份或旧配置。保存后重启 gateway。若你在多份openclaw.json之间切换确认启动参数或工作目录指向的是哪一份。这个问题和 TaoToken 无关TaoToken 的 Key 不能替代网关 Token。5.3 模型请求 401Key 贴错或用了 gateway Token401 多数是凭证错误。检查openclaw.json模型供应商里的apiKey是否等于YOUR_API_KEY对应的真实 Key前后有没有空格Key 是否被删除或禁用。最常见的是把gateway.auth.token复制到了模型 Key 字段。分开检查别在两个配置节之间来回粘贴。5.4 模型请求 404Base URL 多了 /v1 或模型 ID 不存在404 先看 Base URL。填进 OpenClaw 的地址应该是https://taotoken.net/api末尾不要加/v1。有些兼容工具习惯让用户填到/v1但这里按统一 API 的 Base URL 来。再看模型 ID必须是模型广场当时列表里的完整 ID不要自己加日期后缀。改完保存并重启 OpenClaw再发一次最小消息验证。6. 升级后固定检查清单与控制台恢复后的下一步OpenClaw 4.9 这次升级不算复杂但它把“本地 gateway”和“模型通道”拆得比较清楚。只要按顺序检查基本不用重装。控制台恢复后再把模型通道单独验一次后面用起来会稳很多。6.1 升级后固定检查清单先看控制台地址是不是http://127.0.0.1:18790/再看openclaw.json的gateway.auth.token是否完整最后看模型供应商的 Base URL、API Key、模型 ID 是否对得上。这三步分别对应 gateway 端口、gateway 登录、模型请求顺序不要颠倒。每次只改一层改完就重启并做最小验证比一次性把所有配置重写好排错得多。6.2 控制台恢复后把模型通道也验一遍当18790控制台能进、auth.token能登录、最小消息也能返回再去 TaoToken 模型对话 用同一把 Key 发一条测试消息确认网页端和 OpenClaw 端用的是同一个模型 ID。如果你准备长期挂 OpenClaw 做自动化可以打开 Coding Plan 看当前套餐是否够用需要新 Key 时在 控制台 API Keys 创建。gateway 端口和gateway.auth.token仍然以你本机openclaw.json为准TaoToken 只把模型请求那条通道接稳。