1. 为什么小龙虾装好了却卡在 Gateway 这一步Open Claw 2.6.4圈里都叫它小龙虾在 Windows 上的一键部署包确实把门槛压得很低解压、双击、等进度条主界面就出来了。但很多人到这一步就停住了右上角一直显示「Gateway 离线」输入框发指令没反应日志里反复刷连接超时。问题不在安装包而在 Gateway 的 API 通道没接上——小龙虾本体只是个调度壳子真正干活的大模型能力要通过 Gateway 转发出去而 Gateway 需要一个可用的 Key 和正确的 config.toml。这篇就专门解决这一段。假设你已经用一键包把 Openclaw-win 目录跑起来了接下来我带你做三件事拿到 TaoToken 的统一 Key、把 config.toml 骨架填对、启动后验证 Gateway 真的在线。全程复制粘贴为主零基础也能跟。适合谁Windows 10/11 用户、刚接触小龙虾、被 Gateway 离线卡住、不想折腾环境变量的人。热词里的「一键部署」「安装包」「Windows」「Gateway」都会落到具体操作上不空谈。先说清楚一个概念方便你理解后面为什么这么配。Gateway 你可以理解成小龙虾的「总机」左边接着你本地的任务调度右边接着模型服务。总机要拨出去得有一个被认可的号码这个号码就是 API Key拨号规则写在 config.toml 里。号码不对或者规则写错总机就一直占线界面自然显示离线。2. 接入前先把 TaoToken 的统一 Key 准备好TaoToken 在这里的角色是提供统一的模型接入入口你不需要为每个模型单独申请一套凭证一个 Key 就能在 Gateway 里调用多种模型。对小白来说最大的好处是配置项少出错面窄。第一步打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并登录。第二步进控制台创建 API Key入口在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。第三步在密钥管理页生成 Key复制那串以 sk- 开头的字符串先粘到记事本里备用。这里有个细节要注意Key 只在生成时完整显示一次关掉页面就看不到了。如果你手滑关了直接删掉重建一个别纠结。另外别把 Key 发到群里或者截图发出去它等同于你的账户额度。如果你后面打算长期跑编码类任务或者挂 Agent可以了解下 Coding Plan入口是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 它更适合高频调用场景。只是先跑通小龙虾的话普通 Key 就够了。想先确认模型通道本身是通的可以打开模型对话页 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 发一句话试试能正常回复说明账户和额度没问题再去配 Gateway 就少一层变量。3. 可复制的 config.toml 骨架与 Key 配置片段小龙虾的配置文件在安装目录下的 config 文件夹里完整路径通常是 D:\OpenClaw\config\config.toml。用记事本或者 VS Code 打开它。如果你之前启动过一次文件里可能已经有默认内容建议先备份一份 config.toml.bak改坏了能退回来。下面这份骨架可以直接复制把其中两处占位符换成你自己的值即可。注意 TOML 对引号和大小写敏感别用中文引号。# Open Claw 2.6.4 Gateway 配置骨架 [gateway] enabled true host 127.0.0.1 port 8765 # 首次启动初始化较慢超时给足 startup_timeout 180 [gateway.provider] # 统一走 TaoToken 接入 name taotoken base_url https://taotoken.net/api api_key sk-替换成你自己的Key # 默认调用的模型按需改 default_model gpt-4o-mini [gateway.provider.options] # 单次请求超时网络慢可调大 request_timeout 60 # 失败重试次数 max_retries 2 [logging] level info path D:/OpenClaw/logs/gateway.log几个参数逐个说清楚避免你瞎猜。base_url 固定填 https://taotoken.net/api注意这里不带任何多余路径Gateway 会自己拼接。api_key 就是你刚才复制的那串整段用英文双引号包住。default_model 先填一个通用模型跑通链路等 Gateway 在线了再换成你常用的。startup_timeout 设 180 是因为第一次启动要初始化设太小会误报超时。logging.path 里的斜杠用正斜杠或者双反斜杠都行单反斜杠在 TOML 里会被当转义符容易报解析错误。改完保存注意编码选 UTF-8别存成带 BOM 的格式否则读取时可能报 config parse error。4. 启动 Gateway 并验证请求真的通了配置写好后回到 Openclaw-win 目录双击那个红色龙虾图标的一键启动程序。如果你之前已经开着主界面先完全退出再重开让新配置生效。启动后观察两处。第一处是主界面右上角的状态从「正在等待 Gateway 就绪」变成「Gateway 在线」。第二处是日志文件 D:\OpenClaw\logs\gateway.log用记事本打开看到类似下面的行就说明通道打通了[INFO] gateway listening on 127.0.0.1:8765 [INFO] provider taotoken initialized [INFO] health check passed如果不想等界面刷新也可以手动验证一次。打开 PowerShell执行一条健康检查请求curl.exe http://127.0.0.1:8765/health正常会返回类似 {status:ok,provider:taotoken} 的内容。这一步能返回 ok说明 Gateway 进程活着、配置读进来了、provider 初始化成功。接着做一次真实调用验证在小龙虾底部输入框发一句最简单的指令比如「列出 D 盘根目录的文件名」。如果它能返回结果说明从界面到 Gateway 再到模型服务的整条链路都通了。实测下来第一次启动从点击到「Gateway 在线」大概要 1 到 3 分钟之后重启通常十几秒就好。别在第一次启动时反复点重启容易把初始化进程打断。5. 本篇常见报错与排查动作配 Gateway 这一段新手最容易撞上的就下面几类我按现象、原因、动作列出来你对号入座。现象一界面一直「Gateway 离线」日志里刷 connection refused。多半是 config.toml 没被读到或者端口被占用。先确认文件路径是 D:\OpenClaw\config\config.toml不是放在别处。再检查 8765 端口有没有被别的程序占了PowerShell 里跑 netstat -ano | findstr 8765有占用就换个端口比如改成 8766同时记得同步改健康检查的地址。现象二日志报 config parse error 或 invalid TOML。基本是格式问题。重点查三处引号是不是英文的、路径里有没有单反斜杠、有没有多写或漏写方括号。把 config.toml 贴到在线 TOML 校验器里过一遍最快。现象三日志报 401 或 unauthorized。Key 不对。检查 api_key 有没有多余空格、有没有把 sk- 前缀漏掉、Key 是不是已经失效。回控制台 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 重新生成一个换上。现象四能连上但请求超时。把 request_timeout 从 60 调到 120max_retries 调到 3。如果还是超时去模型对话页确认账户额度是否正常。现象五安全软件把 Gateway 进程或日志文件删了。这是老问题安装和运行期间把 360、电脑管家、火绒这类先退出或者把 D:\OpenClaw 整个目录加进信任区。被隔离的文件恢复后重新启动。排查顺序建议固定成先看日志最后 20 行再验健康检查接口最后才动配置。这样能避免瞎改一通。6. 跑通之后Key 和文档放哪Gateway 显示在线、指令能返回结果这一篇的目标就达成了。后续你要扩展技能、换模型、接本地能力都建立在这条通道之上所以把 Key 和配置管好很重要。统一 Key 的日常管理在控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 密钥列表在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入参数和字段说明看文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面 base_url 和模型名的对应关系写得比较全换模型时照着改 default_model 就行。如果你后面要挂 Claude Code 这类编码工具走的是另一套接入方式参考 https://taotoken.net/ClaudeCodeAnthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。长期跑 Agent 或高频编码任务再考虑 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后留个我踩过的坑改完 config.toml 一定要完全退出小龙虾再重启光点界面里的「重启服务」有时候读的还是旧配置。养成改配置先备份、改完看日志的习惯Gateway 这一段基本不会再卡你。
