篇不是参数搬运，主要记录一次真实接入过程：哪些配置最容易填错，报错时先看哪里，以及怎么用最小请求把链路跑通。
这两天在整理 OpenClaw 的第三方 API 接入，发现这类工具真正卡人的地方，通常不是“代码难”，而是配置项容易填错。
尤其是第一次接聚合 API 或自定义 OpenAI Compatible 接口时，很多人会把 baseURL、模型名、令牌、接口路径混在一起。表面看只是一个 401、404 或 403，实际排查起来会绕很久。
我把这次接入过程整理一下，给后面要配 OpenClaw 的人做个参考。
先说结论
OpenClaw 接第三方 API，先不要急着跑复杂任务。
更稳的顺序是：
- 先确认入口是不是 OpenAI Compatible / Custom Provider
- 填好 baseURL
- 填好 apiKey
- 复制模型广场里的模型 ID
- 先跑一个最小请求
- 最后再切到正式任务
这个顺序能省很多时间。
一、准备三个东西
接入前，先准备好这三项：
Base URL: https://apitoken.fun/v1 API Key: 控制台创建的令牌 Model: 模型广场里的模型 ID
这里最容易错的是 Base URL。
它一般只写到 /v1，不要写成：
https://apitoken.fun/v1/chat/completions
/chat/completions 是具体接口路径，不是基础地址。很多 404 都是这里写错导致的。
二、OpenClaw 里怎么填
不同版本的入口名字可能略有差异，但大致会叫：
- OpenAI Compatible
- Custom OpenAI
- Custom Provider
- 第三方 API
- 自定义模型服务
核心配置可以按这个思路填：
Provider: OpenAI Compatible / Custom Provider Base URL: https://apitoken.fun/v1 API Key: 你的站内令牌 Model: gpt-5.4-mini 或其他模型 ID
如果只是测试通路，我建议先用轻一点的模型，比如：
gpt-5.4-mini
原因很简单：测试阶段的目标不是看模型有多强，而是确认链路有没有通。
三、先跑最小请求
配置完以后，不建议马上丢一大段代码或长文档进去。
先问一句很短的问题：
hi
或者让它返回一句固定文本。
如果短请求能正常返回，再继续测试复杂任务。这样可以把问题拆开：
- 短请求不通：优先看地址、令牌、模型名
- 短请求通，长任务不通：再看上下文、超时、上游负载
不要一开始就把所有变量混在一起。
四、几个常见错误
1. 401
通常是令牌问题。
常见原因：
- API Key 复制不完整
- 多了空格
- 用错了平台的 Key
- 令牌已经被删除或禁用
这种情况先重新复制令牌，不要急着改模型。
2. 404
通常是地址写错。
重点检查 baseURL 是否只写到：
https://apitoken.fun/v1
不要把 /chat/completions 拼进去。
3. 403
403 要分情况。
如果是平台直接返回权限不足，那可能是账号、分组或模型权限问题。
如果返回内容里出现 Cloudflare 的 Just a moment... 或 cf-mitigated: challenge，那就是上游防护拦截了服务端请求，需要服务商处理白名单或线路。
这个不是客户端配置能解决的。
4. 504
504 多数是上游响应慢、图片生成耗时、或者请求太重。
这类问题不要重复改 Key，可以先：
- 换轻一点的模型
- 缩短输入
- 稍后重试
- 看控制台日志有没有扣费
五、我自己的配置习惯
我现在接这类工具，会固定按这个顺序来：
- 先填 baseURL
- 再填 apiKey
- 模型名直接复制，不手打
- 用短请求测试
- 看日志确认输入、输出、扣费
- 再开始正式任务
尤其是模型名，我不建议凭记忆写。
有些模型名只差一个符号或版本号，手打一错，排查时间比复制还贵。
六、模型选择建议
如果只是日常问答、摘要、改写，可以先用国产模型或轻量 GPT 模型。
如果是复杂推理、代码审查、长内容处理，再用 GPT PRO。
如果是 OpenClaw 这类偏工程、长上下文、多文件任务，再考虑 Claude MAX。
不要一上来就选最贵的模型。很多时候不是模型越贵越合适，而是任务要和模型匹配。
七、一个容易忽略的点：看日志
第三方 API 接入最有用的不是“猜”，而是看日志。
控制台里通常能看到：
- 请求模型
- 渠道
- 输入 token
- 输出 token
- 缓存
- 用时
- 扣费
- 错误状态码
简单判断：
401：先看 Key 404：先看 URL 403：看是不是权限或上游防护 504：看是不是上游超时
这个思路比反复换模型更可靠。
最后
OpenClaw 接第三方 API 这件事，本身不复杂。
真正要注意的是：先跑通，再优化；先看日志，再下结论。
如果你已经用过 OpenAI Compatible 的工具，那迁移过来基本就是三步：
baseURL 改成 https://apitoken.fun/v1 apiKey 换成控制台令牌 model 换成模型广场里的模型 ID
剩下的问题，大多数都能从状态码和日志里定位出来。
一句话：第一次接入，别追求一步到位。先用最小请求跑通，再把任务复杂度一点点加上去。
