Skip to main content

​
Introduction

OpenClaw Manager est un outil de gestion visuel multiplateforme qui vous aide à déployer et gérer rapidement des passerelles de bots IA OpenClaw.
  • Déploiement sans configuration — Fichier exécutable unique, installation automatique de toutes les dépendances
  • Interface de gestion Web — Créer, démarrer/arrêter, supprimer des instances et changer de modèle via le navigateur
  • Prise en charge multicanal — Telegram / Feishu / Discord
  • Prise en charge multi-modèles — Série GPT-5, séries Claude 4.5/4.6, série Gemini avec basculement automatique
  • Mode arrière-plan — Prend en charge le mode --daemon, non affecté par la déconnexion SSH
  • Interface multilingue — Chinois / Anglais / Japonais

​
Prérequis

Avant de commencer, veuillez vous assurer :
  1. Clé API APIMart obtenue Connectez-vous à la console APIMart pour obtenir votre clé API (commence par sk-)
  2. Bot de plateforme de messagerie créé Préparez les identifiants de votre Bot en fonction de la plateforme que vous souhaitez utiliser (voir la section de configuration du canal ci-dessous)
Astuce : si vous n’avez pas encore de compte APIMart, veuillez vous inscrire sur APIMart et obtenir d’abord une clé API.

​
Étape 1 : Téléchargement

Téléchargez l’exécutable correspondant à votre plateforme depuis GitHub Releases :

​
Étape 2 : Exécution

​
Déploiement Windows

​
Prérequis

  • Windows 10/11 (64 bits)
  • Privilèges administrateur (requis pour créer les tâches planifiées Windows qui gèrent le Gateway)

​
Lancement

Au premier lancement, les opérations suivantes seront effectuées automatiquement :
  • Vérification et installation de Node.js v22 (téléchargement automatique du MSI pour une installation silencieuse si non trouvé)
  • Installation d’OpenClaw CLI (via npm install -g openclaw)
  • Ouverture automatique du navigateur sur l’interface de gestion
Doit être exécuté en tant qu’administrateur, sinon les tâches planifiées Windows ne peuvent pas être créées pour gérer les processus Gateway.

​
Étape 3 : Accéder à l’interface de gestion

Une fois le programme démarré, accédez à l’interface de gestion Web :
Accès distant Linux : remplacez 127.0.0.1 par l’adresse IP de votre serveur, par exemple http://votre-ip-serveur:51942

​
Étape 4 : Créer une instance

Dans l’interface de gestion Web, cliquez sur + Nouvelle instance pour commencer :

​
4.1 Définir le nom de l’instance

Saisissez un nom d’instance (uniquement lettres, chiffres, underscores, tirets, 1 à 64 caractères).

​
4.2 Sélectionner le modèle d’IA

Choisissez le modèle d’IA à utiliser et saisissez votre clé API APIMart (commence par sk-). Modèles pris en charge :
Recommandations de modèles :
  • 💰 Économique : claude-haiku-4-5-20251001, gemini-2.5-flash
  • 🚀 Hautes performances : gpt-5, claude-opus-4-6-20260320, gemini-3-pro-preview
  • ⚡ Réponse rapide : gemini-2.5-flash, claude-haiku-4-5-20251001
Vous pouvez également sélectionner le mode de basculement pour ajouter plusieurs modèles de secours. Lorsque le modèle principal est indisponible, le système bascule automatiquement vers les modèles de secours.

​
4.3 Configurer le canal de messagerie

Sélectionnez votre plateforme de messagerie et suivez le tutoriel correspondant :

Telegram

Créer un bot Telegram via BotFather

Feishu

Créer un bot d’entreprise Feishu

Discord

Créer un bot de serveur Discord

​
Étape 5 : Liaison par code d’appariement

Après la création et le démarrage de l’instance, complétez la liaison utilisateur via le code d’appariement :
  1. L’utilisateur envoie n’importe quel message au bot sur la plateforme de messagerie
  2. Le bot répond avec un code d’appariement à 8 chiffres (par exemple DFE62DTD)
  3. L’administrateur clique sur le bouton « Code d’appariement » pour cette instance dans l’interface Web
  4. Saisissez le code d’appariement et cliquez sur « Approuver »
  5. L’utilisateur peut désormais utiliser le bot normalement
Astuce : les codes d’appariement sont stockés dans la mémoire du Gateway et expirent après le redémarrage. Si un code expire, demandez simplement à l’utilisateur d’envoyer un nouveau message pour obtenir un nouveau code.

​
Gérer les instances

Dans l’interface de gestion, vous pouvez effectuer les opérations suivantes :

​
Ports et données

​
Ports

​
Répertoires de données

​
FAQ

​
Q1 : Le Manager ne démarre pas ?

Solutions :

​
Q2 : Commande openclaw introuvable ?

Solutions :
  • Le programme détecte et installe automatiquement openclaw CLI au démarrage
  • Si la version est trop ancienne (< 0.1.0), elle sera automatiquement mise à jour
  • Installation manuelle : npm install -g openclaw@latest

​
Q3 : L’instance affiche « arrêté » après le démarrage ?

Solutions :
  • Le Gateway prend quelques secondes pour lier le port, le statut peut sembler temporairement incohérent
  • Actualisez la page pour vérifier le statut le plus récent
  • Vérifiez les journaux du Gateway : ~/.openclaw-<instance-name>/logs/gateway.log

​
Q4 : Le bot Feishu ne répond pas ?

Solutions :
  1. Confirmez que l’abonnement aux événements a ajouté im.message.receive_v1
  2. Confirmez que la méthode d’abonnement est « Connexion longue durée »
  3. Confirmez qu’une nouvelle version a été créée et publiée (requis après chaque modification d’autorisation/d’événement)

​
Q5 : L’approbation du code d’appariement a échoué ?

Solutions :
  • Confirmez que le Gateway est en cours d’exécution
  • Les codes d’appariement sont stockés dans la mémoire du Gateway et expirent après le redémarrage
  • Demandez à l’utilisateur d’envoyer un nouveau message pour obtenir un nouveau code d’appariement

​
Q6 : Comment consulter l’utilisation de l’API et les coûts ?

Connectez-vous à la console APIMart pour consulter :
  • 📊 Statistiques d’appels API
  • 💰 Détails des coûts
  • 📈 Graphiques de tendance d’utilisation

​
Support et aide

Si vous rencontrez des problèmes :

Commencer avec APIMart

Inscrivez-vous à APIMart maintenant, obtenez votre clé API et déployez votre bot IA !