Intégration de Memoh

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

Memoh est une plateforme d'agents IA open source et auto-hébergée. Chaque robot s'exécute dans un conteneur isolé, dispose d'une mémoire persistante et d'un système de fichiers indépendant, et peut se connecter à plusieurs canaux comme Telegram, Discord, Feishu, QQ, WeChat, etc. Elle prend en charge n'importe quel fournisseur de modèles compatible OpenAI, ce qui permet de se connecter directement à « Byesu API ».

Avant de commencer

Rendez-vous d'abord sur Console → Jetons pour créer un jeton (de la forme sk-xxxx). Lors de la création, veillez à choisir le bon groupe : le groupe détermine quels modèles vous pouvez utiliser et le multiplicateur de facturation. Si vous ne savez pas lequel choisir, consultez d'abord Choisir un groupe.

Étape 1 : Installer Memoh

Memoh se déploie en une seule commande via Docker. Exécutez sur votre serveur :

curl -fsSL https://memoh.sh | sudo sh

Vous pouvez aussi déployer manuellement : clonez avec git clone --depth 1 https://github.com/memohai/Memoh.git, entrez dans le répertoire, copiez d'abord la configuration avec cp conf/app.docker.toml config.toml (à éditer selon vos besoins), puis lancez docker compose up -d — ne sautez pas l'étape de copie du fichier de configuration, sinon le démarrage échouera. Une fois l'installation terminée, ouvrez le panneau d'administration dans votre navigateur :

• Adresse : http://localhost:8082 (pour un serveur distant, remplacez par l'IP/le domaine correspondant)
• Compte par défaut : admin　mot de passe : admin123

Conseil de sécurité

Dès votre première connexion, modifiez immédiatement le mot de passe par défaut afin d'empêcher quiconque d'accéder au panneau d'administration.

Étape 2 : Ajouter un fournisseur (renseigner base_url et la clé API)

Une fois connecté au panneau d'administration, accédez à « Gestion des fournisseurs / Provider Management » et ajoutez un nouveau fournisseur compatible OpenAI (que vous pouvez nommer byesu), en renseignant :

Champ	Contenu à renseigner
API Base URL	https://byesu.com/v1
API Key	Le jeton que vous avez créé dans la console byesu, par exemple sk-xxxx

Une fois renseigné, cliquez sur « Enregistrer ».

Le /v1 à la fin de base_url

Memoh utilise le protocole compatible OpenAI ; base_url doit obligatoirement se terminer par /v1, soit https://byesu.com/v1. Ne l'omettez pas et ne le dupliquez pas en /v1/v1.

Étape 3 : Importer les modèles

Accédez à « Gestion des modèles / Model Management » et utilisez « Importation automatique » pour récupérer les modèles disponibles chez ce fournisseur, ou ajoutez manuellement les noms de modèles dont vous avez besoin. Il est recommandé de renseigner les modèles réellement disponibles chez byesu, par exemple :

gpt-5.5
claude-opus-4-8
gemini-3.1-pro-high

Les modèles doivent correspondre au groupe

La possibilité d'appeler un modèle donné dépend du groupe auquel appartient votre jeton. Si un message d'erreur indique que le modèle n'est pas disponible lors de l'importation ou de l'appel, c'est généralement que le groupe n'a pas été correctement choisi : retournez dans la console pour modifier le groupe du jeton. Voir Choisir un groupe pour plus de détails.

Étape 4 : Configurer le robot et vérifier

1. Accédez aux « Paramètres → Configuration du modèle / Model Configuration » d'un robot.
2. Remplacez le modèle de conversation par défaut par le modèle byesu importé à l'étape précédente (par exemple claude-opus-4-8).
3. Enregistrez.

Envoyez ensuite un message au robot depuis le canal correspondant (Telegram / Discord / Feishu, etc.) ou depuis la fenêtre de conversation du panneau. Si vous recevez une réponse normale, l'intégration est réussie.

Bloqué ?

Questions fréquentes

• Erreur 401 / jeton invalide : la clé API est incorrecte ou comporte des espaces superflus. Recopiez sk-xxxx depuis la console. Voir Erreurs courantes #auth.
• Erreur de solde insuffisant : le crédit du compte est épuisé, rendez-vous dans la console pour le recharger. Voir Erreurs courantes #balance.
• Erreur aucun canal disponible / modèle non disponible : le groupe du jeton ne prend pas en charge ce modèle ; changez de modèle ou de groupe. Voir Erreurs courantes #no-channel et Choisir un groupe.
• Délai de connexion dépassé / échec de récupération des modèles : vérifiez que base_url est bien https://byesu.com/v1 (avec /v1, en https), et que votre serveur dispose d'un accès fluide à Internet. Voir Erreurs courantes #timeout.

Pour plus de dépannage, voir Erreurs courantes.