中转站怎么配置astrbot

很多人把 AstrBot 装好、中转站的 Key 也拿到手，卡在最后一步：Base URL 填什么、模型名写哪个、填完一直报错不知道从哪查。这篇不讲选站，只讲配置动作——从在中转站后台拿信息开始，到改配置文件、重启、跑通一条消息，再到按报错类型逐条排查。

很多人把 AstrBot 装好、中转站的 Key 也拿到手，卡在最后一步：Base URL 填什么、模型名写哪个、填完一直报错不知道从哪查。这篇不讲选站，只讲配置动作——从在中转站后台拿信息开始，到改配置文件、重启、跑通一条消息，再到按报错类型逐条排查。

整体节奏就四步：抄字段、改配置、跑验证、按报错查。每一步都有能立刻验证的动作，不要一次改三个地方然后猜是哪个生效了。

先去中转站后台把这几样抄下来

配置失败十有八九是抄错了字段，不是 AstrBot 有问题。打开中转站后台的令牌/密钥页面，把下面四样东西一次性复制到记事本里，后面填配置时直接粘贴，别靠回忆手打。

模型名别按印象写，用中转站模型列表里的原始字符串，大小写和横线都要一致。顺手在站内的 /models 页核对一下你要用的模型名和计费口径，避免配完才发现选错了档。有些站点的 Base URL 不带版本路径后缀，AstrBot 那边会自动补，别手动叠两层；不确定就两种都各试一次。

改配置：字段对应关系与顺序

AstrBot 接中转站的本质，就是把它当一个 OpenAI 兼容接口用。记住这一层对应关系，后面填什么都清楚了。

服务商类型

选 OpenAI 兼容那一类，不要选具体官方厂商

接口地址

填中转站给你的 Base URL，末尾别自己加斜杠

密钥

填后台抄下来的那把 Key，单独建一把给机器人用

模型名

填模型列表里的原始字符串，和默认模型字段保持一致

1. 先在网页端配好并保存在 AstrBot 的服务商配置界面填完上面四项，点保存，确认界面上能看到这条配置。
2. 再去改配置文件网页端保存后再改配置文件里对应的字段，避免两边同时改互相覆盖。
3. 检查两处模型名一致默认模型字段和模型列表里的名字要对上，否则请求会回落到一个你没开通的模型上。
4. 重启服务改完配置重启一次 AstrBot，不要靠热加载猜有没有生效。

配完怎么确认真的通了

重启完别急着发一大段话，按下面顺序跑三轮，每轮只验证一件事。这样哪一轮挂了，问题范围就很清楚。

• 先在 AstrBot 自带的对话或调试入口发一句最短的话，能出字说明链路通；不出字再往下查
• 换一个长一点、会消耗较多 token 的请求，确认不是只通了小请求
• 隔一段时间再发一次，排除偶发超时被当成配置错误
• 始终不出字时，用站内的 /tools/speed-test 从外部确认这把 Key 能不能调通，把问题定位在 AstrBot 侧还是中转站侧

如果外部工具能调通、AstrBot 调不通，问题基本在配置字段或网络出口；如果外部工具也调不通，就带着这把 Key 去后台核对分组和余额。两条路别混着查。

常见报错按这个顺序排查

报错先分类，再动手。下面这张表按错误类型给排查顺序，从上往下走，走到哪一步好了就停。

有一点要说清楚：429 和超时这类不属于配置错误，你改多少遍配置文件都不会好，只会在原地绕圈。只有 401、404、模型不存在这三类才值得回头动配置。要是你用的是按量计费的中转，具体单价和扣费口径到 /price-watch 核对当时的数字，别拿印象里的价格判断余额够不够。

先把错误分成「配置错」和「额度/限流问题」两类，能省掉一半瞎改配置文件的时间。