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

# Appairage

# Appairage

Le « pairing » est l’étape explicite **d’approbation par le propriétaire** d’OpenClaw.
Il est utilisé à deux endroits :

1. **Pairing des messages privés (DM)** (qui est autorisé à parler au bot)
2. **Pairing des nœuds** (quels appareils/nœuds sont autorisés à rejoindre le réseau de la gateway (passerelle))

Contexte de sécurité : [Security](/gateway/security)

## 1. Pairing des messages privés (accès entrant au chat)

Lorsqu’un canal est configuré avec la politique de DM `pairing`, les expéditeurs inconnus reçoivent un code court et leur message n’est **pas traité** tant que vous n’avez pas approuvé.

Les politiques DM par défaut sont documentées dans : [Security](/gateway/security)

Codes de pairing :

* 8 caractères, en majuscules, sans caractères ambigus (`0O1I`).
* **Expirent après 1 heure**. Le bot n’envoie le message de pairing que lorsqu’une nouvelle demande est créée (environ une fois par heure et par expéditeur).
* Les demandes de pairing DM en attente sont limitées par défaut à **3 par canal** ; les demandes supplémentaires sont ignorées jusqu’à ce que l’une expire ou soit approuvée.

### Approuver un expéditeur

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw pairing list telegram
openclaw pairing approve telegram <CODE>
```

Canaux pris en charge : `telegram`, `whatsapp`, `signal`, `imessage`, `discord`, `slack`.

### Où l’état est stocké

Stocké sous `~/.openclaw/credentials/` :

* Demandes en attente : `<channel>-pairing.json`
* Stockage de la liste d’autorisation approuvée : `<channel>-allowFrom.json`

Traitez ces éléments comme sensibles (ils conditionnent l’accès à votre assistant).

## 2. Pairing des appareils nœuds (iOS/Android/macOS/nœuds headless)

Les nœuds se connectent à la Gateway (passerelle) en tant qu’**appareils** avec `role: node`. La Gateway
crée une demande de pairing d’appareil qui doit être approuvée.

### Appairer via Telegram (recommandé pour iOS)

Si vous utilisez le plugin `device-pair`, vous pouvez effectuer le premier appairage de l’appareil entièrement depuis Telegram :

1. Dans Telegram, envoyez un message à votre bot : `/pair`
2. Le bot répond avec deux messages : un message d’instructions et un **code de configuration** séparé (facile à copier/coller dans Telegram).
3. Sur votre téléphone, ouvrez l’app iOS OpenClaw → Settings → Gateway.
4. Collez le code de configuration et connectez-vous.
5. De retour dans Telegram : `/pair approve`

Le code de configuration est une charge utile JSON encodée en base64 qui contient :

* `url`: the Gateway WebSocket URL (`ws://...` or `wss://...`)
* `token`: a short-lived pairing token

Treat the setup code like a password while it is valid.

### Approuver un appareil nœud

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw devices list
openclaw devices approve <requestId>
openclaw devices reject <requestId>
```

### Stockage de l’état de pairing des nœuds

Stocké sous `~/.openclaw/devices/` :

* `pending.json` (de courte durée ; les demandes en attente expirent)
* `paired.json` (appareils appairés + jetons)

### Remarques

* L’API héritée `node.pair.*` (CLI : `openclaw nodes pending/approve`) est un
  stockage de pairing distinct appartenant à la gateway. Les nœuds WS nécessitent toujours le pairing des appareils.

## Documentation associée

* Modèle de sécurité + prompt injection : [Security](/gateway/security)
* Mise à jour en toute sécurité (run doctor) : [Updating](/install/updating)
* Configurations de canaux :
  * Telegram : [Telegram](/channels/telegram)
  * WhatsApp : [WhatsApp](/channels/whatsapp)
  * Signal : [Signal](/channels/signal)
  * BlueBubbles (iMessage) : [BlueBubbles](/channels/bluebubbles)
  * iMessage (hérité) : [iMessage](/channels/imessage)
  * Discord : [Discord](/channels/discord)
  * Slack : [Slack](/channels/slack)