1. OpenClaw 装完却卡在模型通道settings.json 到底该填什么OpenClaw小龙虾本地安装跑通之后很多人会停在同一个地方Gateway 显示在线界面也能打开但一发指令就报模型不可用。原因通常不在 OpenClaw 本身而在模型通道没配好——也就是settings.json里的接口地址、Key、模型 ID 这三样东西没对齐。这篇就聚焦这个环节面向已经装好 OpenClaw、但卡在 Key 与接口地址填写的开发者给出一份可直接复制的settings.json骨架逐字段说明再用一条 curl 验证通道是否真的连通。先说清楚 OpenClaw 是什么、能做什么、适合谁。OpenClaw 是一个本地运行的智能体客户端它把「对话 工具调用 文件读写 键鼠模拟」打包成一个可视化程序你输入自然语言指令它拆解任务并调用本机能力去执行。适合想在自己电脑上跑自动化任务、又不想从零写 Agent 框架的人。它本身不生产模型能力模型能力来自你配置的模型通道所以通道配置是它能不能干活的分水岭。我见过最多的误区是把 OpenClaw 当成「装完即用」的软件。实际上安装包内置的额度只能让你体验基础功能一旦你要长期用、要换模型、要控制成本就必须自己接一个稳定的模型通道。而 OpenClaw 的通道配置入口就是工作目录下的settings.json。这个文件决定了它向哪个地址发请求、用哪个 Key 鉴权、默认调哪个模型。为什么推荐用 TaoToken 统一 Key 来接因为 OpenClaw 支持多模型切换如果你每个模型都去单独申请 Key、单独记地址配置文件会变得又乱又难维护。统一 Key 的好处是一个 Key 覆盖多个模型地址只写一个 Base URL模型 ID 按需切换。对本地部署场景来说这能省掉大量来回改配置的时间。下面进入实操。整篇会按「前置准备 → 可复制配置 → 验证请求 → 报错排查 → 收尾」的顺序走每一步都给到能直接用的内容。你不需要懂 OpenClaw 的源码只要会改一个 JSON 文件、会跑一条 curl 命令就行。2. 接入前的前置准备TaoToken 统一 Key 与 Base URL 怎么拿在动settings.json之前先把两样东西准备好统一 Key 和 Base URL。这两样是配置文件的灵魂填错了后面全白搭。先拿 Key。打开 TaoToken 控制台进入 API Keys 页面创建一个新 Key。创建时建议给它起个能认出来的名字比如openclaw-local方便以后区分是哪个客户端在用。创建完成后立刻复制保存因为多数平台只在创建时完整显示一次。这个 Key 就是你后面填进settings.json的apiKey字段值。再确认 Base URL。TaoToken 的 API 地址是https://taotoken.net/api注意这里不要加任何多余的路径后缀也不要带查询参数。OpenClaw 在发请求时会自己拼接/v1/chat/completions这类路径你只需要给它一个干净的根地址。很多人报 404就是因为把 Base URL 写成了带/v1的完整路径结果拼出来变成/v1/v1/...。模型 ID 也要提前想好。OpenClaw 的settings.json里通常有一个默认模型字段你需要填一个 TaoToken 支持的模型 ID。具体支持哪些模型可以在控制台的模型列表或接入文档里查。建议先选一个通用对话模型做验证跑通之后再换成你日常主力模型。这里插一句关于额度和计费的说明。TaoToken 是按实际调用量计费的你可以在控制台看到用量明细。对本地部署的 OpenClaw 来说建议先小额验证确认通道通了、模型响应正常再放心跑批量任务。不要一上来就挂一个长时间循环任务那样出问题不好定位。还有一点容易被忽略网络环境。OpenClaw 本地运行请求要发到 TaoToken 的 API 地址所以你的机器要能正常访问这个地址。如果你所在网络对出站请求有限制先在浏览器或 curl 里确认能通再去配 OpenClaw。这一步能帮你排除掉一半「配置没错但就是不通」的情况。准备好 Key、Base URL、模型 ID 这三样就可以进入下一步改配置文件了。建议把这三样先记在一个临时文本里等配置写完再删掉避免中途来回翻控制台。3. 可复制 settings.json 骨架统一 Key 与 API 地址逐字段说明现在进入核心环节。OpenClaw 的模型通道配置写在settings.json里文件位置通常在你的 OpenClaw 工作目录下比如D:\OpenClaw\settings.json或E:\AI\OpenClaw\settings.json。如果你找不到可以在 OpenClaw 主界面的设置里看「配置目录」或者直接在安装目录搜索settings.json。下面是一份可直接复制的骨架。注意这是 JSON 格式不能写注释所以字段说明我放在代码块外面讲。{ model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken统一Key, modelId: 你的默认模型ID, timeout: 60000, maxRetries: 2 }, gateway: { host: 127.0.0.1, port: 18789 }, agent: { defaultMode: auto, language: zh-CN } }逐字段说明。provider填openai-compatible因为 TaoToken 的接口兼容 OpenAI 的请求格式OpenClaw 用这个 provider 就能正确构造请求。baseUrl填https://taotoken.net/api这是根地址不要加/v1。apiKey填你刚才创建的统一 Key注意保留sk-前缀如果你的 Key 有的话不要多空格、不要换行。modelId填你要用的模型 ID这个值必须和 TaoToken 支持的模型名完全一致大小写敏感。timeout是请求超时时间单位毫秒本地网络一般 60000 够用如果你跑的是长输出任务可以调到 120000。maxRetries是失败重试次数填 2 比较稳妥填太多会在网络抖动时反复重试拖慢响应。gateway段是 OpenClaw 本地服务的监听地址和端口一般不用改。如果你本机 18789 端口被占用可以改成别的但改完要重启 OpenClaw 才生效。agent段是智能体行为配置defaultMode填auto表示自动模式language填zh-CN让界面和回复优先中文。改完保存时注意编码。JSON 文件要用 UTF-8 无 BOM 保存用记事本改的话容易带上 BOM导致 OpenClaw 解析失败。建议用 VS Code 或 Notepad 改保存时确认编码是 UTF-8。改完先别急着启动可以用一个在线 JSON 校验工具贴进去检查格式确认没有多余逗号、没有漏引号。如果你之前已经有一份settings.json不要整个覆盖而是把model段替换成上面的内容保留你原有的gateway和agent配置。这样能避免把你之前调好的其他设置冲掉。改之前建议先备份一份命名成settings.json.bak出问题能快速回滚。配置写完后重启 OpenClaw。重启方式可以是关掉程序再打开也可以在界面右上角点「重启」。重启后观察 Gateway 状态如果显示在线说明本地服务起来了但模型通道是否通还要靠下一步的 curl 验证。4. 一条 curl 验证通道连通确认 Key 与地址真的能用配置文件写对了不代表请求一定能通。最可靠的验证方式是绕过 OpenClaw直接用 curl 打一次 TaoToken 的接口。这样能把「OpenClaw 配置问题」和「通道本身问题」分开定位效率高很多。打开终端Windows 用 PowerShell 或 CMDmacOS/Linux 用 Terminal执行下面这条命令。把sk-你的Key和你的模型ID替换成实际值curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的Key \ -d { model: 你的模型ID, messages: [ {role: user, content: 只回复两个字通了} ], max_tokens: 16 }这条命令做了几件事向https://taotoken.net/api/v1/chat/completions发一个 POST 请求带上Authorization: Bearer头做鉴权请求体里指定模型和一条测试消息max_tokens限制成 16 避免浪费额度。如果通道正常你会收到一段 JSON结构里包含choices数组choices[0].message.content就是模型的回复应该能看到「通了」两个字。看到这个说明 Key 有效、地址正确、模型 ID 可用三样都对。如果返回 401说明鉴权失败重点检查 Key 是否复制完整、有没有多余空格、Bearer后面有没有留空格。如果返回 404多半是地址写错了确认你用的是https://taotoken.net/api/v1/chat/completions而不是少了/v1或多了别的路径。如果返回 400通常是请求体格式问题检查 JSON 有没有写错模型 ID 是否拼错。curl 通了之后回到 OpenClaw 再发一条指令测试。如果 OpenClaw 里还是报模型不可用那问题就在settings.json的字段上而不是通道本身。这时候对照第 3 节的字段说明重点看baseUrl有没有多写/v1、apiKey有没有引号包错、modelId是否和 curl 里用的一致。实测下来curl 验证这一步能省掉大量来回猜的时间。很多人一上来就在 OpenClaw 界面里试报错了也不知道是配置问题还是通道问题来回改配置反而越改越乱。先用 curl 把通道确认死再回头调 OpenClaw思路会清晰很多。验证通过后建议把这条 curl 命令存成一个脚本文件比如check.sh或check.ps1以后换 Key、换模型时先跑一遍确认通道没问题再动 OpenClaw 配置。这是个很实用的小习惯。5. 常见报错排查401、local proxy failed、reading choices 怎么解配置过程中会遇到几类典型报错这里逐个拆解对照你的实际报错来定位。第一类401 Unauthorized。这是鉴权失败出现位置可能是 curl也可能是 OpenClaw 日志。排查顺序是先确认 Key 有没有复制完整很多 Key 很长复制时容易漏掉尾部几个字符再确认Authorization头格式是Bearer sk-xxxBearer和 Key 之间是一个空格最后确认这个 Key 在 TaoToken 控制台里是启用状态没有被删除或禁用。如果 curl 也报 401那问题一定在 Key 上和 OpenClaw 无关。第二类local proxy failed。这个报错通常出现在 OpenClaw 启动或发请求时意思是本地代理层没能把请求转发出去。常见原因是settings.json里baseUrl写成了本地地址或者gateway端口和实际监听端口不一致。检查baseUrl是不是https://taotoken.net/api检查gateway.port有没有被你改过但没重启。还有一种情况是本机防火墙拦了 OpenClaw 的出站请求可以临时关掉防火墙测试确认后再加白名单。第三类reading choices 相关报错比如cannot read property choices of undefined或reading choices failed。这类错误的本质是OpenClaw 收到了响应但响应结构里没有choices字段它去读就报错了。原因通常是接口返回了错误信息而不是正常结果比如返回了{error: {...}}。这时候要去看完整响应内容而不是只看报错。可以在 OpenClaw 日志里找原始响应或者用第 4 节的 curl 复现看返回的 JSON 到底是什么。多数情况是模型 ID 写错或者请求被限流返回了错误结构。第四类OAuth 相关报错。如果你在配置里误开了某些需要 OAuth 的 providerOpenClaw 会尝试走 OAuth 流程然后失败。解决方法是确认provider填的是openai-compatible不要填成需要 OAuth 的类型。TaoToken 走的是 API Key 鉴权不需要 OAuth所以配置里不应该出现 OAuth 相关字段。第五类超时。表现为请求发出去很久没响应最后报 timeout。先确认timeout字段够大再确认网络能正常访问 TaoToken 地址。如果 curl 很快返回但 OpenClaw 超时可能是 OpenClaw 的 Gateway 卡住了重启一下试试。排查时有个通用原则先用 curl 确认通道再看 OpenClaw 日志最后对照settings.json字段。顺序不要乱乱了就会在多个可能原因之间反复横跳。另外OpenClaw 的日志按钮在界面右上角点开能看到最近的请求和错误这是排查的第一手资料。如果你用的是 CC Switch、Cline MCP 或 Codex 这类工具配置逻辑是一样的都要写全三件套Base URL、Key、Model ID。Base URL 用https://taotoken.net/apiKey 用统一 KeyModel ID 按需填。三样缺一不可少一样就会报鉴权或模型错误。6. 配置跑通之后把统一 Key 用在长期编码与 Agent 任务上通道跑通、curl 验证通过、OpenClaw 能正常发指令之后你就可以把这套配置用在长期任务上了。统一 Key 的价值在这里才真正体现出来你不需要为每个模型单独维护配置换模型只改modelId一个字段地址和 Key 都不动。如果你打算把 OpenClaw 用于长期编码或 Agent 自动化建议去了解一下 Coding Plan。它面向的就是这种持续调用场景比按次零散调用更适合有稳定需求的开发者。配置方式和你现在做的一样还是 Base URL Key Model ID 三件套只是套餐形态不同。日常使用中建议定期去控制台看用量确认没有异常调用。如果发现某个任务消耗特别大可以回到settings.json把modelId换成更经济的模型或者调整maxRetries减少重试带来的额外消耗。这些微调不需要改代码改配置重启即可。最后留一个实用习惯每次改完settings.json先跑一遍第 4 节的 curl再启动 OpenClaw。这个顺序能让你在配置阶段就把问题挡掉而不是等 OpenClaw 报错再回头查。配置文件和验证命令都存好换机器、重装系统时直接复用几分钟就能恢复工作环境。