OpenClaw - Plateforme d'assistant IA auto-hébergée

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] (https://github.com/openclaw/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

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

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.

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é.

🚀 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 88api/model-ID.

Approche d'intégration

1. Déclarez un fournisseur 88api sous models.providers.
2. Pointez baseUrl vers votre adresse 88API, en vous assurant qu'elle inclut /v1.
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 88api/....

Pratique recommandée: stocker la clé API dans les variables d'environnement

Tout d'abord, fournissez votre clé 88API dans le shell actuel, l'environnement de service ou un fichier .env lisible par OpenClaw:

export API88_API_KEY="sk-your-88api-key"

Ensuite, ajoutez ou modifiez l'extrait suivant dans openclaw.json:

{
  models: {
    mode: "merge",
    providers: {
      88api: {
        baseUrl: "https://88api.ai/v1",
        apiKey: "${API88_API_KEY}",
        api: "openai-completions",
        models: [
          { id: "gemini-2.5-flash", name: "Gemini 2.5 Flash" },
          { id: "kimi-k2.5", name: "Kimi K2.5" },
        ],
      },
    },
  },

  agents: {
    defaults: {
      model: {
        primary: "88api/gemini-2.5-flash",
        fallbacks: ["88api/kimi-k2.5"],
      },
      models: {
        "88api/gemini-2.5-flash": { alias: "flash" },
        "88api/kimi-k2.5": { 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 vos ressources de modèle exposées via 88API.

Détails de la configuration des clés

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 88api/..., alors l'intégration est réussie. Vous pouvez également utiliser:

openclaw models list

pour confirmer que les modèles avec le préfixe 88api/ 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.88api.models.
• Clé API uniquement efficace dans le terminal actuel: si Gateway s'exécute en tant que service en arrière-plan, assurez-vous que le processus de service peut également lire API88_API_KEY.
• 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.