Openclaw-Windows-2.7.5.zip 解压完双击「Openclaw Windows 一键启动.exe」看着 Gateway 从「正在等待 Gateway 就绪」跳到「Gateway 在线」这一步照旧。真正容易卡住的是后面OpenClaw 主界面里的模型通道该填谁。想把 Gateway 模型通道改到 TaoToken 行不行可以先去 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentopenclaw_gateway 注册并创建 Key再回 OpenClaw 的 Gateway/模型设置里填 Base URL。这篇就围绕 Windows 端 OpenClaw v2.7.5 一键包把通道切换、填写顺序、验证指令和排障讲清楚。部署步骤不用重来解压、杀软、纯英文路径、SmartScreen、第一次等 Gateway 就绪都按原教程走我们只改模型通道认证和 Key 来源不去填不明代理也不把官网落地页塞进工具配置。1. OpenClaw v2.7.5 的「Gateway 在线」只代表部署成功1.1 一键包把服务拉起来了模型通道可能还是空的原文的流程是下载 zip、解压、运行一键启动、等 Gateway 从等待到在线。这个状态只说明本地 Gateway 服务能跑不代表它背后的模型通道已经接到你想要的供应商。很多开发者第一次装完看到右上角「Gateway 在线」就以为万事大吉结果发指令时要么转圈要么提示认证失败要么模型列表里只有默认项。实际要区分两层Gateway 是本地调度层模型通道是它向上游发请求时用的 Base URL、Key 和模型 ID。部署成功和通道可用是两件事。OpenClaw 做文件整理、浏览器自动化、表格汇总时流程通常是主界面收到自然语言指令Gateway 把任务拆解成步骤再调用模型判断下一步最后本地工具执行文件操作。模型通道不通Gateway 本身仍然可能显示在线但任务会停在「思考中」或直接报错。所以部署完之后别只看右上角那一个状态灯还要真正发一条指令测通道。1.2 被多 Key、额度、切模型卡住的典型场景比如你手上有几把不同来源的 Key今天用 A明天用 BOpenClaw 里还留着旧的认证信息或者官方通道额度跑完想临时换一个能统一管 Key 的入口又或者你要在同一个 OpenClaw 里切不同模型做文件整理用便宜模型做复杂总结再换强一点的。每换一次都要改配置、重启 Gateway如果没有统一入口就会变成在多个控制台之间来回找 Key。TaoToken 在这个环节提供的是一个兼容通道你不需要改 OpenClaw 的部署方式只需要把 Gateway 的模型通道指向它。还有一种情况是团队里几个人共用一台 Windows 机器跑 OpenClaw每个人用自己的 Key 容易乱。统一走一个 API 通道后至少 Base URL 和 Key 来源是固定的排查时不用猜「这台机器到底填了哪家地址」。这也是为什么更推荐在部署完成后先把模型通道收口再去加技能扩展。1.3 TaoToken 在 OpenClaw 里只负责 Base URL 和 Key 来源具体做法不复杂打开 TaoToken 注册账号创建一把 API Key复制出来备用。回到 OpenClaw 的 Gateway/模型设置把 Base URL 填 https://taotoken.net/apiKey 填 YOUR_API_KEY模型 ID 从模型广场当时列表里选。注意官网落地页只用来注册、创建 Key、看模型广场和用量填进工具的地址是 https://taotoken.net/api末尾不要加 /v1也不要带 UTM 参数。这个区分很重要填错就会在 OpenClaw 日志里看到 404 或连接异常。提示API Key 用占位符 YOUR_API_KEY 表示真实 Key 从 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentopenclaw_gateway_key 创建。不要把 Key 截图发到群里也不要把官网链接粘进 Base URL 输入框。2. 解压 Openclaw-Windows-2.7.5.zip 到 Gateway 亮起原步骤别改2.1 用 WinRAR 或 7-Zip 解压确认 Openclaw-win 目录下载完 Openclaw-Windows-2.7.5.zip 后不建议用 Windows 自带解压。右键选 WinRAR 或 7-Zip解压到当前文件夹或者解压到 Openclaw-Windows-2.7.5。完成后你会看到 Openclaw-win 文件夹进去确认有「Openclaw Windows 一键启动.exe」红色龙虾图标。这个步骤跟模型通道无关但解压损坏会导致后面 Gateway 起不来所以别省。如果你之前装过旧版本建议先退出旧程序确认旧 Gateway 进程没有占用端口再解压新目录。目录名最好保持纯英文例如 D:\OpenClaw\Openclaw-win。有人喜欢把解压目录放在中文路径下运行 exe 时看着没问题等到 Gateway 初始化写配置文件时才报错那种情况排查起来很浪费时间。2.2 启动 exe 前杀软、SmartScreen、纯英文路径双击 exe 后Windows 可能弹「Windows 已保护你的电脑」。点「更多信息」再点「仍要运行」。安装路径要纯英文不要中文、空格、特殊符号。推荐 D:\OpenClaw 这种。杀毒软件包括 360、火绒、Windows Defender 实时防护最好先关掉或给 Openclaw-win 目录加白名单否则 OpenClaw 读写文件、模拟键鼠时容易被拦截。原文把这几条列为必看避坑点确实不是吓唬人路径里有中文时部署直接失败的概率很高。安装界面的路径选择框里别填 D:\软件\OpenClaw 或 D:\小龙虾也不要带空格。勾选用户协议后点开始安装程序会自动补 Git、Node.js、Python 这些依赖部署核心文件装浏览器控制工具生成配置文件创建桌面快捷方式。这个过程不要手动关窗口中断后往往要重新部署。2.3 第一次启动等 Gateway 就绪这时先别填不明代理安装完成后程序会自动启动。第一次启动 Gateway 要初始化界面显示「正在等待 Gateway 就绪...」等 1 到 3 分钟之后跳到聊天窗口右上角显示「Gateway 在线」。在这个阶段先别急着从网上抄一个不明代理地址填进去。你要做的是打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentopenclaw_gateway_prepare 注册并创建 API KeyKey 先放记事本里等 Gateway 稳定在线后再进模型设置。这样排障时变量少出问题也能分清是部署问题还是通道问题。主界面底部输入框支持 Enter 发送、ShiftEnter 换行左侧菜单可以切换本地和渠道右上角有重启、日志、剩余 Tokens。先熟悉这些位置后面改完通道、重启 Gateway、看日志都会用到。第一次启动慢是正常现象后续启动一般会快很多不用因为「正在等待 Gateway 就绪」停留时间长就重装。3. OpenClaw 主界面里把 Gateway 模型通道指向 TaoToken3.1 找到 Gateway / 模型设置里的自定义供应商入口OpenClaw 主界面右上角有 Gateway 状态、重启按钮、日志、剩余 Tokens。模型通道一般在设置、渠道或 Gateway 配置里。不同一键包版本入口名称可能略有差别但核心字段就三个Base URL、API Key、模型 ID。如果你看到「自定义供应商」「OpenAI 兼容」「API 通道」这类选项就选它。不要选需要额外申请复杂认证的通道也不要填来路不明的代理地址。进入配置页后先把旧的通道信息记下来或者截图保存。有些版本在切换通道时会清空默认模型导致主界面模型下拉框变空。遇到这种情况不用慌填完 Base URL、Key、模型 ID 后保存再重启 Gateway 就会恢复。关键是别在多个配置页之间同时改一次只改一个地方。3.2 Base URL 填 https://taotoken.net/api末尾不要 /v1在 Base URL 字段里填https://taotoken.net/api注意末尾不要加 /v1也不要加 ?utm_source...。官网落地页是给人点的https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentopenclaw_gateway_config 是用来注册和创建 Key 的填进 OpenClaw 的 Base URL 只认 https://taotoken.net/api。很多 404 不是通道坏了而是把 /v1 重复拼了一次或者把带 UTM 的链接粘进了配置框。如果你在 OpenClaw 里看到的是「API 地址」「接口地址」「服务地址」这类字段填的值也一样。注意不要加尾随空格不要用中文引号。Windows 下复制粘贴有时会带上换行保存前在输入框里按 End 看一眼确认末尾没有多余字符。3.3 API Key 填 YOUR_API_KEY模型 ID 以模型广场为准API Key 填你刚创建的那把本文用占位符 YOUR_API_KEY 表示。不要保留空格不要用引号包住也不要把官网链接当 Key。模型 ID 不要凭记忆写去 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentopenclaw_gateway_models 模型广场看当时列表复制你要用的那个 ID。如果你在 OpenClaw 里只想先跑通文件整理选一个响应快、成本可控的模型即可后面要做长文总结再换更强模型。模型 ID 写错通常表现为「模型不存在」或请求被上游拒绝而不是 Gateway 离线。有些一键包会在主界面显示剩余 Tokens这个数字来自通道侧。如果你填完 Key 后剩余 Tokens 还是旧数字先点重启 Gateway再刷新界面。还不对就去看日志日志里通常会写清楚是认证失败还是模型名无效。不要在这个时候去改安装路径那和通道配置是两码事。3.4 保存后重启 Gateway再看右上角状态点保存后不要直接发指令。先点右上角的重启按钮或者退出 OpenClaw 后重新运行「Openclaw Windows 一键启动.exe」。等 Gateway 再次显示在线。这个重启动作是为了让新的 Base URL 和 Key 生效。如果重启后右上角一直离线先回到第 2 章的杀软、路径、端口占用排查不要急着改模型 ID。通道配置错误一般不会让 Gateway 本身离线它更多会在你发指令时以认证失败或模型不存在的方式暴露。配置字段对照表字段填什么不要填什么Base URLhttps://taotoken.net/api末尾加 /v1带 ?utm_source... 的官网链接API KeyYOUR_API_KEY带空格的 Key官网地址旧 Key模型 ID以模型广场当时列表为准自己编的 gpt-5、带日期后缀的假 ID通道类型自定义 / OpenAI 兼容 / API 通道不明代理、临时地址注意OpenClaw 的 Key 和 Base URL 是给 Gateway 用的不是给浏览器用的。浏览器打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentopenclaw_gateway_console 只负责注册、创建 Key、看用量。4. 用「整理 D 盘下载文件夹图片」验证新通道是否真通4.1 先确认右上角还是「Gateway 在线」重启后第一眼看右上角。如果显示在线说明本地服务没问题。接着不要一上来就发复杂任务先用短指令确认模型能响应。你可以在主界面底部输入框发一句「你好确认一下当前模型通道是否可用」。如果这句能返回再发文件整理指令。如果这句就报认证失败直接跳到第 5 章看 Key 和 Base URL。短指令还有一个好处它不会触发文件移动万一模型通道没通也不会在本地留下半成品目录。等确认模型能返回再让 OpenClaw 去碰 D 盘下载文件夹。第一次跑文件整理建议先在一个测试文件夹里放几张图片确认分类逻辑符合预期再换到真实下载目录。4.2 发原文那条「整理 D 盘下载文件夹图片按拍摄日期分类」把原文里的高频指令拿来验证很合适「帮我整理 D 盘下载文件夹里的图片按拍摄日期分类新建对应文件夹存放」。这条指令会触发 OpenClaw 拆解任务、读取目录、判断图片、创建文件夹、移动文件。它能跑起来说明 Gateway 已经通过 TaoToken 的兼容通道拿到了模型响应并且本地工具调用也正常。注意AI 只生成步骤和判断实际文件操作由 OpenClaw 在本地执行你在旁边看着日志即可。如果执行到一半停住先看日志里的具体步骤。是读目录失败还是创建文件夹失败还是移动文件被拒绝。把那段日志贴回对话让模型解释下一步该怎么处理而不是让它直接连你的生产环境或业务库。OpenClaw 处理本地文件已经足够遇到权限问题就手动改目录属性或换测试目录。4.3 去控制台看这次调用有没有记上账指令跑完后打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentopenclaw_gateway_verify 进控制台看用量或调用记录。如果能看到刚才这次请求说明 Key 和 Base URL 用的是同一把通道确实通了。如果 OpenClaw 本地有返回但控制台没记录常见原因是 Key 被换回了旧值或者你以为在改 OpenClaw实际改的是别的工具配置。把这两个地方对齐后面排障会快很多。也可以顺便在模型对话里用同一把 Key 发一条测试消息确认模型 ID 没有写错。OpenClaw 主界面显示成功不代表模型名称一定对因为有些兼容通道会先返回一个默认响应。控制台有记录模型对话也能正常返回这两个条件同时满足再回到 OpenClaw 做文件整理会更稳。5. Gateway 改通道后常见的 4 个报错排查5.1 右上角又变离线先查杀软、路径和端口如果重启后「Gateway 在线」变成离线先看杀软有没有把 Openclaw-win 里的文件隔离。安装路径是否纯英文有没有空格。再点右上角重启。还不行就关闭 OpenClaw重新运行一键启动 exe。这个现象通常和模型通道无关而是本地服务没起来。不要在离线状态下去改 Base URL那样只会把变量越搞越多。还有一种情况是端口被占用。如果你同时开了多个 OpenClaw 实例或者旧进程没退干净新 Gateway 可能起不来。打开任务管理器结束旧的 OpenClaw 相关进程再重新启动。Windows 上这类问题比模型配置问题更常见先排除掉本地服务因素再来看通道。5.2 认证失败或 401Key 是不是没替换成 YOUR_API_KEY如果你把本文的占位符 YOUR_API_KEY 原样填进去了当然会认证失败。要在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentopenclaw_gateway_401 创建真实 Key 后替换。还要检查复制时有没有多空格、有没有换行。Key 错误一般发生在发指令时OpenClaw 界面可能只提示「认证失败」或「请求被拒绝」这时先换一把新 Key 试别去折腾模型 ID。如果你在别处用过同一把 Key确认它没有被删除或重置。控制台里能看到 Key 的状态和创建时间旧 Key 失效就新建一把。替换后保存重启 Gateway再发短指令验证。不要把 Key 写在会同步到公共仓库的配置文件里本地测试也尽量用占位符记录真实值单独保存。5.3 模型不存在或 404Base URL 多了 /v1模型 ID 抄错404 在本篇配置里最常见的原因是 Base URL 写成了 https://taotoken.net/api/v1。记住填 https://taotoken.net/api末尾不要 /v1。另一个原因是模型 ID 从别处抄了一个不存在的名字。去模型广场当时列表复制不要自己加日期后缀。改完保存重启 Gateway再发短指令验证。如果 Base URL 和模型 ID 都确认没错但日志里还是 404检查是不是把官网落地页粘进了接口地址。官网链接带查询参数是给人点击的不是给程序请求的。OpenClaw 的 Base URL 字段只认 https://taotoken.net/api 这种纯接口地址。5.4 指令发出去但停在执行中本地权限和文件路径如果模型有响应但 OpenClaw 执行到一半停住看日志里是不是文件权限不足。D 盘下载文件夹是否存在路径有没有中文杀软有没有拦截文件移动。OpenClaw 做本地自动化时模型只负责生成计划执行还是本地程序在做。把日志里的报错贴回对话让模型解释下一步而不是让它直接连你的生产环境。整理下载文件夹这种任务建议第一次先在测试目录里跑。还有一个容易忽略的点图片按拍摄日期分类依赖文件元数据。如果某些图片没有拍摄日期信息OpenClaw 可能会跳过或按修改日期处理。这不是通道问题而是本地文件属性问题。你可以先看几条日志确认它是在等模型响应还是已经进入文件操作阶段。6. 跑通后再决定模型对话、Coding Plan 还是多工具共用 Key6.1 同一把 Key 可以给多个工具但 Base URL 各填各的OpenClaw 跑通后你手里这把 Key 还能给别的 AI 编程工具用。原则是Key 统一在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentopenclaw_gateway_keys 创建Base URL 每个工具都填 https://taotoken.net/api。不要把官网落地页填进任何工具的 Base URL 字段。OpenClaw 用界面表单Claude Code 用环境变量或 settings.jsonCodex 用 config.toml各自格式不同但地址值保持一致。多工具共用 Key 时建议在备注里写清楚用途比如「OpenClaw 文件整理」「Claude Code 本地项目」。这样在控制台看用量时能区分是哪台机器、哪个工具在调用。不要把所有工具都塞进同一份配置文件OpenClaw 的 Gateway 配置和 Claude Code 的环境变量互不影响混在一起只会增加排障难度。6.2 如果后面接 Claude Code 或 Codex配置文件不要混Claude Code 走 Anthropic 兼容配置通常写在 ~/.claude/settings.json 的 env 里{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: YOUR_API_KEY, ANTHROPIC_MODEL: 以模型广场当时列表为准 } }Codex 走自己的 config.toml不要套 ANTHROPIC_ 变量model_provider taotoken model 以模型广场当时列表为准 [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY上面 Codex 片段只是字段位置示意实际以你本地版本要求为准。OpenClaw 的通道配置已经跑通再动别的工具时先小范围测试不要一次改三处。6.3 下一步先验证一次模型对话再决定要不要上 Coding Plan如果你只想确认 OpenClaw 这条通道稳定先去 TaoToken 模型对话 用同一把 Key 发一条测试消息看模型 ID 和 Base URL 是否对得上。如果后面你要把 OpenClaw、Claude Code、Codex 都接进来可以看 Coding Plan 是否适合你的用量新 Key 在 控制台 API Keys 创建。Claude Code 的环境变量对照可以看 接入文档。OpenClaw 这边先把「整理 D 盘下载文件夹图片」这条指令稳定跑几次再去加技能和联动比一上来堆一堆配置要稳。
