AstrBot 接入

难度 ⌨️ 进阶　|　接口格式 OpenAI 兼容　|　base_url https://byesu.com/v1

接入信息 · 填这几样

接口地址https://byesu.com/v1

API 密钥sk-xxxxxxxx去控制台创建 →

推荐模型gpt-5.5

接口格式 OpenAI 兼容 · 模型名以 控制台 实际为准

AstrBot 是一款开源、一站式的聊天机器人 Agent 平台，可以把 AI 接入 QQ、飞书、钉钉、企业微信等聊天软件。把它的「模型提供商」指向半页酥 API，即可让你的机器人用上 gpt-5.5、claude-opus-4-8 等模型。

开始之前

先到 控制台 → 令牌 新建一个令牌（形如 sk-xxxx），并为令牌选对分组——分组决定了你能调用哪些模型与计费方式。不清楚怎么选见 选择分组。

第 1 步：部署并打开 AstrBot 管理面板

AstrBot 支持 Docker、宝塔、源码等多种部署方式，部署细节见 AstrBot 官方文档。Docker 一键启动示例：

docker run -d \
  --name astrbot \
  -p 6185:6185 \
  -v $PWD/astrbot/data:/AstrBot/data \
  soulter/astrbot:latest

启动后在浏览器打开管理面板：

http://你的服务器IP:6185

首次进入会引导你设置管理员账号密码，登录后即进入控制台。

第 2 步：添加模型提供商（填 base_url + Key）

在管理面板左侧进入 模型提供商（Provider），点击 添加 / 新增服务提供商，按下面填写：

字段	填写内容
提供商类型	选择 OpenAI（兼容 OpenAI 接口）
API Base URL	https://byesu.com/v1
API Key	你的令牌 sk-xxxx
模型（Model）	半页酥真实模型名，如 gpt-5.5

base_url 一定要带 /v1

AstrBot 走 OpenAI 兼容接口，API Base URL 必须填 https://byesu.com/v1（结尾带 /v1）。漏掉 /v1 会导致请求 404 / 无法连接。

常用模型名（按需选填，可在面板里配置多个）：

gpt-5.5                # OpenAI，综合对话
claude-opus-4-8        # Anthropic，强推理 / 长文
gemini-3.1-pro-high    # Google，多模态

填好后点 保存。部分版本提供「测试 / 拉取模型列表」按钮，可点一下确认 base_url 与 Key 连通。

第 3 步：设为默认模型并验证

1. 进入 配置文件（Configuration）→ 模型 / 大语言模型 区域。
2. 把 默认聊天模型（Default Chat Provider / Model） 选为上一步新建的半页酥提供商。
3. 点 保存，必要时重启 / 重载配置。

随后在已绑定的聊天平台（或面板自带的对话测试入口）发一句话，机器人能正常回复即接入成功。回复异常时，先回到提供商配置核对 base_url、Key 与模型名。

卡住了？

• 401 / 鉴权失败：Key 填错或漏了 sk- 前缀；复制完整令牌重填。详见 常见错误 · 鉴权。
• 404 / 连接不上：API Base URL 没带 /v1，应为 https://byesu.com/v1。
• 提示无可用渠道 / 模型不存在：令牌分组没覆盖该模型，或模型名拼错；改用 gpt-5.5、claude-opus-4-8 等真实模型名，并 选对分组。见 常见错误 · 无可用渠道。
• 额度不足：账户或令牌额度用尽，充值或调高令牌额度后重试。见 常见错误 · 余额。

更多排查见 常见错误。