部署后 OpenClaw 网关离线,重启服务无效,先别卸载重装。大概率不是本地装好而是模型通道没对上,TaoToken 的兼容 API 能解决:到 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 拿 Key,回 OpenClaw 模型设置把 Base URL 填成 https://taotoken.net/api,Gateway 通常会重新在线。解压、路径、杀毒那几项仍按原文先排除。下面按「本地是否正常 → 模型通道是否指向外部 → 有没有真的发出请求」的顺序走一遍,避免反复重启浪费时间。
1. 重启服务仍显示 Gateway 离线时,先判断哪一层没起来
1.1 Gateway 进程活着,不等于模型通道通着
OpenClaw 2.6.6 的 Gateway 是本地任务调度的入口,同时负责把对话指令转发给外部模型服务。右上角显示「离线」,很多情况下不是进程崩溃,而是它发出的模型请求没有返回值。你可以把它想成小区前台:前台有人值班,不代表电话线路是通的;重启服务只是让值班人员重新坐好,电话线本身还是原来的状态,所以过一会儿又离线了。把「进程状态」和「模型通道状态」分开看,排障思路就清楚了一半。
1.2 在日志里搜 gateway、connect、timeout
先找 OpenClaw 的日志。通常日志在安装目录的 logs 文件夹里,也可以在设置界面的日志面板查看。搜索 gateway、connect、timeout、auth 这几个关键词。如果看到 connection refused、timeout、authentication 这类记录,说明本地服务已经起床了,但它跟模型服务之间的握手失败——这就是原文第六节没有展开的那一层。不要急着重装,下一步先把本地环境复核一遍,把启动问题彻底排除。
1.3 重启前先确认没有残留进程占着本地端口
很多人点「重启服务」时,只是点了界面上的按钮,或者干脆关闭窗口再打开。OpenClaw 的 Gateway 进程不会因为窗口关闭就立刻退出,它可能还在后台运行,导致第二次启动时新的 Gateway 抢不到端口,状态自然一直是旧进程的「离线」。正确做法是:先在任务管理器里找到 OpenClaw 相关进程,全部结束,再从桌面或解压目录重新点击一键启动程序。如果之前反复重启过,这一步比改配置更优先。做完之后再按下一节复核。
2. 按原文避坑点做一轮快速复核,排除本地因素
2.1 先复核杀毒、英文路径、解压工具
原文的「安装前必看」三条仍然成立。即使你已经部署成功一次,还是值得再确认:360、电脑管家、火绒、Windows Defender 的实时防护是否处于关闭状态;安装路径是不是 D:\OpenClaw 这种纯英文路径;解压时用的是不是 WinRAR 或 7-Zip。最容易迷惑人的是杀毒软件:它不一定弹窗,而是在后台静默拦截了 OpenClaw 对文件和键鼠模拟的访问,导致 Gateway 启动一半就掉线。如果这三项里任意一项不符合,就关闭杀毒、重新解压,再启动一次。
2.2 确认本地服务已运行,而不是只看到主界面
第二步看进程和本地端口。打开任务管理器,确认 OpenClaw 相关进程在运行;再按部署完成后界面提示的 localhost 地址访问本机管理页面,如果页面能打开,说明本地部署是完整的。走到这一步,原文说的「重启服务或重新运行程序」已经失去了意义:服务是活的,只是连不上模型。这时才轮到模型通道配置上场。别在这之前反复重启,重启十次也只会在同一个位置掉线。
2.3 核对部署包完整性,避免解压文件损坏
原文强调过使用 WinRAR 或 7-Zip,不推荐系统自带解压。这个建议不只是为了省事,系统自带解压遇到 361MB 的安装包时,偶尔会把文件权限或结构解错,目录里少几个文件也能解压出来,进程能启动但功能不完整。复核方法是:重新解压一遍安装包,确认 Openclaw-win 文件夹里包含一键启动程序;如果解压过程出现「文件损坏」「CRC 失败」之类的提示,重新下载部署包。这一步做完还是离线,就能确定问题不在部署阶段。
3. 在 OpenClaw 模型设置里把 Base URL 指到 TaoToken
3.1 去 TaoToken 注册并创建 YOUR_API_KEY
准备三样东西:TaoToken 账号、API Key、一个可用的模型 ID。打开 TaoToken 注册登录,进入控制台的 API Keys 页面创建新 Key,本文统一写成 YOUR_API_KEY。模型 ID 不要凭记忆填,以模型广场当时列表为准。TaoToken 是统一 API 接入服务,做的事情是把各家模型的接口收拢到一个兼容入口,OpenClaw 不需要为每个模型服务商单独记一个 endpoint,也不需要安装任何本地插件;如果你同时维护多个模型,换模型时只需要改 Model ID,不用换地址。
3.2 三个配置项按这张表填进 OpenClaw
在 OpenClaw 主界面找到模型设置入口,版本不同可能在「模型管理」或「供应商设置」下。OpenClaw 对外部模型走的是 Anthropic 兼容协议,所以你要找的字段名通常就是 Base URL、API Key、Model ID。字段位置可能不同,但概念一致:Base URL 决定请求发给谁,API Key 决定有没有权限,Model ID 决定用哪个模型。先把这三个字段找齐,再往下填。
| 配置项 | 填写值 |
|---|---|
| Base URL | https://taotoken.net/api (末尾不要带 /v1) |
| API Key | YOUR_API_KEY |
| Model ID | 以模型广场当时列表为准 |
提示:Base URL 填进工具时要和官网地址区分开。官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 只用来注册、建 Key、看模型广场、看用量;https://taotoken.net/api 才是 OpenClaw 真正发起请求的接口地址。不要在 /api 后面补 /v1,OpenClaw 会按协议自动拼接路径,多补反而会让握手失败。保存后回到主界面,不用重启电脑,等 Gateway 重新初始化。
4. 保存后等 Gateway 重新在线,用原文指令做真验证
4.1 观察右上角状态,但别只盯 10 秒
配置保存后,OpenClaw 需要重建与模型服务的连接。参考原文第五节的初始化时间,等待 1–3 分钟,右上角才会从「Gateway 离线」切到「Gateway 在线」。很多人配完看到状态没立刻变化,以为没生效,马上又改了回去。其实健康检查有超时和重试机制,短时间内的状态不能代表最终结果。原文也提过「启动缓慢:等待服务加载完成即可」,切换模型通道后的重新初始化同理。如果 3 分钟后仍是离线,再做第 5 节的检查。等待的这段时间不要反复点保存,每次点保存都会打断连接重建。
4.2 用「整理 D 盘下载文件夹」这条指令验证
状态变绿后,在 OpenClaw 对话框发一条原文里的示例指令,比如「整理 D 盘下载文件夹图片,按拍摄日期分类」。这条指令会走完整链路:模型理解任务、拆成步骤、OpenClaw 本地执行文件操作。只要对话框开始输出任务步骤而不是一直转圈,就说明模型通道通了。原文里提到的「搜索信息并整理成 Excel」「批量提取文档内容」也可以作为备选。指令能跑通,才说明这次改动真的解决了问题;只看到绿灯却没有执行能力,还不能算完成。
4.3 状态在线但指令一直转圈,先查模型 ID
还有种情况容易被误判为「配置成功」:Gateway 显示在线,但发指令后一直转圈,不出任务拆解。这通常是模型 ID 填了一个模型广场里不存在的名字,OpenClaw 请求发出去后被接口拒绝,但本地健康检查已经通过,所以状态亮着。解决办法是回到模型设置,打开模型广场,把 Model ID 改成广场列表里真实存在的值,再等一轮。控制台若出现对应的错误记录,也能印证这一判断。
5. 仍然离线就按 Base URL、Key、控制台记录三步查
5.1 先检查 Base URL 末尾和 Key 是否被复制完整
第一个要复查的是 Base URL。很多配置界面不支持自动去空格,粘贴时容易带回一个看不见的换行,或者被输入法补了一个空格;更常见的是在 https://taotoken.net/api 后面多打了 /v1。第二个要复查的是 API Key,打开控制台重新复制一次,看有没有多一位少一位,不建议手动输。这两个原因占了「换通道后仍然报错」的绝大多数情况。改完保存,再等一轮 1–3 分钟看状态。
5.2 用模型广场发一条消息,判断 Key 本身有没有问题
如果 OpenClaw 这边怎么保存都不行,不要反复折腾界面,去官网验一下 Key。打开 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 进入模型广场,选同一个模型 ID,用刚才那把 YOUR_API_KEY 对应的账号发出请求。模型广场能回复,说明 Key、模型 ID、账号状态都正常,问题一定在 OpenClaw 填的那三项上;模型广场也不能回复,说明要去控制台看看 Key 是否成功创建,或者用量是否已经用完。这个对照能把故障范围切到正确的一侧。
5.3 去控制台对一下调用记录,判断请求到底发没发出去
最后一步看用量记录。保存配置后,即使 Gateway 仍显示离线,TaoToken 控制台通常也会记录下每一次到达接口的请求。如果控制台完全没有新记录,说明 OpenClaw 没有把请求发到 https://taotoken.net/api,问题多半出在配置没有保存成功,或者界面里填的 Base URL 和表格不一致;如果控制台出现 401/403,说明请求到达了 TaoToken,但 Key 或模型 ID 对不上。用这条记录反向还原配置过程,比盯着离线状态猜更直接。
跑通之后,建议先在 TaoToken 模型对话 里用同一把 Key 发一条消息,确认模型 ID 和 Base URL 的组合本身没问题。如果之后要把 OpenClaw 的自动化任务跑得更重,可以先打开 Coding Plan 看套餐是否够用;新 Key 统一在 控制台 API Keys 创建。这套 Key 也适配 Claude Code,环境变量的对应关系见 Claude Code 接入文档,以后别的工具要接模型,能少记不少地址。