Подключение AstrBot

Сложность ⌨️ Продвинутый　|　Формат интерфейса Совместимый с OpenAI　|　base_url https://byesu.com/v1

Данные подключения

Адрес APIhttps://byesu.com/v1

Ключ APIsk-xxxxxxxxСоздать в консоли →

Модельgpt-5.5

Формат API OpenAI совместимо · имена моделей — по консоли

AstrBot — это открытая универсальная платформа чат-ботов-агентов, которая позволяет подключить ИИ к QQ, Feishu, DingTalk, WeCom и другим мессенджерам. Достаточно указать в её «поставщике моделей» Byesu API, и ваш бот сможет использовать модели gpt-5.5, claude-opus-4-8 и другие.

Перед началом

Сначала перейдите в Консоль → Токены и создайте новый токен (вида sk-xxxx), а также выберите для токена правильную группу — группа определяет, какие модели вам доступны и как происходит тарификация. Если не знаете, что выбрать, см. Выбор группы.

Шаг 1. Разверните и откройте панель управления AstrBot

AstrBot поддерживает множество способов развёртывания: Docker, aaPanel, исходный код и другие. Подробности развёртывания см. в официальной документации 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)	Реальное имя модели Byesu, например 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) выберите поставщика Byesu, созданного на предыдущем шаге.
3. Нажмите Сохранить, при необходимости перезапустите / перезагрузите конфигурацию.

Затем отправьте сообщение на привязанной платформе чата (или через встроенный в панель тест диалога). Если бот нормально отвечает — подключение прошло успешно. Если ответ некорректный, вернитесь к настройкам поставщика и проверьте base_url, Key и имя модели.

Застряли?

• 401 / Ошибка аутентификации: Key указан неверно или пропущен префикс sk-; скопируйте токен полностью и введите заново. Подробнее см. Частые ошибки · Аутентификация.
• 404 / Не удаётся подключиться: в API Base URL отсутствует /v1, должно быть https://byesu.com/v1.
• Сообщение об отсутствии доступных каналов / модель не существует: группа токена не охватывает эту модель, или имя модели написано с ошибкой; используйте реальные имена моделей, такие как gpt-5.5, claude-opus-4-8, и выберите правильную группу. См. Частые ошибки · Нет доступных каналов.
• Недостаточно средств: на счёте или токене закончился лимит; пополните баланс или увеличьте лимит токена и повторите попытку. См. Частые ошибки · Баланс.

Дополнительные способы диагностики см. в Частые ошибки.