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

# OpenClaw + Telegram

> Connecter OpenClaw à EvoLink.AI

## Présentation

OpenClaw est une passerelle d'agents IA open-source qui sert de pont entre les applications de messagerie et les agents IA. Grâce à un processus Gateway centralisé, elle connecte des plateformes de messagerie comme Telegram, WhatsApp et Discord à des agents de programmation IA, permettant des interactions de programmation IA directement dans les fenêtres de chat.

En configurant **EvoLink API** comme fournisseur de modèles personnalisé dans OpenClaw et en connectant un **Telegram Bot**, vous pouvez utiliser les modèles Claude d'EvoLink (tels que **Claude 4.6 Opus**, **Claude 4.5 Sonnet**, **Claude 4.5 Haiku**) pour des conversations de programmation assistée par IA directement dans Telegram.

**Ce guide couvre :**

* L'installation et la configuration d'OpenClaw Gateway
* La création d'un Telegram Bot et sa connexion à OpenClaw
* La configuration d'EvoLink API comme fournisseur de modèles personnalisé
* La vérification de la connexion et la mise en route

## Vérification de l'Environnement Système

Avant l'installation, il est recommandé d'exécuter l'outil de vérification de l'environnement pour vous assurer que votre système répond aux exigences d'OpenClaw.

### Télécharger l'Outil de Vérification

Téléchargez l'outil de vérification pour votre plateforme depuis [GitHub Releases](https://github.com/suuuuuu-1/openclaw-env-checker/releases) :

| Plateforme            | Nom du fichier                 |
| --------------------- | ------------------------------ |
| Windows               | `openclaw-checker-win-x64.exe` |
| macOS (Intel)         | `openclaw-checker-macos-x64`   |
| macOS (Apple Silicon) | `openclaw-checker-macos-arm64` |
| Linux                 | `openclaw-checker-linux-x64`   |

### Éléments de Vérification

L'outil vérifie automatiquement les éléments suivants :

* ✅ Version de Node.js (>= 22.12.0 requis)
* ✅ npm disponible
* ✅ Git disponible
* ✅ Connectivité réseau (github.com, npmjs.org, evolink.ai)

<img src="https://mintcdn.com/muyutechnology/nIFIx0gxdF53THw8/images/OpenClaw-Checker/check-success.png?fit=max&auto=format&n=nIFIx0gxdF53THw8&q=85&s=46f1fdbec3263845e35158b104fa5091" alt="Exemple de vérification réussie" width="1778" height="1742" data-path="images/OpenClaw-Checker/check-success.png" />

Si la vérification échoue, l'outil fournira des suggestions de correction spécifiques.

## Prérequis

Avant de configurer, assurez-vous d'avoir :

### 1. Installer Node.js

OpenClaw s'installe via npm et nécessite Node.js 22 ou supérieur.

