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

Tutoriel OpenClaw – Installez OpenClaw, intégrez cnAPI 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] (<https://github.com/openclaw/openclaw>). Ce didacticiel couvre les étapes complètes d'installation, de configuration et d'intégration d'OpenClaw avec cnAPI.

🌟 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 22 ou supérieur
Une adresse cnAPI disponible (se terminant généralement par /v1)
Une clé API cnAPI disponible
Veuillez utiliser votre propre cnAPI déployée ou confirmer que le fournisseur de services a des obligations légitimes d'autorisation et de conformité en amont pour son service cnAPI. Ne connectez pas d’adresses API ou de clés inconnues aux environnements de production.

Avant d'intégrer cnAPI, 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 cnAPI.

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 cnAPI 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 cnAPI, 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

Déclarez un fournisseur 88api sous models.providers.
Pointez baseUrl vers votre adresse cnAPI, en vous assurant qu'elle inclut /v1.
Réglez api sur openai-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.primary vers 88api/....

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

Tout d'abord, fournissez votre clé cnAPI 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://cnapi.vip/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 cnAPI. 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 cnAPI.

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 `88api` tout en conservant les fournisseurs intégrés d'OpenClaw
`models.providers.88api.baseUrl`	Votre adresse cnAPI doit généralement inclure `/v1`
`models.providers.88api.apiKey`	Clé cnAPI, recommandée pour injecter via `${API88_API_KEY}`
`models.providers.88api.api`	Pour les passerelles compatibles OpenAI comme cnAPI, utilisez `openai-completions`
`models.providers.88api.models`	Les ID de modèle répertoriés ici doivent correspondre aux noms de modèles réels exposés par votre cnAPI
`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 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.

[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 à cnAPI, créant ainsi des robots d'IA avec une mémoire à long terme pour Telegram, Discord, Lark, QQ, WeChat, etc.](/fr/docs/apps/memoh/)[LangBot - Plateforme de développement de robots IM

Page suivante](/fr/docs/apps/langbot/)

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

On this page