1. 远程 Docker 里的 OpenClaw为什么模型调用总是接不通OpenClaw 在远程服务器上用 Docker 跑起来之后很多人会卡在同一个地方控制台能打开、网关状态也显示正常但一发对话就报模型不可用、鉴权失败或者请求超时。这个现象在自部署 AI 工具里非常典型因为容器内的 OpenClaw 只是把「壳」装好了真正负责推理的模型通道还没接上。这篇是龙虾养成笔记的第二篇专门解决安装完成之后的模型接入环节。适合已经在远程服务器上用 Docker 部署过 OpenClaw、能进控制台但还没打通模型调用的用户。核心思路是用 TaoToken 的统一 Key 作为模型出口把 config.toml 和 settings.json 两个配置文件填对再用一次真实对话请求验证整条链路。需要先明确一点OpenClaw 本身不产出模型能力它更像一个调度中枢把你在界面上的输入转发给背后的模型服务。所以「装好了」和「能对话」之间差的就是这段转发配置。下面按顺序给出可复制的骨架和填写位置你照着替换自己的 Key 就能用。2. 接入前先在 TaoToken 拿到统一 Key 和 API 地址TaoToken 在这里扮演的角色是统一模型入口。你不需要在 OpenClaw 里分别配置多家模型的地址和密钥而是拿一个统一 Key让 OpenClaw 把请求发到同一个 API 通道由它去分发。对自部署用户来说好处是配置项少、换模型时不用改一堆地方。操作路径很直接打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册登录后进入控制台在 API Keys 页面创建一个新 Key。创建时建议给它起一个能识别的名字比如 openclaw-remote方便以后在多个自部署工具之间区分。创建完成后你会拿到两样东西一个是 Key 字符串通常以固定前缀开头另一个是 API 基础地址也就是 https://taotoken.net/api 。这两个值后面要分别填进 OpenClaw 的配置文件。Key 只显示一次复制后先存到安全的地方别直接贴在公开的聊天记录里。注意API 地址填 https://taotoken.net/api 即可不要自己拼接多余的路径后缀OpenClaw 会按标准协议去补全。如果你还没创建 Key可以直接走这个入口https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。拿到 Key 之后先别急着改配置下一步我们先确认容器里的 OpenClaw 版本和配置目录位置避免改错文件。3. 可复制配置config.toml 与 settings.json 骨架OpenClaw 的模型接入配置分散在两个文件里。config.toml 负责网关和模型提供方的声明settings.json 负责运行时读取的具体参数。两个文件都要改缺一个都会导致调用失败。先进入容器docker exec -it openclaw_hjxu bash确认配置目录通常在用户主目录下的 .openclaw 里ls -la ~/.openclaw/你应该能看到 config.toml 和 settings.json。如果只有其中一个说明初始化没跑完先执行一次 openclaw gateway restart 让它生成默认文件。3.1 config.toml 的模型段骨架用编辑器打开 config.toml找到或新增 models 相关段落。下面是一个可复制的骨架把 api_key 和 base_url 换成你自己的[gateway] bind lan [models.default] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoTokenKey model gpt-4o-mini [models.default.params] temperature 0.7 max_tokens 2048这里 provider 用 openai-compatible 是因为 TaoToken 的 API 通道兼容标准协议OpenClaw 能直接识别。base_url 一定填 https://taotoken.net/api 不要带结尾斜杠。model 字段填你想用的模型名先填一个通用的即可后面验证通过再换。3.2 settings.json 的运行时骨架settings.json 管的是运行时行为重点是让 OpenClaw 知道去读哪个模型配置、超时设多久。骨架如下{ model: { default: default, requestTimeout: 60, retry: { enabled: true, maxAttempts: 2 } }, gateway: { controlUi: { allowInsecureAuth: true, allowedOrigins: [http://你的服务器IP:18789] } } }requestTimeout 设 60 秒是给远程调用留余量网络抖动时不至于立刻失败。retry 打开后偶发的连接问题会自动重试一次。allowedOrigins 里的 IP 换成你服务器的实际地址端口对应容器内的 18789。两个文件改完后重启网关让配置生效openclaw gateway restart openclaw gateway status状态里出现 0.0.0.0 监听就说明网关起来了。这一步和笔记一里的局域网配置是衔接的如果你之前已经配过 bind 和 allowedOrigins这里只需要补模型段。4. 验证请求发一次真实对话确认链路可用配置改完不代表能用必须发一次真实请求。有两种验证方式建议都做一遍。第一种是在容器内用命令行直接打一次模型请求绕过界面能最快定位是配置问题还是界面问题curl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoTokenKey \ -H Content-Type: application/json \ -d { model: gpt-4o-mini, messages: [{role: user, content: 回复两个字通了}] }如果返回里带 choices 字段和正常内容说明 Key 和 API 地址没问题问题只可能在 OpenClaw 的配置读取上。如果这里就报 401说明 Key 复制错了或者被禁用报 404 多半是 base_url 拼错。第二种是在 OpenClaw 控制台里发一条消息。浏览器打开 http://你的服务器IP:38789 用 openclaw dashboard 拿到的 token 登录然后在对话框输入任意内容。能正常返回就说明整条链路打通了。实测下来最容易出问题的是 settings.json 里的 default 字段和 config.toml 里的 models 段名字对不上。前者写 default后者就必须有 [models.default]大小写和拼写都要一致。对不上时界面不报配置错误只在发消息时提示模型不存在很容易误判成网络问题。5. 本篇常见错排查下面这几个是远程 Docker 环境下接模型时高频出现的按现象对号入座。现象一控制台能开发消息提示鉴权失败。先检查 config.toml 里的 api_key 有没有多余空格或换行。复制 Key 时经常带上首尾空白TOML 解析后就成了错误值。用grep api_key ~/.openclaw/config.toml看一眼实际内容。现象二请求一直转圈然后超时。多半是容器内 DNS 或出网受限。在容器里执行curl -I https://taotoken.net/api看能否连通。如果连不通检查容器的网络模式确认它和宿主机共享出网能力。现象三报模型不存在。检查 config.toml 的 model 字段和 settings.json 的 default 是否指向同一个配置段。另外确认模型名拼写不同提供方的模型名不通用。现象四改了配置但行为没变。OpenClaw 不会热加载所有配置改完必须openclaw gateway restart。只改 settings.json 有时也需要重启别只刷新页面。现象五局域网能访问但模型调用走不通。这是把界面访问和模型调用混为一谈了。界面走的是 18789 网关模型调用走的是容器出网到 TaoToken。两者独立界面通不代表模型通必须单独验证。提示排查时优先用第 4 节的 curl 命令它把 OpenClaw 排除在外能直接判断是 Key 问题还是配置问题比在界面里反复试快得多。6. 后续怎么用统一 Key 的长期价值打通之后你会发现统一 Key 的好处在于扩展。以后想在 OpenClaw 里换模型只改 config.toml 里的 model 字段就行base_url 和 api_key 都不用动。如果同时跑多个自部署工具它们可以共用同一个 Key在 TaoToken 控制台里统一看用量。需要长期跑编码类任务或者接 Agent 工作流的可以了解下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。只是想在界面里验证模型效果的直接开模型对话页就行https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 遇到协议细节可以对照查。最后留一个我踩过的坑容器重建后~/.openclaw 如果没挂载到宿主机卷配置会全部丢失。建议在 docker run 时把配置目录也映射出来和笔记一里映射数据目录的做法一致这样重启容器不用重新配一遍。
优化实践)
