> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Guide de déploiement d'OpenClaw Manager

> Un outil visuel pour le déploiement et la gestion en un clic de passerelles de bots IA OpenClaw, prenant en charge les plateformes Telegram, Feishu et Discord, alimenté par GPT-5, Claude, Gemini et d'autres modèles d'IA via l'API APIMart.

## 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](https://apimart.ai/keys) 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)

<Note>
  **Astuce :** si vous n'avez pas encore de compte APIMart, veuillez vous inscrire sur [APIMart](https://apimart.ai) et obtenir d'abord une clé API.
</Note>

## Étape 1 : Téléchargement

Téléchargez l'exécutable correspondant à votre plateforme depuis [GitHub Releases](https://github.com/zhihong-apimart/OpenClaw-Manager-Releases) :

| Plateforme                | Nom de fichier                     |
| ------------------------- | ---------------------------------- |
| Windows x64               | `openclaw-manager-win-x64.exe`     |
| macOS ARM (Apple Silicon) | `openclaw-manager-macos-arm64.zip` |
| macOS Intel               | `openclaw-manager-macos-x64.zip`   |
| Linux x64                 | `openclaw-manager-linux-x64`       |
| Linux ARM64               | `openclaw-manager-linux-arm64`     |

## Étape 2 : Exécution

<Tabs>
  <Tab title="Windows">
    ### 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

    ```
    Clic droit sur openclaw-manager-win-x64.exe → Exécuter en tant qu'administrateur
    ```

    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

    <Warning>
      **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.
    </Warning>
  </Tab>

  <Tab title="Linux">
    ### Déploiement Linux

    #### Prérequis

    * Ubuntu 20.04+ / Debian 11+ / CentOS 8+ (x64 ou ARM64)
    * Privilèges root (recommandés)

    #### Lancement

    1. Téléchargez et accordez l'autorisation d'exécution :

    ```bash theme={null}
    chmod +x ./openclaw-manager-linux-x64
    ```

    2. **Mode premier plan** (pour les tests) :

    ```bash theme={null}
    ./openclaw-manager-linux-x64
    ```

    3. **Mode arrière-plan** (recommandé pour la production) :

    ```bash theme={null}
    ./openclaw-manager-linux-x64 --daemon
    ```

    #### Gestion du Daemon

    ```bash theme={null}
    # Démarrer en arrière-plan
    ./openclaw-manager-linux-x64 --daemon
    # Ou raccourci
    ./openclaw-manager-linux-x64 -d

    # Vérifier le statut
    ./openclaw-manager-linux-x64 --status

    # Arrêter
    ./openclaw-manager-linux-x64 --stop
    # Ou raccourci
    ./openclaw-manager-linux-x64 -s
    ```

    #### Configuration du pare-feu

    Si l'accès distant est nécessaire, ouvrez les ports suivants :

    ```bash theme={null}
    # Interface Web du Manager
    ufw allow 51942/tcp

    # Ports du Gateway (un par instance, à partir de 18789)
    ufw allow 18789/tcp
    ```

    <Note>
      **Astuce :** sous Linux, le Manager se lie automatiquement à `0.0.0.0`, permettant l'accès distant. Le fichier journal se trouve à `~/openclaw-manager.log`.
    </Note>
  </Tab>

  <Tab title="macOS">
    ### Déploiement macOS

    #### Prérequis

    * macOS 12+ (Apple Silicon ou Intel)

    #### Lancement

    1. Décompressez le fichier zip téléchargé pour obtenir `OpenClaw Manager.app`

    2. Double-cliquez pour exécuter `OpenClaw Manager.app`

    3. La première exécution peut nécessiter des paramètres de sécurité :

    ```
    Réglages système → Confidentialité et sécurité → Autoriser quand même
    ```

    <Note>
      **Astuce :** sur macOS, le Manager se lie à `127.0.0.1` (accès local uniquement). Les commandes daemon sont les mêmes que sous Linux.
    </Note>
  </Tab>
</Tabs>

## Étape 3 : Accéder à l'interface de gestion

Une fois le programme démarré, accédez à l'interface de gestion Web :

```
http://127.0.0.1:51942
```

<Note>
  **Accès distant Linux :** remplacez `127.0.0.1` par l'adresse IP de votre serveur, par exemple `http://votre-ip-serveur:51942`
</Note>

## É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 :**

