1. OpenClaw 部署完先分清 Gateway 离线还是模型 401OpenClaw小龙虾在 Windows 上部署完Gateway 离线或模型 401 是两种完全不同的故障。前者是本地服务没起来后者多半是模型通道的 Base URL 或 Key 填错了。用 TaoToken 走统一 API 通道时先去 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建 Key再按下面顺序排查。很多新手一看到“无法下发任务”就重装结果问题根本不在安装包而在安全软件拦截或者配置文件里的接口地址写成了官网首页。把这两类问题拆开看排障时间能从半小时缩到几分钟。1.1 Gateway 一直离线先查安全软件、路径和重启顺序原文常见问题 Q3 给的动作是确认安全软件关闭、安装路径纯英文、重启 Gateway。这个顺序不要颠倒。Windows 上不少“Gateway 离线”不是 OpenClaw 本身坏了而是安全软件把本地监听端口拦了或者安装路径里带中文服务启动时读配置直接失败。先看任务管理器里 Gateway 进程是否存在再翻日志里的监听地址是不是本地回环。如果进程在、端口也在监听但界面仍显示离线就去检查防火墙是不是把该端口放行了。路径这块特别容易踩把 OpenClaw 装在D:\软件\OpenClaw这类目录下Gateway 启动时解析路径可能出乱码表现就是一直离线。换成D:\OpenClaw这种纯英文、无空格的路径再重启一次很多离线问题会直接消失。重启时先关掉托盘里的 Gateway等几秒再启动不要反复点“重连”否则旧进程没退干净新进程抢不到端口。1.2 Gateway 在线但一发指令就失败大概率是模型通道 401Gateway 显示在线说明本地服务已经跑起来了任务下发链路没断。这时候发指令报错尤其是日志里出现401 Unauthorized、invalid api key、channel not available这类字样问题就不在 Gateway而在模型通道。OpenClaw 只负责把指令转成模型请求真正去调模型的是你填的 Base URL 和 Key。Key 过期、Base URL 多写了/v1、模型 ID 写错都会让请求在模型侧被拒。判断方法很简单看日志报错同时出现在哪一层。如果报错发生在“模型请求”阶段Gateway 本身是好的如果连日志都没有任务卡在“等待 Gateway 响应”那才是离线问题。把这两类分开后面配置就有方向了。2. 把 OpenClaw 的模型 Base URL 指到 https://taotoken.net/api2.1 去 TaoToken 创建 API Key 并留好占位符打开 TaoToken 注册登录后进控制台创建 API Key。复制出来的 Key 先存到安全的地方填进 OpenClaw 时统一用占位符YOUR_API_KEY表示。不要直接把 Key 贴进聊天窗口或截图发群后面如果怀疑 Key 泄露回控制台重新生成一把即可。Key 只用于模型通道认证和 Gateway 的本地服务没有关系。2.2 OpenClaw 模型配置Base URL 和官网首页不要混在 OpenClaw 的模型或供应商设置里找到自定义兼容通道按下面这张表填。最容易错的是把浏览器里打开的官网落地页地址填进 Base URL那样请求会打到网页而不是 API 接口表现就是 404 或通道不通。配置项该填什么不要填什么Base URLhttps://taotoken.net/api官网首页地址、带/v1的地址API KeyYOUR_API_KEY空值、过期 Key模型 ID以模型广场当时列表为准自己编的 ID、带日期后缀的猜测值配置片段大致如下字段名以你本机 OpenClaw 版本为准{ model: { provider: openai-compatible, base_url: https://taotoken.net/api, api_key: YOUR_API_KEY, model: 以 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 模型广场为准 } }注意 Base URL 末尾不要加/v1。OpenClaw 这一侧只认接口根地址多写的路径会被拼成不存在的 endpoint。官网落地页https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end只用来注册、创建 Key、看模型广场和用量别填进工具。2.3 模型 ID 从模型广场拿不要凭印象写模型 ID 是第二个高频错误点。不同通道的模型命名不统一有的带版本号有的带厂商前缀。正确做法是打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 进模型广场找到你要用的模型复制它当时的 ID再粘贴到 OpenClaw 的模型字段里。如果模型广场列表更新了以当时列表为准不要拿旧教程里的 ID 硬填。3. OpenClaw 对话跑通从 Gateway 在线到第一条指令成功3.1 最小验证重启 Gateway 后先发一条短指令配置保存后完全退出 OpenClaw 和 Gateway再重新启动。先不要跑复杂任务新建一个对话发一条短指令比如让它解释一段简单代码或生成一个测试函数。观察日志里模型请求是否返回 200对话窗口是否正常出结果。如果这一步通了说明 Gateway、Base URL、Key、模型 ID 四项都对上了。如果仍报 401先回控制台确认 Key 是否被禁用或额度耗尽如果报 404检查 Base URL 是不是被拼上了多余路径如果一直转圈没有日志回到第 1 节查 Gateway 进程和端口。验证时不要同时改多个配置项一次只动一个排障才有对照。3.2 报错对照401、404、连接超时分别对应哪一层现象更可能的原因先检查什么Gateway 离线任务不下发安全软件、中文路径、进程未启动任务管理器、监听端口、安装路径401 UnauthorizedKey 错误、过期、额度问题控制台 Key 状态、模型通道余额404 Not FoundBase URL 多写/v1或填成网页地址是否写成https://taotoken.net/api连接超时本地网络到接口不通、代理干扰日志里的目标地址、系统代理设置这张表放在手边遇到报错先对号入座比重新安装省事得多。4. Windows 上排障时容易忽略的三个细节4.1 路径、权限与端口占用Windows 对路径中的中文和空格比较敏感OpenClaw 这类本地服务尤其明显。安装目录、日志目录、临时目录都建议用纯英文路径。权限方面如果 Gateway 装在Program Files下普通用户可能没有写日志的权限表现是进程启动后立刻退出界面显示离线。把安装目录放到用户目录或D:\OpenClaw这类可写路径能避开一半的怪问题。端口占用也常见之前没退干净的 Gateway 进程还占着监听端口新进程启动后绑定失败但界面不报明显错误。用任务管理器结束所有相关进程再重新启动通常就恢复了。4.2 重启顺序先 Gateway 再客户端正确的重启顺序是先启动 Gateway确认它在线并完成监听再启动 OpenClaw 客户端或重新连接。反过来操作客户端可能拿着旧的连接信息去请求网关地址还没就绪就会显示离线或超时。每次改完模型配置也按这个顺序来避免旧配置残留在内存里。4.3 什么时候该回控制台看用量如果对话偶尔成功、偶尔失败或者明明 Key 没错却提示额度不足就该打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 进控制台看这次调用的记录和用量。用量页能帮你确认请求到底有没有打到模型侧有记录说明通道通了问题在模型 ID 或返回格式没记录说明请求根本没到得回到 Base URL 和网络层查。5. 下一步把 Key、模型对话和 Coding Plan 串起来5.1 先用模型对话验证同一把 KeyOpenClaw 跑通之后建议打开 TaoToken 模型对话 用同一把YOUR_API_KEY发一条测试消息。这一步能独立验证 Key 和模型 ID 是否可用排除 OpenClaw 客户端本身的因素。如果模型对话里正常OpenClaw 里还报错就重点查 OpenClaw 的 Base URL 和配置文件路径如果模型对话里也报 401那问题就在 Key 或通道侧直接去 控制台 API Keys 重新创建一把再试。5.2 长期写代码看 Coding Plan需要命令行接入再看文档如果你打算让 OpenClaw 或类似工具长期跑代码任务可以打开 Coding Plan 看当前套餐是否够用。需要把 Claude Code 这类命令行工具也接到同一通道时对照 Claude Code 接入文档 填环境变量Base URL 仍然写https://taotoken.net/api不要带/v1也不要把官网落地页地址填进去。Gateway 离线的问题在本地解决模型 401 的问题在通道侧解决两边分开查OpenClaw 在 Windows 上的对话就能稳定跑起来。