OpenClaw - Plateforme d'assistant IA auto-hébergée
Tutoriel OpenClaw – Installez OpenClaw, intégrez 88API et configurez rapidement un assistant IA auto-hébergé. Projet open source, prenant en charge l'intégration multicanal comme Telegram, Discord, WhatsApp.
Présentation du projet
OpenClaw est une IA personnelle open source et auto-hébergée plateforme d'assistant qui connecte les applications de messagerie à l'IA agents fonctionnant sur votre propre matériel. Conçu pour les développeurs et les utilisateurs avancés, il vous permet de disposer d'un assistant IA autonome sans renoncer au contrôle de vos données.
- Page d'accueil officielle: https://openclaw.ai
- Documentation du projet: https://docs.openclaw.ai
- GitHub: https://github.com/openclaw/openclaw
OpenClaw est entièrement open source. Vous pouvez parcourir le code source, soumettre des problèmes ou contribuer sur le référentiel GitHub d'OpenClaw. Ce didacticiel couvre les étapes complètes d'installation, de configuration et d'intégration d'OpenClaw avec 88API.
🌟 Fonctionnalités principales
Intégration multicanal
- Intégration multicanal: prend en charge divers canaux de messagerie tels que Telegram, Discord, WhatsApp, iMessage et peut être étendu à davantage de plates-formes via des plugins.
- Single Gateway: gestion unifiée de tous les canaux via un processus de passerelle unique.
- Support vocal: prend en charge l'interaction vocale macOS/iOS/Android.
- Interface Canvas: Peut restituer des interfaces Canvas interactives.
Auto-hébergement et sécurité des données
- Entièrement auto-hébergé: fonctionne sur votre propre machine ou serveur.
- Open Source Transparency : licence open-source MIT, code totalement transparent.
- Données locales: le contexte et les compétences sont stockés sur votre ordinateur local, pas dans le cloud.
Capacités de l'agent intelligent
- Fonctionnement continu: prend en charge le fonctionnement persistant en arrière-plan avec une mémoire à long terme.
- Tâches planifiées: prend en charge les tâches planifiées cron.
- Isolement de session: isole les sessions par agent/espace de travail/expéditeur.
- Routage multi-agent: prend en charge le travail collaboratif entre plusieurs agents.
- Tool Calling: prise en charge native de l'appel d'outils et de l'exécution de code.
📦 Préparation avant intégration
Informations sur la préparation
- Node.js 24.16+ ou 26.1+ (Node 26 est recommandé officiellement ; Node 22, 23 et 25 ne sont pas pris en charge. Le script d'installation officiel prépare Node automatiquement)
- Adresse de l'API 88API :
https://api.88api.ai/v1 - Une clé API créée dans la console 88API
- Conservez votre clé API en lieu sûr et ne la collez pas dans des applications ou des pages d'origine inconnue.
Avant d'intégrer 88API, il est recommandé de faire d'abord fonctionner l'interface utilisateur de passerelle et de contrôle conformément au processus officiel recommandé actuellement par OpenClaw. Cela permet de distinguer plus facilement si OpenClaw lui-même ne démarre pas ou si la configuration du fournisseur de modèles est incorrecte lors d'un dépannage ultérieur.
1. Installez OpenClaw
macOS/Linux :
curl -fsSL https://openclaw.ai/install.sh | bashWindows (PowerShell) :
iwr -useb https://openclaw.ai/install.ps1 | iexPour d'autres méthodes d'installation, reportez-vous à la documentation officielle d'OpenClaw: Getting Started.
2. Exécutez l'assistant d'intégration
openclaw onboard --install-daemonCet assistant effectuera l'authentification de base, la configuration de la passerelle et l'initialisation facultative du canal. L'objectif ici est de faire fonctionner OpenClaw en premier, puis de passer ultérieurement au modèle par défaut vers 88API.
Le script d'installation officiel lance automatiquement cet assistant à la fin ; si vous l'avez déjà terminé pendant l'installation, vous pouvez sauter cette étape. L'assistant exige un modèle fonctionnel pour se terminer. Si vous n'avez qu'une clé 88API, choisissez More… → Custom Provider dans la liste des fournisseurs de modèles : Base URL https://api.88api.ai/v1 (le suffixe /v1 est obligatoire), Compatibility laissée à la valeur par défaut openai, Model ID gpt-6.1-sol, puis collez votre clé 88API. L'assistant envoie une vraie requête et n'enregistre qu'en cas de succès. Le fournisseur qu'il crée porte un nom du type custom-api-88api-ai et peut coexister avec le fournisseur api88 ajouté manuellement plus bas.
Ne choisissez pas Skip for now : l'assistant se ferme sans démarrer la passerelle (Gateway), et les vérifications de l'étape suivante échoueront.
3. Vérifiez la passerelle et l'interface utilisateur de contrôle
openclaw gateway statusopenclaw dashboardSi le navigateur peut ouvrir l'interface utilisateur de contrôle, cela signifie que le fonctionnement de base d'OpenClaw est normal. À ce stade, il n'est pas encore nécessaire de configurer Telegram, Discord, Feishu ou d'autres canaux de messagerie.
4. Localisez le fichier de configuration
Le fichier de configuration d'OpenClaw se trouve généralement en ~/.openclaw/openclaw.json. Vous pouvez continuer à le modifier en fonction de ce que l'assistant d'intégration a généré.
Variables d'environnement liées au chemin
Si vous exécutez OpenClaw sous un compte de service dédié ou si vous souhaitez personnaliser le répertoire configuration/state, vous pouvez utiliser:
OPENCLAW_HOMEOPENCLAW_STATE_DIROPENCLAW_CONFIG_PATH
Pour des instructions détaillées, consultez la documentation officielle des variables d'environnement: Variables d'environnement.
🚀 Utiliser 88API comme fournisseur de modèles
OpenClaw prend en charge l'intégration de passerelles de modèles personnalisées ou compatibles OpenAI via models.providers. Pour 88API, l'approche la plus courante consiste à l'ajouter en tant que fournisseur personnalisé à la configuration, puis à pointer le modèle par défaut vers api88/model-ID.
Approche d'intégration
- Déclarez un fournisseur
api88sousmodels.providers. - Définissez
baseUrlsurhttps://api.88api.ai/v1(le suffixe/v1est obligatoire). - Réglez
apisuropenai-completions. - Répertoriez les ID de modèle que vous souhaitez qu'OpenClaw utilise dans
models. - Basculez le modèle par défaut de
agents.defaults.model.primaryversapi88/....
Pratique recommandée: stocker la clé API dans les variables d'environnement
Lorsque la passerelle (Gateway) s'exécute en service d'arrière-plan (--install-daemon à l'étape 2), elle ne voit pas les variables que vous faites export dans un terminal. Écrivez la clé dans le fichier d'environnement global recommandé officiellement par OpenClaw, ~/.openclaw/.env (ou le .env du répertoire OPENCLAW_STATE_DIR si vous l'avez défini), puis redémarrez la passerelle :
macOS/Linux :
echo 'API88_API_KEY=sk-your-88api-key' >> ~/.openclaw/.env
openclaw gateway restartWindows (PowerShell) :
Add-Content -Path "$HOME\.openclaw\.env" -Value 'API88_API_KEY=sk-your-88api-key' -Encoding ascii
openclaw gateway restartEnsuite, ajoutez ou modifiez l'extrait suivant dans openclaw.json:
{
models: {
mode: "merge",
providers: {
api88: {
baseUrl: "https://api.88api.ai/v1",
apiKey: "${API88_API_KEY}",
api: "openai-completions",
models: [
{ id: "gemini-3.5-flash", name: "Gemini 3.5 Flash" },
{ id: "kimi-k3", name: "Kimi K3" },
],
},
},
},
agents: {
defaults: {
model: {
primary: "api88/gemini-3.5-flash",
fallbacks: ["api88/kimi-k3"],
},
models: {
"api88/gemini-3.5-flash": { alias: "flash" },
"api88/kimi-k3": { alias: "kimi" },
},
},
},
}Il ne s'agit pas d'une configuration complète qu'il faut copier exactement, mais plutôt de la partie la plus critique pour l'intégration de 88API. Tant que les provider, les ID de modèle et les références de modèle par défaut sont corrects, OpenClaw pourra appeler les modèles correspondants via 88API.
Détails de la configuration des clés
| Élément de configuration | Descriptif |
|---|---|
models.mode | Il est recommandé de définir sur merge, en ajoutant api88 tout en conservant les fournisseurs intégrés d'OpenClaw |
models.providers.api88.baseUrl | Adresse de l'API 88API https://api.88api.ai/v1 ; elle doit inclure /v1 |
models.providers.api88.apiKey | Clé 88API, recommandée pour injecter via ${API88_API_KEY} |
models.providers.api88.api | Pour les passerelles compatibles OpenAI comme 88API, utilisez openai-completions |
models.providers.api88.models | Les ID de modèle listés ici doivent correspondre aux noms de modèles réellement proposés par 88API |
agents.defaults.model.primary | Modèle principal par défaut, le format doit être provider/model-id |
agents.defaults.model.fallbacks | Liste des modèles de secours, bascule automatiquement si le modèle principal échoue |
agents.defaults.models | Facultatif, utilisé pour créer des alias pour les modèles, pratique pour le référencement dans l'interface utilisateur ou les sessions |
Vérifier la réussite de l'intégration
Une fois la configuration terminée, revenez à l'interface utilisateur de contrôle ou rouvrez-la:
openclaw dashboardSi vous pouvez lancer des conversations normalement dans OpenClaw et que le modèle par défaut est devenu api88/..., alors l'intégration est réussie. Vous pouvez également utiliser:
openclaw models listpour confirmer que les modèles avec le préfixe api88/ apparaissent dans la liste sélectionnable.
Problèmes courants
baseUrlmanquant/v1: C'est l'une des erreurs d'intégration les plus courantes.- ID de modèle incorrect:
primaryetfallbacksdoivent correspondre auiddansmodels.providers.api88.models. - Clé API uniquement efficace dans le terminal actuel : le service d'arrière-plan n'hérite pas des variables exportées dans un terminal. Écrivez la clé dans
~/.openclaw/.env, puis exécutezopenclaw gateway restart. - Pour le dépannage au premier plan: utilisez la méthode officielle d'exécution au premier plan
openclaw gateway --port 18789pour observer les journaux et les erreurs.
Memoh – Plateforme d'agents IA conteneurisée
Guide d'intégration Memoh — Connectez la plate-forme d'agents d'IA conteneurisée auto-hébergée à 88API, créant ainsi des robots d'IA avec une mémoire à long terme pour Telegram, Discord, Lark, QQ, WeChat, etc.
LangBot - Plateforme de développement de robots IM
Tutoriel de configuration de LangBot — ajoutez 88API comme fournisseur dans LangBot pour doter vos bots Lark, DingTalk, QQ, WeCom, Telegram et autres de capacités de conversation IA.