把 OpenClaw 部署完之后最容易被卡住的地方不是 npm 安装而是最后一步把模型 API 的 Key 和 base_url 写进~/.openclaw/config.json的 model 节点重启openclaw gateway之后发现网关起不来。大多数部署教程在这里默认让你去某个云厂商控制台创建 Key再把一套只有该平台认识的字段抄进配置字段一换就不知道怎么改。这篇就用 TaoToken 做统一兼容通道先在 TaoToken 上注册并创建 API Key复制页面给出的 Base URL然后把这两项写进 config.json重启 gateway让 OpenClaw 真正跑起来。1. 部署到最后一步OpenClaw 卡在 model 节点上1.1 原始部署链路走到哪一步会翻车打开原始部署教程时前五章通常是顺畅的安装 Node.js 22执行npm install -g openclaw跑openclaw onboard初始化放行服务器 18789 端口再openclaw gateway start。之后浏览器访问http://127.0.0.1:18789服务器上是公网 IP就能看到对话控制台。到这一步OpenClaw 本体其实已经装好了。麻烦从第六章开始。教程要求把模型 API 的 Key 和 base_url 手动写进~/.openclaw/config.json的 model 节点Windows 路径对应C:\Users\用户名\.openclaw\config.json。很多第一次接触配置文件的人到这里会直接复制教程里的 model 片段却没意识到type、api_key、secret、model_name这些字段跟自己在用的平台对不对得上。更隐蔽的问题是原教程给出的字段是某个平台特有的换一个模型服务商就要自己改字段名改不出结果服务就卡在这一步。1.2 为什么 Key 和 base_url 写错会让网关起不来OpenClaw 的 gateway 启动时会读取 config.json并在日志里记录模型节点是否可用。base_url 填错通常会有两种表现一是域名解析不了日志一直刷fetch failed或EAI_AGAIN二是把官网页面地址填了进去网关拿着网页地址去请求模型接口返回 HTML 而不是 JSON请求自然失败。api_key 填错则是另一套症状网关能正常起来但控制台发任何指令都返回401 Authentication Error。如果密钥权限没有开通OpenClaw 会按无权限处理呈现为“模型调用失败、权限不足”。所以实际部署里Key 和 base_url 从来不是两个独立参数它们共同决定网关能不能把自然语言指令转成一次有效的模型请求。两者只要一个不对前面部署再顺利控制台里也只能看到一个不停转圈的光标。1.3 直接把 model 节点交给 TaoToken我的做法是让 TaoToken 只承担一个职责给 OpenClaw 当统一兼容通道。你不用再关心某个云平台的type叫什么、secret填什么只需要在 TaoToken 官网拿一把 Key 和一个 Base URL填进 config.json 的 model 节点其它字段尽量保持原样。原文里“在阿里云百炼控制台创建 API Key”这一步在本文统一改为去 TaoToken 完成。这样你面对的始终是同一个地址格式OpenClaw 侧不需要为不同平台反复改结构。2. 在 TaoToken 创建 Key并记下接口地址2.1 打开官网完成注册并创建 API Key打开 TaoToken注册并登录之后进入控制台的 API Keys 页面点创建。创建成功后页面会给出一把 Key它通常只完整显示这一次建议立刻复制到本地笔记。返回列表后你还会看到这把 Key 的状态、权限按钮和用量入口。稍后在 config.json 里api_key就填这把 Key也就是把YOUR_API_KEY整段替换成刚复制的内容。不要跳过权限检查。如果控制台里显示这把 Key 未启用OpenClaw 能连上但请求会被拒绝报错样式和 Key 错误很接近。先把 Key 复制好、把状态确认好再往下走。2.2 区分官网地址和 Base URL同一个控制台页面或接入文档里会写清楚接口地址提示Base URL 是https://taotoken.net/api末尾没有/v1。这是填给 OpenClaw 的 model 节点用的不是给你在浏览器里手动访问的。官网落地页https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content是给人注册、创建 Key、看模型广场和用量用的https://taotoken.net/api是给程序请求用的。这两个地址不能混。很多人后面报 404 或fetch failed都是因为把官网地址填到了base_url字段里。2.3 到模型广场确认 model_namemodel_name是另一个容易踩坑的地方。不要从旧教程里顺手抄一个模型名TaoToken 的模型广场会列出当前可用的模型 ID。打开官网后进入模型广场复制你打算用的那个 ID 并保存。如果广场显示有更新以当时列表为准不要用旧教程里带年份日期的名字。这里多花十秒确认能省掉后面404 model not found的排查时间。注意模型 ID 也是配置的一部分它决定 OpenClaw 每次请求到底打到哪一个模型上。3. 把 config.json 的 model 节点改成 TaoToken 接入3.1 找到配置文件并备份先找到 config.json。macOS 和 Linux 在~/.openclaw/config.jsonWindows 在C:\Users\用户名\.openclaw\config.json。注意.openclaw是隐藏目录Windows 下可以在资源管理器地址栏输入完整路径打开。如果之前执行过openclaw onboard --reset配置文件可能会重新生成这时直接编辑它就行。改之前建议备份一次避免 JSON 写坏后整个配置无法恢复cp ~/.openclaw/config.json ~/.openclaw/config.json.bakWindows 上直接复制一份config.json命名为config.json.bak即可。备份之后怎么改都不会把原始配置弄丢。3.2 替换 model 节点用文本编辑器打开 config.json定位到model: {}节点。原来教程里的云厂商节点包含type、api_key、secret、model_name等字段使用 TaoToken 时type用 openai 兼容类型去掉secret改用base_url。参照下面的结构替换整个 model 节点{ model: { type: openai, api_key: YOUR_API_KEY, base_url: https://taotoken.net/api, model_name: 在这里粘贴模型广场的模型 ID, max_tokens: 2048, temperature: 0.7, timeout: 30, reasoning: false } }保存前做一次 JSON 检查确认是英文引号属性之间用英文逗号最后一个属性后面没有多余逗号。如果你原来的 config.json 里还有其他节点只替换 model 节点即可不要动gateway、skills等其它部分。改完顺手看一眼路径确保保存到了~/.openclaw/config.json而不是桌面上的另一个副本。3.3 重启 gateway 让配置生效保存后执行openclaw gateway restart如果 gateway 本来没有启动则执行openclaw gateway start执行后等两三秒再打开控制台发消息。OpenClaw 的 gateway 在启动阶段会读取配置、建立模型连接如果立刻发消息可能正好撞上初始化窗口出现“连接中”的假象。另外如果 OpenClaw 跑在云服务器上不要直接关掉终端否则进程会随 SSH 会话退出要长期挂在服务器上可以用nohup openclaw gateway start或配置系统服务。这一步不影响本次验证但值得记下来。4. 重启网关后验证 TaoToken 已经接通4.1 先确认 gateway 状态重启后先确认进程状态openclaw gateway status返回running才算正常起点。如果显示stopped不要急着重装先执行openclaw logs --follow看末尾的报错。常见的是fetch failed、401、404分别对应第 5 章提到的三种配置问题。注意这一步看日志能同时确认“网关有没有起来”和“模型请求有没有出去”是定位问题最快的入口。4.2 控制台发一条自然语言指令浏览器打开http://127.0.0.1:18789服务器部署时换成公网 IP在对话输入框发一条具体的指令例如“把当前目录下的文件列表整理成 Markdown 清单”。这条指令会从控制台进入 gateway再通过https://taotoken.net/api发一次模型请求拿到返回后显示在页面上。只要返回正常文本就说明 TaoToken 的 Key 已接通。如果只是转圈不出结果回到 config.json 检查base_url有没有写错、api_key有没有多余空格改完再openclaw gateway restart一次。不要在原配置上反复点发送那样只会重复同样的失败。4.3 用 tavily-search 验证技能链路如果按原始教程装了技能可以顺手把联网搜索也验证一遍openclaw skill restart tavily-search然后在控制台问一个需要实时信息的问题。技能请求同样经过 model 节点的base_url所以技能跑通比单纯对话更能证明网关链路是通的。如果搜索技能能返回带来源的结果说明这把 Key 不只是聊天可用技能发起的模型请求也正常。这一步对后面扩展其它技能很有参考价值因为技能报错时很多人第一反应是技能装错了实际往往是 model 节点没有真正接通。4.4 用日志确认请求打到了哪个地址上面几步都过了以后可以边发指令边看日志openclaw logs --follow日志里能看到请求进入 gateway 后模型请求发往哪个地址。如果地址是https://taotoken.net/api并返回 200就说明 Base URL 已经生效。如果日志里显示请求发往了其它地址说明 config.json 里可能还有第二处 model 配置覆盖了当前值。搜一下整个 config.json确认没有旧的base_url残留。5. config.json 写错地址后OpenClaw 的四种翻车现场5.1 网关起不来日志报 JSON 解析错误现象是openclaw gateway start之后进程几秒内退出openclaw gateway status显示stopped。先执行openclaw logs --follow如果日志显示 JSON 解析错误大概率是 config.json 多了逗号或者引号没有闭合。这时用备份恢复重新按第 3 章的 model 节点填写。如果手头没有备份可以执行openclaw onboard --reset重新生成配置再对照第 3 章改。注意--reset会把之前的技能列表、网关设置一起清掉执行前先确认没有需要保留的内容。这个重置动作对应原文里的“无法写入配置文件”场景也是零基础用户最容易反复折腾的地方。5.2 模型调用失败返回 401 Authentication Error现象是网关能起来但控制台发消息返回401 Authentication Error对应原文里“模型调用失败、权限不足”。先回到 TaoToken 的 API Keys 页面复制一把新的 Key确认 config.json 里api_key字段粘贴了完整字符串前后没有多余空格。如果 Key 已确认无误再看这把 Key 是否处于启用状态以及账号是否有可用额度。OpenClaw 不会把这两类错误区分得很清楚它在页面上都表现为“模型调用失败”。改动后保存文件执行openclaw gateway restart再回控制台试一次。注意不要在网页对话里反复重试而不看日志日志里的错误码比界面提示更准确。5.3 模型不存在返回 404 model not found现象是请求能发出去但返回404 model not found或类似提示。原因通常是model_name用了旧平台的模型名或自己拼了一个不存在的名称。回到模型广场复制当前列表里的模型 ID替换 config.json 里的model_name值后重启。不要使用带年份日期的猜测性名称比如在模型 ID 后面加版本号或日期模型是否可用以当时广场列表为准。如果多个模型都能用选一个你实际需要的填进去后保持稳定不要频繁切换否则下次排查时你会分不清是哪一次改动导致的问题。5.4 请求发不出去日志报 fetch failed 或 EAI_AGAIN日志里出现fetch failed、EAI_AGAIN、ENOTFOUND时先核对base_url。它必须是https://taotoken.net/api末尾不带/v1更不是官网地址。可以在终端执行下面的命令单独检查网络是否能到达接口curl -I https://taotoken.net/api如果 curl 返回异常再检查本地 DNS 或服务器安全组。如果 curl 正常而 OpenClaw 仍报fetch failed多半是 JSON 里base_url值带了不可见字符或多余空格重写这一行再重启。另一个容易忽略的点是不要把官网落地页链接复制到base_url那里面带了utm_source参数不是接口地址。6. 跑通后回到控制台对一下这次调用6.1 在 TaoToken 控制台确认调用有记录验证通过后回到 TaoToken 控制台看一眼这次调用的请求记录。OpenClaw 每发一条自然语言指令TaoToken 一侧都会产生对应记录你可以在用量页面看到模型名、时间和消耗。这一步不是为了记明细而是确认后续排查问题时有数据可对照网关起不来归网关Key 没计费归 Key两条线不混在一起。如果控制台里能看到刚才那条“把文件列表整理成 Markdown”的请求说明 OpenClaw 和 TaoToken 之间的链路已经完整闭合。后续再装新技能、换新模型都只需改model_name或调整max_tokens不需要重新对接地址。6.2 后续入口配置好之后如果还想在网页里快速试同一把 Key可以打开 TaoToken 模型对话 发一条测试消息长期跑 OpenClaw 的话Coding Plan 页面可以看按次计费是否更划算Key 的后续管理和权限调整在 API Keys 页面 完成。如果之后想把 Claude Code 也指到同一把 Key环境变量对照表在 Claude Code 接入文档 里按文档把 Base URL 和 Key 填进去即可OpenClaw 这边的用法不变。
OpenClaw 配 TaoToken：config.json 写入 Base URL 后启动网关
把 OpenClaw 部署完之后最容易被卡住的地方不是 npm 安装而是最后一步把模型 API 的 Key 和 base_url 写进~/.openclaw/config.json的 model 节点重启openclaw gateway之后发现网关起不来。大多数部署教程在这里默认让你去某个云厂商控制台创建 Key再把一套只有该平台认识的字段抄进配置字段一换就不知道怎么改。这篇就用 TaoToken 做统一兼容通道先在 TaoToken 上注册并创建 API Key复制页面给出的 Base URL然后把这两项写进 config.json重启 gateway让 OpenClaw 真正跑起来。1. 部署到最后一步OpenClaw 卡在 model 节点上1.1 原始部署链路走到哪一步会翻车打开原始部署教程时前五章通常是顺畅的安装 Node.js 22执行npm install -g openclaw跑openclaw onboard初始化放行服务器 18789 端口再openclaw gateway start。之后浏览器访问http://127.0.0.1:18789服务器上是公网 IP就能看到对话控制台。到这一步OpenClaw 本体其实已经装好了。麻烦从第六章开始。教程要求把模型 API 的 Key 和 base_url 手动写进~/.openclaw/config.json的 model 节点Windows 路径对应C:\Users\用户名\.openclaw\config.json。很多第一次接触配置文件的人到这里会直接复制教程里的 model 片段却没意识到type、api_key、secret、model_name这些字段跟自己在用的平台对不对得上。更隐蔽的问题是原教程给出的字段是某个平台特有的换一个模型服务商就要自己改字段名改不出结果服务就卡在这一步。1.2 为什么 Key 和 base_url 写错会让网关起不来OpenClaw 的 gateway 启动时会读取 config.json并在日志里记录模型节点是否可用。base_url 填错通常会有两种表现一是域名解析不了日志一直刷fetch failed或EAI_AGAIN二是把官网页面地址填了进去网关拿着网页地址去请求模型接口返回 HTML 而不是 JSON请求自然失败。api_key 填错则是另一套症状网关能正常起来但控制台发任何指令都返回401 Authentication Error。如果密钥权限没有开通OpenClaw 会按无权限处理呈现为“模型调用失败、权限不足”。所以实际部署里Key 和 base_url 从来不是两个独立参数它们共同决定网关能不能把自然语言指令转成一次有效的模型请求。两者只要一个不对前面部署再顺利控制台里也只能看到一个不停转圈的光标。1.3 直接把 model 节点交给 TaoToken我的做法是让 TaoToken 只承担一个职责给 OpenClaw 当统一兼容通道。你不用再关心某个云平台的type叫什么、secret填什么只需要在 TaoToken 官网拿一把 Key 和一个 Base URL填进 config.json 的 model 节点其它字段尽量保持原样。原文里“在阿里云百炼控制台创建 API Key”这一步在本文统一改为去 TaoToken 完成。这样你面对的始终是同一个地址格式OpenClaw 侧不需要为不同平台反复改结构。2. 在 TaoToken 创建 Key并记下接口地址2.1 打开官网完成注册并创建 API Key打开 TaoToken注册并登录之后进入控制台的 API Keys 页面点创建。创建成功后页面会给出一把 Key它通常只完整显示这一次建议立刻复制到本地笔记。返回列表后你还会看到这把 Key 的状态、权限按钮和用量入口。稍后在 config.json 里api_key就填这把 Key也就是把YOUR_API_KEY整段替换成刚复制的内容。不要跳过权限检查。如果控制台里显示这把 Key 未启用OpenClaw 能连上但请求会被拒绝报错样式和 Key 错误很接近。先把 Key 复制好、把状态确认好再往下走。2.2 区分官网地址和 Base URL同一个控制台页面或接入文档里会写清楚接口地址提示Base URL 是https://taotoken.net/api末尾没有/v1。这是填给 OpenClaw 的 model 节点用的不是给你在浏览器里手动访问的。官网落地页https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content是给人注册、创建 Key、看模型广场和用量用的https://taotoken.net/api是给程序请求用的。这两个地址不能混。很多人后面报 404 或fetch failed都是因为把官网地址填到了base_url字段里。2.3 到模型广场确认 model_namemodel_name是另一个容易踩坑的地方。不要从旧教程里顺手抄一个模型名TaoToken 的模型广场会列出当前可用的模型 ID。打开官网后进入模型广场复制你打算用的那个 ID 并保存。如果广场显示有更新以当时列表为准不要用旧教程里带年份日期的名字。这里多花十秒确认能省掉后面404 model not found的排查时间。注意模型 ID 也是配置的一部分它决定 OpenClaw 每次请求到底打到哪一个模型上。3. 把 config.json 的 model 节点改成 TaoToken 接入3.1 找到配置文件并备份先找到 config.json。macOS 和 Linux 在~/.openclaw/config.jsonWindows 在C:\Users\用户名\.openclaw\config.json。注意.openclaw是隐藏目录Windows 下可以在资源管理器地址栏输入完整路径打开。如果之前执行过openclaw onboard --reset配置文件可能会重新生成这时直接编辑它就行。改之前建议备份一次避免 JSON 写坏后整个配置无法恢复cp ~/.openclaw/config.json ~/.openclaw/config.json.bakWindows 上直接复制一份config.json命名为config.json.bak即可。备份之后怎么改都不会把原始配置弄丢。3.2 替换 model 节点用文本编辑器打开 config.json定位到model: {}节点。原来教程里的云厂商节点包含type、api_key、secret、model_name等字段使用 TaoToken 时type用 openai 兼容类型去掉secret改用base_url。参照下面的结构替换整个 model 节点{ model: { type: openai, api_key: YOUR_API_KEY, base_url: https://taotoken.net/api, model_name: 在这里粘贴模型广场的模型 ID, max_tokens: 2048, temperature: 0.7, timeout: 30, reasoning: false } }保存前做一次 JSON 检查确认是英文引号属性之间用英文逗号最后一个属性后面没有多余逗号。如果你原来的 config.json 里还有其他节点只替换 model 节点即可不要动gateway、skills等其它部分。改完顺手看一眼路径确保保存到了~/.openclaw/config.json而不是桌面上的另一个副本。3.3 重启 gateway 让配置生效保存后执行openclaw gateway restart如果 gateway 本来没有启动则执行openclaw gateway start执行后等两三秒再打开控制台发消息。OpenClaw 的 gateway 在启动阶段会读取配置、建立模型连接如果立刻发消息可能正好撞上初始化窗口出现“连接中”的假象。另外如果 OpenClaw 跑在云服务器上不要直接关掉终端否则进程会随 SSH 会话退出要长期挂在服务器上可以用nohup openclaw gateway start或配置系统服务。这一步不影响本次验证但值得记下来。4. 重启网关后验证 TaoToken 已经接通4.1 先确认 gateway 状态重启后先确认进程状态openclaw gateway status返回running才算正常起点。如果显示stopped不要急着重装先执行openclaw logs --follow看末尾的报错。常见的是fetch failed、401、404分别对应第 5 章提到的三种配置问题。注意这一步看日志能同时确认“网关有没有起来”和“模型请求有没有出去”是定位问题最快的入口。4.2 控制台发一条自然语言指令浏览器打开http://127.0.0.1:18789服务器部署时换成公网 IP在对话输入框发一条具体的指令例如“把当前目录下的文件列表整理成 Markdown 清单”。这条指令会从控制台进入 gateway再通过https://taotoken.net/api发一次模型请求拿到返回后显示在页面上。只要返回正常文本就说明 TaoToken 的 Key 已接通。如果只是转圈不出结果回到 config.json 检查base_url有没有写错、api_key有没有多余空格改完再openclaw gateway restart一次。不要在原配置上反复点发送那样只会重复同样的失败。4.3 用 tavily-search 验证技能链路如果按原始教程装了技能可以顺手把联网搜索也验证一遍openclaw skill restart tavily-search然后在控制台问一个需要实时信息的问题。技能请求同样经过 model 节点的base_url所以技能跑通比单纯对话更能证明网关链路是通的。如果搜索技能能返回带来源的结果说明这把 Key 不只是聊天可用技能发起的模型请求也正常。这一步对后面扩展其它技能很有参考价值因为技能报错时很多人第一反应是技能装错了实际往往是 model 节点没有真正接通。4.4 用日志确认请求打到了哪个地址上面几步都过了以后可以边发指令边看日志openclaw logs --follow日志里能看到请求进入 gateway 后模型请求发往哪个地址。如果地址是https://taotoken.net/api并返回 200就说明 Base URL 已经生效。如果日志里显示请求发往了其它地址说明 config.json 里可能还有第二处 model 配置覆盖了当前值。搜一下整个 config.json确认没有旧的base_url残留。5. config.json 写错地址后OpenClaw 的四种翻车现场5.1 网关起不来日志报 JSON 解析错误现象是openclaw gateway start之后进程几秒内退出openclaw gateway status显示stopped。先执行openclaw logs --follow如果日志显示 JSON 解析错误大概率是 config.json 多了逗号或者引号没有闭合。这时用备份恢复重新按第 3 章的 model 节点填写。如果手头没有备份可以执行openclaw onboard --reset重新生成配置再对照第 3 章改。注意--reset会把之前的技能列表、网关设置一起清掉执行前先确认没有需要保留的内容。这个重置动作对应原文里的“无法写入配置文件”场景也是零基础用户最容易反复折腾的地方。5.2 模型调用失败返回 401 Authentication Error现象是网关能起来但控制台发消息返回401 Authentication Error对应原文里“模型调用失败、权限不足”。先回到 TaoToken 的 API Keys 页面复制一把新的 Key确认 config.json 里api_key字段粘贴了完整字符串前后没有多余空格。如果 Key 已确认无误再看这把 Key 是否处于启用状态以及账号是否有可用额度。OpenClaw 不会把这两类错误区分得很清楚它在页面上都表现为“模型调用失败”。改动后保存文件执行openclaw gateway restart再回控制台试一次。注意不要在网页对话里反复重试而不看日志日志里的错误码比界面提示更准确。5.3 模型不存在返回 404 model not found现象是请求能发出去但返回404 model not found或类似提示。原因通常是model_name用了旧平台的模型名或自己拼了一个不存在的名称。回到模型广场复制当前列表里的模型 ID替换 config.json 里的model_name值后重启。不要使用带年份日期的猜测性名称比如在模型 ID 后面加版本号或日期模型是否可用以当时广场列表为准。如果多个模型都能用选一个你实际需要的填进去后保持稳定不要频繁切换否则下次排查时你会分不清是哪一次改动导致的问题。5.4 请求发不出去日志报 fetch failed 或 EAI_AGAIN日志里出现fetch failed、EAI_AGAIN、ENOTFOUND时先核对base_url。它必须是https://taotoken.net/api末尾不带/v1更不是官网地址。可以在终端执行下面的命令单独检查网络是否能到达接口curl -I https://taotoken.net/api如果 curl 返回异常再检查本地 DNS 或服务器安全组。如果 curl 正常而 OpenClaw 仍报fetch failed多半是 JSON 里base_url值带了不可见字符或多余空格重写这一行再重启。另一个容易忽略的点是不要把官网落地页链接复制到base_url那里面带了utm_source参数不是接口地址。6. 跑通后回到控制台对一下这次调用6.1 在 TaoToken 控制台确认调用有记录验证通过后回到 TaoToken 控制台看一眼这次调用的请求记录。OpenClaw 每发一条自然语言指令TaoToken 一侧都会产生对应记录你可以在用量页面看到模型名、时间和消耗。这一步不是为了记明细而是确认后续排查问题时有数据可对照网关起不来归网关Key 没计费归 Key两条线不混在一起。如果控制台里能看到刚才那条“把文件列表整理成 Markdown”的请求说明 OpenClaw 和 TaoToken 之间的链路已经完整闭合。后续再装新技能、换新模型都只需改model_name或调整max_tokens不需要重新对接地址。6.2 后续入口配置好之后如果还想在网页里快速试同一把 Key可以打开 TaoToken 模型对话 发一条测试消息长期跑 OpenClaw 的话Coding Plan 页面可以看按次计费是否更划算Key 的后续管理和权限调整在 API Keys 页面 完成。如果之后想把 Claude Code 也指到同一把 Key环境变量对照表在 Claude Code 接入文档 里按文档把 Base URL 和 Key 填进去即可OpenClaw 这边的用法不变。