OpenClaw v2.7.9 用虾壳云一键部署包装好、右上角显示「Gateway 在线」之后,大部分人会在主界面底部敲下第一句指令,然后发现它不动。装包解决的是手脚问题,模型通道才是大脑,这一步可以交给 TaoToken 来完成:在控制台创建一把 Key,把 Base URL 填成 https://taotoken.net/api,OpenClaw 才会真的去整理你的 D 盘下载文件夹。
原文的落地攻略把九成篇幅给了部署动作:下载约 45.8MB 的 Openclaw-Windows-2.7.9.zip、临时关掉 360 与 Windows Defender、用 7-Zip 而不是系统自带解压、双击那个红色龙虾图标的启动程序、在「Windows 已保护你的电脑」弹窗里点「更多信息」再点「仍要运行」、挑一个纯英文路径、等自动部署跑完。这些做完,本地服务确实活着,但它还只是一个会点鼠标的空壳。本篇只补它缺的那一环:让 OpenClaw 拿到一条可用的模型通道。
整个接入可以按三段时间去估:装包与确认 Gateway 在线占掉一半,去控制台拿 Key 与模型 ID 两分钟,剩下的都花在模型配置页上——填三个字段、保存、重启服务。全程不碰命令行,不改系统环境变量,也不用额外装运行库。
1. Gateway 在线却不动:OpenClaw 缺的是模型通道
1.1 一键部署包装的是手脚,不是大脑
OpenClaw 在圈子里被叫做「养虾」,定位是接管家里的电脑:读文件、分类图片、开浏览器、把结果塞进 Excel。这些动作靠本地执行层完成,一键部署包会把执行层需要的一切依赖打包进去,包括后台那个 Gateway 服务。你在主界面右上角看到的「Gateway 在线」,说的就是执行层已经就绪、随时听候差遣。
问题在于执行层听不懂人话。「整理 D 盘下载文件夹」这七个字,要变成先列目录、再读创建时间、按月份建文件夹、逐个移动文件这一串步骤,中间必须有模型来做理解与规划。一键包里没有模型,也没有配套密钥,所以你敲下指令之后,Gateway 收到一段它处理不了的文本,界面转一圈就没下文了。
1.2 多把 Key 换来换去,不如收敛成一条通道
模型这一环最容易踩的坑,是手上同时握着好几个平台的密钥:有的只够跑几天,有的只开放某几个模型,想换一个更擅长长任务的模型还得改配置。而 OpenClaw 的模型配置页只有一份,你不可能同时填三套进去轮流用,每次切换都要重新保存、重启服务,跑到一半断掉很常见。
把这一环交给 TaoToken 会省事不少:它是统一 API 入口,Base URL 与 Key 的填法固定,想换模型只改一个模型 ID,不用重新申请通道、不用重装依赖。对经常跑长任务的场景,比如遍历几百个文件做汇总,这种收敛比多平台轮换更稳。下面按顺序把这套配置落进 OpenClaw。
2. 先把 OpenClaw 装到右上角显示 Gateway 在线
2.1 关掉防护、用 7-Zip 解压、路径别带中文
解压之前,先把安全软件全部退出:360 安全卫士、腾讯电脑管家、火绒、Windows Defender 的实时防护都要关。原因不神秘,OpenClaw 要模拟键鼠、批量读写文件,这些行为在杀软的规则库里跟风险程序长得很像,一旦被拦截,核心文件进了隔离区,安装会在半路断掉。等整套跑通确认没问题,再决定要不要把安装目录加进白名单。
解压这一步别偷懒用系统自带的工具,组件丢失是常有的事。装一个 7-Zip 或 WinRAR,右键那个 zip 选「解压到当前文件夹」,等它生成 Openclaw-win 文件夹,里面能找到带红色龙虾标识的启动程序。
安装路径是另一个硬条件:只能英文,不能有中文、空格、特殊符号。D:\OpenClaw这种就很好,D:\我的软件\数字员工这类路径会在部署阶段直接报错。磁盘至少留 1.6GB,构建依赖时会生成临时缓存,空间太紧一样会失败。
2.2 首次启动的初始化等待,属于正常现象
双击启动程序后,如果弹出「Windows 已保护你的电脑」,点「更多信息」再点「仍要运行」,就能进安装界面。之后是自动化流程:环境检测、依赖安装、服务部署、配置生成、桌面快捷方式创建,大概三到五分钟,中间不要关窗口,进程中断就得重来。
第一次启动会慢,因为 Gateway 要做完整初始化,等一到三分钟很正常,第二次打开就快了。判断标准只有一个:右上角出现「Gateway 在线」。看到这四个字再往下做模型配置,顺序反了容易白折腾——服务还没起来就改配置,改完也不知道到底哪一步生效了。
3. 在控制台创建 Key,记住 Base URL 和模型 ID
3.1 注册之后创建一把 API Key
打开 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 注册并登录,进 TaoToken 控制台找到 API Keys 页面,新建一把 Key,复制出来的那串字符就是要填进 OpenClaw 的东西。它在本文所有示例里都以YOUR_API_KEY的形式出现,你自己那串别发到群里,也别写进公开仓库。
复制之后先存到本地记事本。Key 在页面上通常只完整显示一次,关掉就得重新生成。虽然不算大事,但调试到一半发现没存下来,心情会很不舒服。顺手把创建时间也记一下,后面排查调用记录时能对上号。
3.2 Base URL 和模型 ID 分别看哪里
Base URL 是固定的:https://taotoken.net/api,注意末尾不要带/v1。不少教程会在结尾补一段版本路径,那是给别的工具留的写法,OpenClaw 这里多填一段就是找不到接口,请求发出去直接被拒。
模型 ID 不用背,去模型广场看当时的列表。同一个通道下模型会增删,写死的 ID 过一阵可能失效。你只需记下当下要用那个模型的名字,原样抄进 OpenClaw,别自己补日期后缀、别猜命名规律。拿不准就用默认推荐的对话模型,先把链路跑通,再换更擅长长任务的。
4. 把统一通道填进 OpenClaw 模型配置页
4.1 Base URL 填 https://taotoken.net/api,末尾不要 /v1
进 OpenClaw 主界面的设置,找模型服务或模型通道那一栏,先把服务地址填上。这一步是整个接入里最容易错的地方:地址必须是https://taotoken.net/api,不要写成官网页面,也不要顺手在末尾敲上/v1。判断方法很直接——这个地址是给程序发请求的,不是给人点开看的,浏览器里打开它返回什么并不重要,重要的是配置里字符一个不差。
注意:注册、创建 Key、看模型列表都在
https://taotoken.net那一侧完成,填进工具的地址只有https://taotoken.net/api这一种写法,两者不要混着抄。
4.2 Key 与模型 ID 的字段对照
三个字段按下面这张表填,建议顺序是地址、Key、模型:
| 配置项 | 填写内容 | 说明 |
|---|---|---|
| 服务地址 / Base URL | https://taotoken.net/api | 末尾不带/v1,不带任何查询参数 |
| API Key | YOUR_API_KEY | 换成你在控制台创建的那串 |
| 模型 ID | 以模型广场当时列表为准 | 原样复制,别加后缀、别改大小写 |
填完先别急着关页面。有些版本的配置项要手动点一次保存,切走再回来确认字段还在,避免重启之后被打回默认值,那就等于白填。
4.3 保存配置后重启 Gateway
配置写进去是一回事,正在运行的 Gateway 读到新值又是另一回事。多数情况下保存之后需要点一下重启 Gateway,或者干脆退出程序重开,让服务重新建立与通道的连接。重启后再次确认右上角「Gateway 在线」,这时候的在线跟之前的在线不一样——它已经握着一条能用的模型通道了。
如果重启后状态迟迟不上线,先回配置页确认三项有没有丢,再看安装路径里有没有特殊符号,不要急着重装。重装能解决九成问题,但那九成里有八成是配置没保存导致的,重装反而把问题掩盖了。
5. 用「整理 D 盘下载文件夹」验证通道
5.1 先发一条范围最小的指令
验证别一上来就丢大任务。先挑一个文件不多、结构简单的文件夹,例如:整理 D 盘下载文件夹内的图片文件,按创建日期新建分类文件夹存放。这类指令包含目标目录、筛选条件、动作三要素,模型容易解析,出错了也容易判断是配置问题还是表述问题。
发送后观察两件事:Gateway 状态是否仍在线,界面有没有出现执行步骤或日志。如果它有反应但方向不对,说明通道通了,是表述需要调整;如果完全没动静,直接翻到下一节看报错对照,别在原地反复发同一句话。
5.2 回控制台对一次调用记录
让数字员工真正跑过一条指令之后,回到控制台看这次请求有没有记上账。这一步比盯着界面猜有用得多:调用记录里能看到用的哪个模型、什么时候发的、有没有报错。如果记录是空的,说明请求根本没出本地,问题在 OpenClaw 侧;如果记录里有失败,错误信息基本能直接指向 Key 还是地址的问题。
想先用同一把 Key 单独试一次模型是否可用,可以打开 TaoToken 模型对话 发一条测试消息,确认模型 ID 拼写无误,再把同一个 ID 填回 OpenClaw。这一步能把「模型名写错」和「配置没生效」两类问题彻底分开。
6. OpenClaw 接通道后的报错对照
6.1 Gateway 在线,指令发出去却没动静
这是原文里出现过的那类现象,只是原因不同。部署阶段的 Gateway 离线,多半是防护软件拦了服务;接入阶段的「在线但不动」,先去看模型配置页的三项是否完整。地址、Key、模型 ID 任意一项为空,Gateway 会正常显示在线,但收到指令后没有任何可用的推理结果,界面看起来就像卡住了。
排查顺序:先确认保存动作生效,再确认服务重启过。两项都做过还是不响应,把模型 ID 换成模型广场里最普通的对话模型试一次,排除模型本身不可用的可能。
6.2 提示鉴权失败或 Key 无效
这类提示通常出现在调用记录里,界面可能只显示一句「执行失败」。原因不外乎三种:Key 复制时漏了尾部字符、Key 被删除或重置、Key 前后多了空格。重新去 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 的控制台看这把 Key 的状态,必要时新建一把替换掉,替换后记得再重启一次 Gateway。
提示:从网页复制 Key 时,双击选中再复制比拖拽选择更稳,拖拽很容易漏掉最后一个字符。
6.3 地址尾部多了 /v1 或配置被还原
请求直接发不出去、或者报找不到接口,多数是地址写成了https://taotoken.net/api/v1。去掉尾部那段,只保留https://taotoken.net/api。另一种情况是重启后配置回到默认值,说明保存没有真正落盘,重新填一遍并确认页面提示已保存即可。
这两种问题都不会影响 Gateway 的状态显示,所以别看右上角那四个字判断,要看调用记录。
7. 跑顺之后:用量、模型广场和下一步
7.1 原文那几条指令现在都能跑了
通道接通之后,原文里那批自动化指令就可以正式用起来:整理下载文件夹里的图片按日期归档、打开浏览器检索行业资讯汇总成 Excel 存到桌面、遍历桌面 Word 文档提取内容生成汇总表、清理缓存并整理桌面文件。指令描述得越具体,执行精度越高,这一点跟原文说的一致。
区别在于,这些任务现在有了模型做拆解,遇到文件夹结构复杂、文件名不规范的场景,它会自己调整步骤,而不是停在那里等你手动补。
7.2 看用量、换模型与后续入口
跑过几条任务之后,回控制台看一次用量,心里就有数了:一次文件整理消耗多少、长任务和短任务差多少。要长期让数字员工干活,可以打开 Coding Plan 看套餐是否够用;Key 不够用或要分环境管理,就在 控制台 API Keys 里新建。同一把 Key 之后想接 Claude Code 跑命令行任务,环境变量的对照写法在 接入文档 里,配置项跟 OpenClaw 是两套,别互抄。