| ID du modèle                 | Nom                  | Caractéristiques                   |
| ---------------------------- | -------------------- | ---------------------------------- |
| `gpt-5`                      | GPT-5                | Le plus récent et le plus puissant |
| `gpt-5.1`                    | GPT-5.1              | Version améliorée                  |
| `gpt-5.2-codex`              | GPT-5.2 Codex        | Spécialisé dans le code            |
| `gpt-5.2-pro`                | GPT-5.2 Pro          | Version professionnelle            |
| `claude-opus-4-6-20260320`   | Claude Opus 4.6      | Raisonnement le plus puissant      |
| `claude-sonnet-4-6-20260320` | Claude Sonnet 4.6    | Choix équilibré                    |
| `claude-opus-4-5-20251101`   | Claude Opus 4.5      | Raisonnement avancé                |
| `claude-sonnet-4-5-20250929` | Claude Sonnet 4.5    | Excellent pour le code             |
| `claude-haiku-4-5-20251001`  | Claude Haiku 4.5     | Réponse rapide                     |
| `gemini-2.5-flash`           | Gemini 2.5 Flash     | Multimodal rapide                  |
| `gemini-3-pro-preview`       | Gemini 3 Pro Preview | Hautes performances                |

<Tip>
  **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`
</Tip>

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 :

<CardGroup cols={3}>
  <Card title="Telegram" icon="telegram" href="/fr/integrations/platform/openclaw-manager-telegram">
    Créer un bot Telegram via BotFather
  </Card>

  <Card title="Feishu" icon="message" href="/fr/integrations/platform/openclaw-manager-feishu">
    Créer un bot d'entreprise Feishu
  </Card>

  <Card title="Discord" icon="discord" href="/fr/integrations/platform/openclaw-manager-discord">
    Créer un bot de serveur Discord
  </Card>
</CardGroup>

## É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

<Note>
  **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.
</Note>

## Gérer les instances

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

| Action                 | Description                                                                                    |
| ---------------------- | ---------------------------------------------------------------------------------------------- |
| **Démarrer**           | Démarre le processus Gateway, le bot commence à recevoir des messages                          |
| **Arrêter**            | Arrête le processus Gateway                                                                    |
| **Changer de modèle**  | Changer de modèle d'IA en temps réel sans redémarrer le Gateway                                |
| **Code d'appariement** | Approuver les codes d'appariement de nouveaux utilisateurs pour autoriser l'utilisation du bot |
| **Supprimer**          | Arrêter et supprimer l'instance avec toutes les données (irréversible)                         |

## Ports et données

### Ports

| Usage                    | Port                | Adresse de liaison                             |
| ------------------------ | ------------------- | ---------------------------------------------- |
| Interface Web du Manager | `51942`             | Windows/macOS : `127.0.0.1`, Linux : `0.0.0.0` |
| Instance Gateway         | À partir de `18789` | Chaque instance obtient un port unique         |

### Répertoires de données

| Contenu                     | Chemin                                         |
| --------------------------- | ---------------------------------------------- |
| Configuration de l'instance | `~/.openclaw-<instance-name>/openclaw.json`    |
| Journaux du Gateway         | `~/.openclaw-<instance-name>/logs/gateway.log` |
| Journaux du Manager         | `~/openclaw-manager.log` (mode daemon)         |
| PID du Manager              | `~/.openclaw-manager.pid`                      |

## FAQ

### Q1 : Le Manager ne démarre pas ?

**Solutions :**

| Plateforme | Vérification                                                                        |
| ---------- | ----------------------------------------------------------------------------------- |
| Windows    | Confirmer l'exécution en tant qu'administrateur                                     |
| Linux      | Confirmer que le port 51942 n'est pas utilisé (`lsof -i :51942`)                    |
| macOS      | Confirmer que les paramètres de sécurité sont autorisés ou la quarantaine supprimée |
| Tous       | Vérifier les journaux à `~/openclaw-manager.log`                                    |

### 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](https://apimart.ai/overview) 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 :

* 📚 [Documentation APIMart](https://docs.apimart.ai)
* 📚 [OpenClaw Manager GitHub](https://github.com/zhihong-apimart/OpenClaw-Manager)
* 💬 [Communauté Discord](https://discord.gg/V8zqssyZ5c)
* 🐦 [Twitter @APIMart\_](https://x.com/APIMart_)
* 📧 Support technique : [zhihong@apimart.ai](mailto:zhihong@apimart.ai)

***

<Card title="Commencer avec APIMart" icon="rocket" href="https://apimart.ai">
  Inscrivez-vous à APIMart maintenant, obtenez votre clé API et déployez votre bot IA !
</Card>