# Comment installer OpenClaw et le connecter à Telegram

Comptez environ une demi-heure pour passer d’une machine vierge à un agent qui vous répond dans Telegram. Les commandes indiquées proviennent de la documentation officielle : vérifiez-les par rapport à la version que vous installez.

## Ce qu’il vous faut

- Un ordinateur ou un VPS sous macOS, Linux, WSL2 ou Windows
- Node 24.16+ ou Node 26, que l’installateur peut ajouter pour vous
- Une clé API ou un abonnement donnant accès à un modèle, ou un modèle local
- Un compte Telegram

## Étape par étape

### 1. Choisir une machine et créer un bot

Un ordinateur portable convient pour un essai. Pour un agent qui fonctionne en permanence, préférez un petit VPS ou un serveur domestique ; le port de la passerelle ne doit jamais être exposé à Internet. Dans Telegram, vérifiez soigneusement le nom d’utilisateur de @BotFather, envoyez-lui un message, exécutez /newbot et copiez le jeton fourni.

### 2. Installer OpenClaw

Exécutez l’installateur officiel correspondant à votre système. Il détecte le système d’exploitation, ajoute Node s’il est absent, installe OpenClaw, puis lance la configuration initiale.

```bash
# macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash

# Windows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iex
```

### 3. Effectuer la configuration initiale et installer le service de passerelle

Choisissez Quick start pour réutiliser l’accès à l’IA détecté, ou Custom setup pour configurer chaque option. Une fois la configuration terminée, arrêtez la passerelle qui s’exécute au premier plan, puis installez-la comme service en arrière-plan afin qu’elle redémarre après un redémarrage de la machine.

```bash
openclaw onboard
# after the quick start, stop the foreground gateway (Ctrl+C), then:
openclaw gateway install
```

### 4. Ajouter le canal Telegram

Ajoutez Telegram comme canal à l’aide du jeton de votre bot. Vérifiez ensuite l’état du canal pour confirmer que la connexion fonctionne.

```bash
openclaw channels add --channel telegram --token <bot-token>
openclaw channels status --probe
```

### 5. Approuvez votre demande d’association

Envoyez n’importe quel message à votre bot. Les expéditeurs inconnus reçoivent un code d’association au lieu d’une réponse. Affichez les demandes en attente et approuvez votre propre code dans l’heure.

```bash
openclaw pairing list telegram
openclaw pairing approve telegram <CODE>
```

### 6. Effectuez un audit et une mise à jour

Lancez l’audit de sécurité intégré et effectuez la mise à jour depuis le canal stable. Les versions antérieures à 2026.4.22 présentent des vulnérabilités critiques connues : ne conservez jamais une telle version.

```bash
openclaw security audit
openclaw update --channel stable
```

## Premières choses à faire après la configuration

- Laissez dmPolicy sur pairing afin que les inconnus qui trouvent votre bot ne puissent pas l’utiliser.
- Configurez les approbations d’exécution pour qu’une confirmation soit toujours demandée, jusqu’à ce que vous ayez confiance en votre configuration.
- Répétez régulièrement l’audit de sécurité et la mise à jour.

## Erreurs fréquentes

- Exposer le port de la passerelle au lieu de laisser gateway.bind sur loopback et de se connecter via SSH ou Tailscale.
- Installer trop de compétences tierces : considérez-les comme des extensions de navigateur et n’en ajoutez que quelques-unes provenant de sources fiables.
- Oublier qu’un agent bloqué dans une boucle continue de consommer des jetons de modèle.