AstrBot 配置教程

更新于 2026-09-27

适用范围：AstrBot 当前中文版 WebUI 的内置 AI 对话提供商配置，附飞书接入步骤。

版本与验证：2026-09-28 按官方文档核对配置流程。配图为 apizt 原创配置示意图，接入地址统一使用 https://api.apizt.com/v1，聊天模型示例使用 gpt-6-sol。未使用真实 API Key 验证付费调用。

配置速查

为此工具单独创建令牌，并设置合理额度和模型权限。截图中的模型仅作示例，以账号当前可用模型为准；不要公开密钥或上传含密钥的配置文件。

本教程使用 AstrBot 当前中文版 WebUI 的内置 AI 配置，将 apizt 设置为对话模型提供商。完成 WebUI 测试后，再把模型用于飞书等消息平台机器人。

已部署的用户直接进入 WebUI。首次使用可按官方 Docker 指南准备 Git 与 Docker Compose，然后运行：

git clone https://github.com/AstrBotDevs/AstrBot
cd AstrBot
docker compose up -d
docker compose logs -f

从启动日志获取管理地址和首次登录信息。WebUI 常用端口为 6185，以实际部署配置为准；初始密码以日志中的随机密码为准。完成首次登录后继续配置模型。

若模型列表包含 gpt-6-sol，点击该模型行的 + 启用。若列表获取失败，可先点击 保存配置，再通过 自定义模型 手动填写完整模型 ID。模型名称以 apizt 当前分组权限为准。

添加后点击 测试模型，按返回错误检查令牌、地址和模型权限。

若已有多份配置，确认目标机器人绑定的是刚保存的那一份。本文采用内置 AI；使用 Dify 或 Coze 等外部 Agent Runner 时，应另按对应后端说明配置。

WebUI 对话验证成功后，进入 机器人 → 创建机器人，选择 lark（飞书）。按当前官方指南选择扫码创建或手动创建应用。

飞书 App Secret 填机器人平台配置，apizt API Key 填模型提供商配置，不能互相替换。完整权限与事件清单参见官方飞书教程。

添加提供商与选择对话模型是两个步骤；在机器人使用的配置文件中选择新模型并保存。

可保存提供商后手动添加准确的模型 ID，再通过测试模型检查聊天接口。

现象	检查与处理
401 / Unauthorized	重新复制有效的 apizt 令牌，检查空格、过期状态和额度。
404 / 接口路径错误	基础地址填写 https://api.apizt.com/v1，不要追加 /chat/completions 或重复 /v1。
模型不存在或无权限	核对完整模型 ID、令牌允许的模型与分组；gpt-6-sol 是本文示例。
429 / 限流或额度不足	按错误体区分余额、令牌额度、并发与速率限制，减少并发后重试。
保存提供商后仍用旧模型	在配置文件 → AI 配置 → 模型中选择新对话模型并保存。
WebUI 正常，飞书没有回复	检查机器人启用状态、绑定配置、触发条件、消息事件、权限与应用发布状态。
模型列表无法获取	保存提供商后使用自定义模型填写准确 ID，再单独测试模型。

遇到问题时保留软件版本、请求时间、模型 ID、错误码和请求 ID，联系支持时先隐藏 API Key。