Intégration d'AstrBot

Difficulté ⌨️ Avancé　|　Format d'interface Compatible OpenAI　|　base_url https://byesu.com/v1

Infos de connexion

Adresse APIhttps://byesu.com/v1

Clé APIsk-xxxxxxxxCréer dans la console →

Modèlegpt-5.5

Format API OpenAI compatible · noms de modèles selon la console

AstrBot est une plateforme d'agent de chatbot open source et tout-en-un, qui permet d'intégrer l'IA à des messageries comme QQ, Feishu, DingTalk, WeChat Work, etc. Il suffit de pointer son « fournisseur de modèles » vers Byesu API pour que votre robot puisse utiliser des modèles comme gpt-5.5, claude-opus-4-8, et bien d'autres.

Avant de commencer

Rendez-vous d'abord dans la console → Jetons pour créer un jeton (de la forme sk-xxxx), puis choisissez le bon groupe pour ce jeton — le groupe détermine les modèles que vous pouvez appeler ainsi que le mode de facturation. Si vous ne savez pas lequel choisir, consultez Choisir un groupe.

Étape 1 : déployer et ouvrir le panneau d'administration d'AstrBot

AstrBot prend en charge plusieurs méthodes de déploiement : Docker, BT Panel, code source, etc. Pour les détails du déploiement, consultez la documentation officielle d'AstrBot. Exemple de démarrage en une commande avec Docker :

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

Une fois démarré, ouvrez le panneau d'administration dans votre navigateur :

http://IP-de-votre-serveur:6185

Lors de la première connexion, un assistant vous guide pour définir le nom d'utilisateur et le mot de passe administrateur ; après connexion, vous accédez à la console.

Étape 2 : ajouter un fournisseur de modèles (renseigner base_url + clé)

Dans le menu de gauche du panneau d'administration, accédez à Fournisseur de modèles (Provider), cliquez sur Ajouter / Nouveau fournisseur de services, puis remplissez comme suit :

Champ	Contenu à renseigner
Type de fournisseur	Choisissez OpenAI (compatible avec l'interface OpenAI)
API Base URL	https://byesu.com/v1
API Key	Votre jeton sk-xxxx
Modèle (Model)	Le nom réel du modèle Byesu, par exemple gpt-5.5

La base_url doit impérativement se terminer par /v1

AstrBot utilise l'interface compatible OpenAI : l'API Base URL doit obligatoirement être https://byesu.com/v1 (avec /v1 à la fin). Oublier /v1 provoque une erreur 404 / une impossibilité de connexion.

Noms de modèles courants (à renseigner selon vos besoins, vous pouvez en configurer plusieurs dans le panneau) :

gpt-5.5                # OpenAI, conversation générale
claude-opus-4-8        # Anthropic, raisonnement avancé / textes longs
gemini-3.1-pro-high    # Google, multimodal

Une fois rempli, cliquez sur Enregistrer. Certaines versions proposent un bouton « Tester / Récupérer la liste des modèles » : vous pouvez cliquer dessus pour vérifier que la base_url et la clé sont bien connectées.

Étape 3 : définir comme modèle par défaut et vérifier

1. Accédez à la zone Fichier de configuration (Configuration) → Modèles / Grands modèles de langage.
2. Définissez le modèle de chat par défaut (Default Chat Provider / Model) sur le fournisseur Byesu créé à l'étape précédente.
3. Cliquez sur Enregistrer, puis redémarrez / rechargez la configuration si nécessaire.

Envoyez ensuite un message depuis une plateforme de messagerie déjà connectée (ou via l'interface de test de conversation intégrée au panneau) : si le robot répond normalement, l'intégration est réussie. En cas de réponse anormale, retournez d'abord à la configuration du fournisseur pour vérifier la base_url, la clé et le nom du modèle.

Bloqué ?

• 401 / échec d'authentification : la clé est erronée ou il manque le préfixe sk- ; recopiez le jeton complet et ressaisissez-le. Voir Erreurs courantes · Authentification.
• 404 / impossible de se connecter : l'API Base URL ne comporte pas /v1, elle doit être https://byesu.com/v1.
• Message « aucun canal disponible » / « modèle inexistant » : le groupe du jeton ne couvre pas ce modèle, ou le nom du modèle est mal orthographié ; utilisez un nom de modèle réel comme gpt-5.5, claude-opus-4-8, et choisissez le bon groupe. Voir Erreurs courantes · Aucun canal disponible.
• Solde insuffisant : le quota du compte ou du jeton est épuisé ; rechargez ou augmentez le quota du jeton, puis réessayez. Voir Erreurs courantes · Solde.

Pour plus de dépannage, consultez Erreurs courantes.