88API88API
User GuideAI ApplicationsAPI ReferenceHelp & Support

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.

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 | bash

Windows (PowerShell) :

iwr -useb https://openclaw.ai/install.ps1 | iex

Pour 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-daemon

Cet 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 status
openclaw dashboard

Si 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_HOME
  • OPENCLAW_STATE_DIR
  • OPENCLAW_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

  1. Déclarez un fournisseur api88 sous models.providers.
  2. Définissez baseUrl sur https://api.88api.ai/v1 (le suffixe /v1 est obligatoire).
  3. Réglez api sur openai-completions.
  4. Répertoriez les ID de modèle que vous souhaitez qu'OpenClaw utilise dans models.
  5. Basculez le modèle par défaut de agents.defaults.model.primary vers api88/....

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 restart

Windows (PowerShell) :

Add-Content -Path "$HOME\.openclaw\.env" -Value 'API88_API_KEY=sk-your-88api-key' -Encoding ascii
openclaw gateway restart

Ensuite, 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 configurationDescriptif
models.modeIl est recommandé de définir sur merge, en ajoutant api88 tout en conservant les fournisseurs intégrés d'OpenClaw
models.providers.api88.baseUrlAdresse de l'API 88API https://api.88api.ai/v1 ; elle doit inclure /v1
models.providers.api88.apiKeyClé 88API, recommandée pour injecter via ${API88_API_KEY}
models.providers.api88.apiPour les passerelles compatibles OpenAI comme 88API, utilisez openai-completions
models.providers.api88.modelsLes ID de modèle listés ici doivent correspondre aux noms de modèles réellement proposés par 88API
agents.defaults.model.primaryModèle principal par défaut, le format doit être provider/model-id
agents.defaults.model.fallbacksListe des modèles de secours, bascule automatiquement si le modèle principal échoue
agents.defaults.modelsFacultatif, 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 dashboard

Si 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 list

pour confirmer que les modèles avec le préfixe api88/ apparaissent dans la liste sélectionnable.

Problèmes courants

  • baseUrl manquant /v1: C'est l'une des erreurs d'intégration les plus courantes.
  • ID de modèle incorrect: primary et fallbacks doivent correspondre au id dans models.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écutez openclaw gateway restart.
  • Pour le dépannage au premier plan: utilisez la méthode officielle d'exécution au premier plan openclaw gateway --port 18789 pour observer les journaux et les erreurs.