OpenClaw 的 Gateway 一直显示离线先别急着重装。去 TaoToken 官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建一把 Key把 OpenClaw 的模型接口指向 https://taotoken.net/api再重启 Gateway很多「装好了却连不上模型」导致的离线会当场消失。装完 OpenClaw 之后最常见的一幕是安装向导一路绿灯走完桌面图标也在可主界面左上角那个状态点就是红的或者灰的写着 Gateway 离线。点进对话框发一句「帮我整理一下下载文件夹」转两圈就没下文。原始安装指南里 Q3 给过三条建议关掉安全软件、确认安装路径是纯英文、重启 Gateway。这三招在「装的过程中被拦了」这类问题上确实有效但还有一类离线跟杀毒和路径完全不搭边——OpenClaw 的 Gateway 进程其实起来了只是它向模型服务发请求时一直失败于是它自己判定连接不可用状态灯就一直是离线。这个时候要动的不是安装包而是模型通道。下面按排障的顺序走一遍先用原文那三招排除本地干扰再教你看 Gateway 日志判断卡在哪一层最后把模型接口改成统一接入的地址并重启验证。全程不需要你改 OpenClaw 的源码也不用碰业务数据。1. OpenClaw 的 Gateway 离线先分清是进程、端口还是模型通道1.1 Gateway 在 OpenClaw 里到底负责什么Gateway 是 OpenClaw 的中枢进程它干三件事接收你在界面上输入的指令、把你的指令连同上下文一起发给模型、拿到模型返回的步骤再调度本地的技能去执行。文件整理、网页检索这类任务真正的读写动作发生在你自己的电脑上Gateway 只负责「想」和「派活」。所以 Gateway 一旦离线界面里所有技能按钮全都会变成灰的因为没人接活了。理解了这一点排查思路就清楚了Gateway 离线不代表 OpenClaw 坏了它只说明「中枢没起来」或者「中枢起来了但跟模型说不上话」。这两类问题的处理方式完全不同先别一上来就删掉重装。1.2 三种离线的区分办法第一种是进程根本没起来。特征是在 Windows 的任务管理器、macOS 的活动监视器里找不到 OpenClaw 相关进程托盘图标点了也没反应。这种情况多半是启动被拦截或者上一次退出不干净导致端口被占。第二种是进程在但端口被占。你会看到任务管理器里有进程可界面还是离线。原因是上一次异常退出旧的进程没退干净新启动的实例拿不到那个通信端口。判断方法是连着启动两次看第二次有没有报「端口已被使用」之类的提示。第三种是进程在、端口也正常但模型请求全部失败。这种最容易被误判成「软件有问题」因为界面不报具体的错只有日志里在默默重连。本文重点讲的就是第三种也是原文 Q3 没覆盖到的那一半。2. 先把原文那三招跑干净安全软件、英文路径、重启2.1 安全软件拦出来的「半装」状态安装过程中如果被安全软件拦了一次弹窗而你没有点「允许」那么装出来的 OpenClaw 很可能是个半成品主程序在但负责后台常驻的组件没落地或者被放进了隔离区。表现就是双击能打开界面Gateway 却永远起不来。处理方式是把安全软件里跟 OpenClaw 相关的拦截记录翻出来把被隔离的文件恢复再重新跑一次安装包每一步弹窗都允许。这一步做完之后如果状态灯还是离线那就说明问题不在安装环节继续往下走。2.2 安装路径里的中文和空格原文特别强调过纯英文路径这不是玄学。OpenClaw 的部分组件在启动时会拼接自己的安装目录去调用其他程序路径里一旦出现中文、日文或者空格拼接出来的字符串就可能被截断进程启动到一半自己退出了。最常见的坑是默认装在用户目录下而你的 Windows 用户名恰好是中文比如C:\Users\张三\OpenClaw。建议的做法是卸载后重新安装到盘的根目录比如D:\OpenClaw全程不要有空格和中文。macOS 用户注意别放在带中文名的文件夹里比如「下载」「桌面」这类本地化名称的目录。2.3 重启 Gateway 不等于关掉窗口再打开很多人理解的「重启」是点右上角的叉然后重新双击图标。这个动作只结束了界面进程后台的 Gateway 往往还挂着甚至处于一种卡死的中间态。正确的顺序是先从托盘或者菜单里选「退出」等几秒去任务管理器确认相关进程全部消失再重新启动 OpenClaw。如果你习惯用命令行也可以在确认进程退干净之后从终端重新拉起 OpenClaw 的主程序然后盯着启动日志的第一屏看它在哪一步停下来。这一步的观察结果直接决定后面往哪个方向修。3. 看 Gateway 日志确认它卡在模型请求上3.1 日志里值得盯的几个关键字OpenClaw 的日志一般在安装目录下的 logs 文件夹里找修改时间最新的那个文件。用记事本打开把注意力放在启动后那几十行。如果看到下面这类关键字基本可以确认是模型通道问题而不是安装问题connect timeout、request failed、retry in 5s、401、404、invalid model、ECONNREFUSED。这些词的分工是这样的401和invalid model属于配置内容不对一个是 Key 无效一个是模型名写错404和ECONNREFUSED属于地址不对connect timeout配合「每隔几秒重试一次」的节奏通常说明请求发出去了但没回来。看到这一屏就别再去折腾安全软件了问题在填进 OpenClaw 的那几个参数上。3.2 先用模型对话确认你手上的 Key 是活的在改 OpenClaw 之前先单独验证一次 Key能省掉大量来回折腾。打开 TaoToken 模型对话用你准备填进 OpenClaw 的那把 Key 发一条最简单的消息比如「你好」。能正常回说明 Key 本身没问题剩下的就是 OpenClaw 里的地址和模型名如果这里就报错那先去 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 的控制台重新生成一把再继续。这一步的价值在于把问题切成两半一半是「Key 能不能用」一半是「OpenClaw 有没有填对」。两个变量同时改最后你根本不知道是哪一个起了作用。4. 在 OpenClaw 的模型接口里填上 Base URL 和 Key4.1 去官网创建一把属于 OpenClaw 的 Key打开 TaoToken 完成注册并登录进控制台创建 API Key。建议单独给 OpenClaw 建一把不要和其他工具共用将来哪台机器出问题删掉对应的 Key 就行不影响别的。复制出来的那一串就是后面要粘贴的内容本文里统一写成占位符YOUR_API_KEY。4.2 Base URL 写 https://taotoken.net/api末尾不要加 /v1进入 OpenClaw 的设置找到模型或者模型通道这一栏把服务类型选成自定义接口有的版本叫 OpenAI 兼容然后在地址框里填配置项填写内容接口地址 / Base URLhttps://taotoken.net/apiAPI KeyYOUR_API_KEY模型 ID以模型广场当前列表为准服务类型自定义接口 / OpenAI 兼容这里最容易出错的是地址结尾。官方文档里常见的写法是带/v1的完整路径但填进 OpenClaw 的 Base URL 只要到https://taotoken.net/api为止。多写一个/v1拼接出来的请求路径就会变成两层版本号服务端找不到这个路由返回 404而界面只会显示「离线」。另外提醒一句用来填进工具的这个地址不要带任何查询参数就是干干净净的https://taotoken.net/api。4.3 模型 ID 别自己编去模型广场抄模型 ID 是这一整套配置里最容易被想当然填错的一项。不要凭记忆写一个带日期的长串也不要想当然地加前后缀。正确做法是打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 的模型广场找到你打算用的那个模型把它展示出来的 ID 原样复制到 OpenClaw 的模型框里。列表里没有的模型名填了也是白填返回的会是模型不存在。如果你只是想先跑通挑一个当前可用的通用对话模型就够了。5. 重启 Gateway用文件整理和网页检索两条指令验证5.1 重启之后的三个观察点按 2.3 里说的顺序完整退出再启动一次。启动之后盯三处一是主界面左上角的状态点有没有变绿或者变成在线二是托盘图标右键菜单里 Gateway 的状态是不是「运行中」三是打开日志文件看启动那一段有没有再出现connect timeout。三处都正常说明模型通道已经通了。如果状态灯还是离线的先别重复改参数。回到日志看这一次的报错跟之前是不是同一个换了报错说明你改对了一半继续按第 6 节的对照表处理。5.2 两条冒烟指令验证技能能不能真的跑第一条发「帮我把下载文件夹里最近一周的图片按日期分到子文件夹」。这条指令会走完整链路模型理解意图Gateway 派出文件操作类技能在你本机执行。你只需要确认它给出了明确的操作计划并且真的动了文件不要求它一次整理得多完美。第二条发「帮我检索一下某个主题的最新资料并汇总三条要点」。这条走的是网页检索类技能能返回内容就说明网络请求这一侧也正常。注意一点OpenClaw 的技能是在你自己的电脑上执行动作的模型只负责生成步骤和判断。涉及数据库、服务器这类环境正确的姿势是让它生成 SQL 或者命令你自己在本地终端、SQL 客户端里执行再把结果或者报错贴回对话框让它继续分析不要指望它直接连上你的生产库去跑。5.3 还是离线时的分层对照日志里的现象大概率原因怎么改401 / unauthorizedKey 没粘上或者粘贴时带了空格、换行回 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 的控制台重新复制一次注意首尾不要有空格404 / not foundBase URL 多写了/v1或者其他路径改回https://taotoken.net/apiinvalid model / model not found模型 ID 写错或者当前不可用去模型广场原样复制 IDconnect timeout 反复重试地址域名写错或者本机网络到该地址不通核对地址逐字符确认没有多余空格进程启动后秒退路径含中文或空格或者上一次进程没退干净换纯英文路径彻底结束进程后重来6. 跑通之后去控制台对一下这次调用6.1 确认这次调用有没有记上OpenClaw 能正常回话之后回到 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 的控制台看用量或者调用记录里有没有刚才那两次测试。看到记录说明链路从头到尾都通了Key、Base URL、模型 ID 三项都填对了看不到记录说明 OpenClaw 这边还有缓存的旧配置没生效再完整重启一次 Gateway。这一步比只看状态灯可靠得多。状态灯是 OpenClaw 自己给的判断用量记录是服务端的客观事实两边一致才算真的排障结束。6.2 长期挂着跑再考虑套餐和 Key 管理如果只是偶尔整理文件、查点资料按量走就够了。但如果打算让 OpenClaw 长期挂在后台当数字员工用每天都有任务在跑那最好提前看一下 Coding Plan 这类套餐是否更合适避免用到一半被额度卡住。另外多台机器或者多个工具同时用的时候建议在 控制台 API Keys 里按用途分开建 Key哪一把泄露或者不用了单独删掉即可不用牵连其他环境。最后留个小习惯每次改完 OpenClaw 的模型配置都先去 模型对话 用同一把 Key 发一句话。这一步花不了十秒但能帮你把「Key 的问题」和「填错地址的问题」当场分开省下来的时间比排障本身多得多。Gateway 离线这件事真正难处理的从来不是装不上而是看起来在运行、其实一句话都发不出去。