<Tabs>
  <Tab title="Windows">
    Visitez le [site officiel de Node.js](https://nodejs.org/fr/download), téléchargez l'installateur Windows (fichier .msi) et exécutez le programme d'installation.

    Après l'installation, ouvrez PowerShell pour vérifier :

    ```bash theme={null}
    node --version
    npm --version
    ```

    <Note>
      Il est recommandé d'exécuter PowerShell en tant qu'administrateur pour éviter les problèmes de permissions lors de l'installation.
    </Note>
  </Tab>

  <Tab title="macOS">
    **Méthode 1 : Utiliser l'installateur**

    Visitez le [site officiel de Node.js](https://nodejs.org/fr/download), téléchargez l'installateur macOS (fichier .pkg) et exécutez le programme d'installation.

    **Méthode 2 : Utiliser Homebrew**

    ```bash theme={null}
    brew install node
    ```

    Après l'installation, ouvrez le Terminal pour vérifier :

    ```bash theme={null}
    node --version
    npm --version
    ```

    <Note>
      Si vous rencontrez des problèmes de permissions lors de l'installation, vous devrez peut-être ajouter `sudo` avant la commande.
    </Note>
  </Tab>
</Tabs>

### 2. Obtenir une clé API EvoLink

* Connectez-vous au [tableau de bord EvoLink](https://evolink.ai/dashboard)
* Trouvez les clés API dans le tableau de bord, cliquez sur le bouton « Créer une nouvelle clé », puis copiez la clé générée
* La clé API commence généralement par `sk-`

### 3. Préparer un compte Telegram

Vous en aurez besoin pour créer un Bot et tester l'intégration.

## Étape 1 : Installer OpenClaw

Exécutez la commande suivante dans votre terminal :

```bash theme={null}
npm install -g openclaw@latest
```

## Étape 2 : Configuration initiale

Exécutez la commande de configuration initiale. OpenClaw vous guidera à travers la configuration et installera le service daemon en arrière-plan :

```bash theme={null}
openclaw onboard --install-daemon
```

### 1. Confirmer l'installation

Le système affichera un avertissement de risque. Confirmez pour continuer :

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_011629_241.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=fce0ba49fe04129dc943e6f63353595e" alt="Confirm Installation" width="1488" height="1420" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_011629_241.png" />

### 2. Sélectionner le mode d'installation

Lorsque vous êtes invité à choisir un mode d'installation, sélectionnez **Quickstart** :

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_011705_241.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=24fbf84b590649d1fc1d515d2ee50609" alt="Select Quickstart" width="1738" height="1540" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_011705_241.png" />

### 3. Sélectionner le fournisseur

Lorsque vous êtes invité à choisir un fournisseur de modèles, sélectionnez **Skip**. Nous configurerons manuellement EvoLink comme fournisseur personnalisé plus tard :

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_011742_033.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=a4f74b3bb72312ba426ea37179232576" alt="Skip Provider Selection" width="1398" height="1272" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_011742_033.png" />

### 4. Sélectionner les modèles

Lorsque vous êtes invité à choisir les modèles à activer, sélectionnez **All** :

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_011808_857.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=701f58ca7164b7830cef3bfb713d911b" alt="Select All Models" width="1380" height="1528" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_011808_857.png" />

### 5. Sélectionner le modèle par défaut

Lorsque vous êtes invité à choisir un modèle par défaut, sélectionnez **Keep current** :

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_011825_375.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=5ded0a9c44fd991865dbe84195862563" alt="Keep Current Model" width="1334" height="1792" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_011825_375.png" />

## Étape 3 : Créer un Telegram Bot

Le flux de configuration initiale vous invitera à sélectionner un canal de messagerie. Sélectionnez **Telegram (Bot API)**.

### 1. Visiter BotFather

Ouvrez Telegram et visitez [@BotFather](https://t.me/BotFather), puis cliquez sur **START BOT** pour commencer :

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_023944_999.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=8675eaaf4ede6e09eb9256830d780e48" alt="Start BotFather" width="652" height="638" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_023944_999.png" />

### 2. Créer le Bot

Tapez `/start` dans le chat. BotFather répondra avec une liste de commandes disponibles :

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/85be2352-3788-4d21-815e-6a46b2754ca7.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=6b15bf8fa069553fed472e3177d66c34" alt="Type /start" width="1798" height="1794" data-path="images/OpenClaw-Telegram/85be2352-3788-4d21-815e-6a46b2754ca7.png" />

Tapez `/newbot`. Suivez les instructions pour définir un **nom d'utilisateur de Bot** unique qui doit se terminer par `bot` (par exemple, `my_evolink_bot`).

Une fois créé, BotFather renverra un message contenant un **Token** dans ce format :

```
123456789:ABCdefGHIjklMNOpqrsTUVwxyz
```

Copiez et enregistrez ce Token.

### 3. Saisir le Token

Retournez au flux de configuration initiale dans le terminal, collez le Token du Bot dans l'invite et confirmez :

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_015805_685.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=235c62263e926bd698f3497f059da6cd" alt="Enter Token" width="1556" height="1758" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_015805_685.png" />

### 4. Redémarrer le Gateway

Après avoir saisi le Token, redémarrez le Gateway pour appliquer la configuration :

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/510f6a5a-8d41-41f7-9277-35486140cb78.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=8e73a3402f695359d1a3008f7d884854" alt="Restart Gateway" width="1382" height="1304" data-path="images/OpenClaw-Telegram/510f6a5a-8d41-41f7-9277-35486140cb78.png" />

## Étape 4 : Configurer EvoLink API

### 1. Localiser le fichier de configuration

Localisez le fichier de configuration `openclaw.json` dans le répertoire d'installation d'OpenClaw et ouvrez-le pour le modifier :

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ed6bc6af-f91c-4739-9e87-8710510d978b.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=34387862e93b16404ffbe19ea0ec5ea2" alt="Locate Config File" width="582" height="438" data-path="images/OpenClaw-Telegram/ed6bc6af-f91c-4739-9e87-8710510d978b.png" />

### 2. Configurer le fournisseur de modèles

Dans `openclaw.json`, trouvez le champ `models` et ajoutez EvoLink comme fournisseur de modèles personnalisé :

```json theme={null}
"models": {
  "providers": {
    "evolink-anthropic": {
      "api": "anthropic-messages",
      "baseUrl": "https://direct.evolink.ai",
      "apiKey": "your-evolink-api-key",
      "models": [
        { "id": "claude-fable-5", "name": "Claude Fable 5" },
        { "id": "claude-opus-4-8", "name": "Claude Opus 4.8" },
        { "id": "claude-opus-4-7", "name": "Claude Opus 4.7" },
        { "id": "claude-opus-4-6", "name": "Claude Opus 4.6" },
        { "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" },
        { "id": "claude-sonnet-5", "name": "Claude Sonnet 5" },
        { "id": "claude-opus-4-5-20251101", "name": "Claude Opus 4.5" },
        { "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5" },
        { "id": "claude-haiku-4-5-20251001", "name": "Claude Haiku 4.5" }
      ]
    },
    "evolink-google": {
      "api": "google-generative-ai",
      "baseUrl": "https://direct.evolink.ai/v1beta",
      "apiKey": "your-evolink-api-key",
      "models": [
        { "id": "gemini-3.1-flash-lite-preview", "name": "Gemini 3.1 Flash Lite" },
        { "id": "gemini-3.1-pro-preview", "name": "Gemini 3.1 Pro" },
        { "id": "gemini-2.5-pro", "name": "Gemini 2.5 Pro" },
        { "id": "gemini-2.5-flash", "name": "Gemini 2.5 Flash" },
        { "id": "gemini-3-pro-preview", "name": "Gemini 3.0 Pro" },
        { "id": "gemini-3-flash-preview", "name": "Gemini 3.0 Flash" }
      ]
    },
    "evolink-openai": {
      "api": "openai-completions",
      "baseUrl": "https://direct.evolink.ai/v1",
      "apiKey": "your-evolink-api-key",
      "models": [
        { "id": "gpt-5.4", "name": "GPT-5.4" },
        { "id": "gpt-5.2", "name": "GPT-5.2" },
        { "id": "gpt-5.1", "name": "GPT-5.1" },
        { "id": "gpt-5.1-chat", "name": "GPT-5.1 Chat" },
        { "id": "gpt-5.1-thinking", "name": "GPT-5.1 Thinking" },
        { "id": "gemini-2.5-pro", "name": "Gemini 2.5 Pro (OpenAI SDK)" },
        { "id": "gemini-2.5-flash", "name": "Gemini 2.5 Flash (OpenAI SDK)" },
        { "id": "gemini-3-pro-preview", "name": "Gemini 3.0 Pro (OpenAI SDK)" },
        { "id": "gemini-3-flash-preview", "name": "Gemini 3.0 Flash (OpenAI SDK)" },
        { "id": "doubao-seed-2.0-pro", "name": "Doubao Seed 2.0 Pro" },
        { "id": "doubao-seed-2.0-lite", "name": "Doubao Seed 2.0 Lite" },
        { "id": "doubao-seed-2.0-mini", "name": "Doubao Seed 2.0 Mini" },
        { "id": "doubao-seed-2.0-code", "name": "Doubao Seed 2.0 Code" },
        { "id": "kimi-k2-thinking", "name": "Kimi K2 Thinking" },
        { "id": "kimi-k2-thinking-turbo", "name": "Kimi K2 Thinking Turbo" }
      ]
    }
  }
}
```

<Warning>
  Remplacez `"your-evolink-api-key"` par la clé API réelle de votre [tableau de bord EvoLink](https://evolink.ai/dashboard).
</Warning>

<img src="https://mintcdn.com/muyutechnology/UXWm3z0MosVoxl9R/images/OpenClaw-Telegram/b362e8be-3a83-47ea-b84c-5fcfb5658e7f.png?fit=max&auto=format&n=UXWm3z0MosVoxl9R&q=85&s=fff12fc55f7b8c56ff4d21189d305ffb" alt="Configure Model" width="823" height="571" data-path="images/OpenClaw-Telegram/b362e8be-3a83-47ea-b84c-5fcfb5658e7f.png" />

### 3. Configurer le modèle par défaut

Dans le champ `agents`, définissez `model.primary` sur le modèle EvoLink que vous venez d'ajouter :

```json theme={null}
"model": {
  "primary": "evolink-anthropic/claude-opus-4-6"
}
```

<img src="https://mintcdn.com/muyutechnology/vltN_QIDGKI6Yi2Q/images/OpenClaw-Telegram/78216831-b8da-43c3-b507-f13bba880504.png?fit=max&auto=format&n=vltN_QIDGKI6Yi2Q&q=85&s=588ceb46be9278f00bc95432fcce503d" alt="Configure Default Model" width="1010" height="582" data-path="images/OpenClaw-Telegram/78216831-b8da-43c3-b507-f13bba880504.png" />

### 4. Vérifier la configuration Telegram

Vérifiez la configuration Telegram dans le champ `channels`. Le `botToken` a été automatiquement rempli lors de la configuration initiale et n'a pas besoin d'être modifié :

```json theme={null}
"channels": {
  "telegram": {
    "enabled": true,
    "botToken": "your-bot-token (auto-filled)",
    "dmPolicy": "pairing",
    "groups": { "*": { "requireMention": true } }
  }
}
```

* `enabled` : Activer le canal Telegram
* `dmPolicy` : Défini sur `"pairing"`, les utilisateurs non autorisés doivent se vérifier via un code d'appairage lors de l'envoi de messages directs
* `groups` : `"*"` autorise tous les groupes, `requireMention` défini sur `true` signifie que le Bot ne répond que lorsqu'il est @mentionné dans les groupes

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/0bde6676-6a12-4073-ba74-e2b60986e8c3.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=bb28d72954c216850a5556a7be7e65a2" alt="Telegram Configuration" width="1190" height="334" data-path="images/OpenClaw-Telegram/0bde6676-6a12-4073-ba74-e2b60986e8c3.png" />

## Étape 5 : Vérifier la connexion

### 1. Visiter votre Bot

Recherchez le nom d'utilisateur du Bot que vous venez de créer dans Telegram et ouvrez le chat :

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/TelegramOpenBot.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=085f0c8e0eaac4a216a0a9999a5f96f2" alt="Visit Bot" width="1644" height="790" data-path="images/OpenClaw-Telegram/TelegramOpenBot.png" />

### 2. Obtenir le code d'appairage

Envoyez `/start` au Bot. Il renverra un code d'appairage :

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/TelegramOpenBot2.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=9241dae6649b8baf3118638f6975ea51" alt="Get Pairing Code" width="1040" height="608" data-path="images/OpenClaw-Telegram/TelegramOpenBot2.png" />

### 3. Compléter l'appairage

Ouvrez une **nouvelle fenêtre de terminal** et exécutez la commande suivante pour compléter l'appairage :

```bash theme={null}
openclaw pairing approve telegram <pairing-code>
```

<Warning>
  Remplacez `<pairing-code>` par le code réel renvoyé par le Bot. Assurez-vous de supprimer les chevrons `<>`.
</Warning>

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_021312_775.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=7ace56164fe3f81ed973e60e471343e0" alt="Complete Pairing" width="1988" height="274" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_021312_775.png" />

### 4. Tester la connexion

Retournez à la fenêtre de terminal d'origine et tapez ce qui suit pour tester si la connexion fonctionne :

```
Wake up, my friend!
```

<img src="https://mintcdn.com/muyutechnology/vltN_QIDGKI6Yi2Q/images/OpenClaw-Telegram/ScreenShot_2026-02-08_020627_904.png?fit=max&auto=format&n=vltN_QIDGKI6Yi2Q&q=85&s=cd3be1b55d8d636ed0e8fbab04ec3da2" alt="Test Connection" width="6336" height="2688" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_020627_904.png" />

Une fois l'appairage terminé, l'envoi de messages au Bot dans Telegram recevra également des réponses IA, confirmant que l'intégration est réussie.
