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

# FAQ : configuration au premier lancement

Démarrage rapide et questions-réponses de première exécution. Pour les opérations courantes, les modèles, l’authentification, les sessions
et le dépannage, consultez la [FAQ](/fr/help/faq) principale.

## Démarrage rapide et configuration de première exécution

<AccordionGroup>
  <Accordion title="Je suis bloqué, le moyen le plus rapide de débloquer la situation">
    Utilisez un agent IA local qui peut **voir votre machine**. C’est beaucoup plus efficace que de demander
    dans Discord, car la plupart des cas « je suis bloqué » sont des **problèmes de configuration locale ou d’environnement** que
    les personnes aidant à distance ne peuvent pas inspecter.

    * **Claude Code** : [https://www.anthropic.com/claude-code/](https://www.anthropic.com/claude-code/)
    * **OpenAI Codex** : [https://openai.com/codex/](https://openai.com/codex/)

    Ces outils peuvent lire le dépôt, exécuter des commandes, inspecter les journaux et aider à corriger votre configuration
    au niveau de la machine (PATH, services, autorisations, fichiers d’authentification). Donnez-leur le **checkout source complet** via
    l’installation modifiable (git) :

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
    ```

    Cela installe OpenClaw **depuis un checkout git**, afin que l’agent puisse lire le code + la documentation et
    raisonner sur la version exacte que vous exécutez. Vous pouvez toujours revenir à la version stable plus tard
    en relançant l’installateur sans `--install-method git`.

    Conseil : demandez à l’agent de **planifier et superviser** la correction (étape par étape), puis d’exécuter uniquement les
    commandes nécessaires. Cela limite les changements et les rend plus faciles à auditer.

    Si vous découvrez un vrai bug ou une correction, veuillez ouvrir une issue GitHub ou envoyer une PR :
    [https://github.com/openclaw/openclaw/issues](https://github.com/openclaw/openclaw/issues)
    [https://github.com/openclaw/openclaw/pulls](https://github.com/openclaw/openclaw/pulls)

    Commencez par ces commandes (partagez les sorties lorsque vous demandez de l’aide) :

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw status
    openclaw models status
    openclaw doctor
    ```

    Ce qu’elles font :

    * `openclaw status` : instantané rapide de l’état du gateway/de l’agent + configuration de base.
    * `openclaw models status` : vérifie l’authentification des fournisseurs + la disponibilité des modèles.
    * `openclaw doctor` : valide et répare les problèmes courants de configuration/d’état.

    Autres vérifications CLI utiles : `openclaw status --all`, `openclaw logs --follow`,
    `openclaw gateway status`, `openclaw health --verbose`.

    Boucle de débogage rapide : [Les 60 premières secondes si quelque chose est cassé](/fr/help/faq#first-60-seconds-if-something-is-broken).
    Documentation d’installation : [Installation](/fr/install), [Options de l’installateur](/fr/install/installer), [Mise à jour](/fr/install/updating).
  </Accordion>

  <Accordion title="Heartbeat continue d’être ignoré. Que signifient les raisons d’ignorance ?">
    Raisons courantes d’ignorance de Heartbeat :

    * `quiet-hours` : en dehors de la fenêtre d’heures actives configurée
    * `empty-heartbeat-file` : `HEARTBEAT.md` existe, mais ne contient que des lignes vides, commentaires, en-têtes, fences ou échafaudages de checklists vides
    * `no-tasks-due` : le mode tâche de `HEARTBEAT.md` est actif, mais aucun intervalle de tâche n’est encore arrivé à échéance
    * `alerts-disabled` : toute la visibilité de Heartbeat est désactivée (`showOk`, `showAlerts` et `useIndicator` sont tous désactivés)

    En mode tâche, les horodatages d’échéance ne sont avancés qu’après l’exécution complète
    d’un vrai Heartbeat. Les exécutions ignorées ne marquent pas les tâches comme terminées.

    Documentation : [Heartbeat](/fr/gateway/heartbeat), [Automatisation](/fr/automation).
  </Accordion>

  <Accordion title="Méthode recommandée pour installer et configurer OpenClaw">
    Le dépôt recommande d’exécuter depuis les sources et d’utiliser l’onboarding :

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    curl -fsSL https://openclaw.ai/install.sh | bash
    openclaw onboard --install-daemon
    ```

    L’assistant peut aussi générer automatiquement les ressources de l’interface. Après l’onboarding, vous exécutez généralement le Gateway sur le port **18789**.

    Depuis les sources (contributeurs/dev) :

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    git clone https://github.com/openclaw/openclaw.git
    cd openclaw
    pnpm install
    pnpm build
    pnpm ui:build
    openclaw onboard
    ```

    Si vous n’avez pas encore d’installation globale, exécutez-la via `pnpm openclaw onboard`.
  </Accordion>

  <Accordion title="Comment ouvrir le tableau de bord après l’onboarding ?">
    L’assistant ouvre votre navigateur avec une URL de tableau de bord propre (sans token) juste après l’onboarding et affiche aussi le lien dans le résumé. Gardez cet onglet ouvert ; s’il ne s’est pas lancé, copiez/collez l’URL affichée sur la même machine.
  </Accordion>

  <Accordion title="Comment authentifier le tableau de bord sur localhost ou à distance ?">
    **Localhost (même machine) :**

    * Ouvrez `http://127.0.0.1:18789/`.
    * S’il demande une authentification par secret partagé, collez le token ou le mot de passe configuré dans les paramètres de Control UI.
    * Source du token : `gateway.auth.token` (ou `OPENCLAW_GATEWAY_TOKEN`).
    * Source du mot de passe : `gateway.auth.password` (ou `OPENCLAW_GATEWAY_PASSWORD`).
    * Si aucun secret partagé n’est encore configuré, générez un token avec `openclaw doctor --generate-gateway-token`.

    **Pas sur localhost :**

    * **Tailscale Serve** (recommandé) : conservez la liaison sur loopback, exécutez `openclaw gateway --tailscale serve`, ouvrez `https://<magicdns>/`. Si `gateway.auth.allowTailscale` vaut `true`, les en-têtes d’identité satisfont l’authentification Control UI/WebSocket (pas de secret partagé à coller, suppose un hôte gateway de confiance) ; les API HTTP exigent toujours l’authentification par secret partagé, sauf si vous utilisez délibérément l’ingress privé `none` ou l’authentification HTTP par proxy de confiance.
      Les mauvaises tentatives simultanées d’authentification Serve depuis le même client sont sérialisées avant que le limiteur d’échecs d’authentification ne les enregistre, donc la deuxième mauvaise nouvelle tentative peut déjà afficher `retry later`.
    * **Liaison Tailnet** : exécutez `openclaw gateway --bind tailnet --token "<token>"` (ou configurez l’authentification par mot de passe), ouvrez `http://<tailscale-ip>:18789/`, puis collez le secret partagé correspondant dans les paramètres du tableau de bord.
    * **Proxy inverse tenant compte de l’identité** : gardez le Gateway derrière un proxy de confiance, configurez `gateway.auth.mode: "trusted-proxy"`, puis ouvrez l’URL du proxy. Les proxys loopback sur le même hôte nécessitent `gateway.auth.trustedProxy.allowLoopback = true` explicitement.
    * **Tunnel SSH** : `ssh -N -L 18789:127.0.0.1:18789 user@host`, puis ouvrez `http://127.0.0.1:18789/`. L’authentification par secret partagé s’applique toujours via le tunnel ; collez le token ou mot de passe configuré si demandé.

    Consultez [Tableau de bord](/fr/web/dashboard) et [Surfaces Web](/fr/web) pour les modes de liaison et les détails d’authentification.
  </Accordion>

  <Accordion title="Pourquoi y a-t-il deux configurations d’approbation exec pour les approbations par chat ?">
    Elles contrôlent différentes couches :

    * `approvals.exec` : transfère les demandes d’approbation vers les destinations de chat
    * `channels.<channel>.execApprovals` : fait agir ce canal comme client d’approbation natif pour les approbations exec

    La politique exec de l’hôte reste la véritable barrière d’approbation. La configuration du chat contrôle seulement où les
    demandes d’approbation apparaissent et comment les personnes peuvent y répondre.

    Dans la plupart des configurations, vous n’avez **pas** besoin des deux :

    * Si le chat prend déjà en charge les commandes et les réponses, `/approve` dans le même chat fonctionne via le chemin partagé.
    * Si un canal natif pris en charge peut inférer les approbateurs en toute sécurité, OpenClaw active désormais automatiquement les approbations natives DM-first quand `channels.<channel>.execApprovals.enabled` est absent ou vaut `"auto"`.
    * Lorsque des cartes/boutons d’approbation natifs sont disponibles, cette interface native est le chemin principal ; l’agent ne devrait inclure une commande `/approve` manuelle que si le résultat de l’outil indique que les approbations par chat sont indisponibles ou que l’approbation manuelle est le seul chemin.
    * Utilisez `approvals.exec` uniquement lorsque les demandes doivent aussi être transférées à d’autres chats ou salles d’exploitation explicites.
    * Utilisez `channels.<channel>.execApprovals.target: "channel"` ou `"both"` uniquement lorsque vous voulez explicitement que les demandes d’approbation soient publiées dans la salle/le sujet d’origine.
    * Les approbations de Plugin sont séparées elles aussi : elles utilisent `/approve` dans le même chat par défaut, le transfert optionnel `approvals.plugin`, et seuls certains canaux natifs conservent la gestion native des approbations de Plugin par-dessus.

    Version courte : le transfert sert au routage, la configuration du client natif sert à une UX plus riche propre au canal.
    Consultez [Approbations exec](/fr/tools/exec-approvals).
  </Accordion>

  <Accordion title="Quel runtime me faut-il ?">
    Node **>= 22** est requis. `pnpm` est recommandé. Bun n’est **pas recommandé** pour le Gateway.
  </Accordion>

  <Accordion title="Fonctionne-t-il sur Raspberry Pi ?">
    Oui. Le Gateway est léger : la documentation indique que **512 Mo à 1 Go de RAM**, **1 cœur** et environ **500 Mo**
    de disque suffisent pour un usage personnel, et précise qu’un **Raspberry Pi 4 peut l’exécuter**.

    Si vous voulez plus de marge (journaux, médias, autres services), **2 Go sont recommandés**, mais ce n’est
    pas un minimum strict.

    Conseil : un petit Raspberry Pi/VPS peut héberger le Gateway, et vous pouvez associer des **nœuds** sur votre ordinateur portable/téléphone pour
    l’écran/la caméra/le canevas locaux ou l’exécution de commandes. Consultez [Nœuds](/fr/nodes).
  </Accordion>

  <Accordion title="Des conseils pour les installations sur Raspberry Pi ?">
    Version courte : cela fonctionne, mais attendez-vous à quelques aspérités.

    * Utilisez un OS **64 bits** et conservez Node >= 22.
    * Préférez l’**installation modifiable (git)** pour voir les journaux et mettre à jour rapidement.
    * Commencez sans canaux/Skills, puis ajoutez-les un par un.
    * Si vous rencontrez des problèmes binaires étranges, il s’agit généralement d’un problème de **compatibilité ARM**.

    Documentation : [Linux](/fr/platforms/linux), [Installation](/fr/install).
  </Accordion>

  <Accordion title="C’est bloqué sur wake up my friend / l’onboarding n’éclot pas. Que faire ?">
    Cet écran dépend de l’accessibilité et de l’authentification du Gateway. Le TUI envoie aussi
    « Wake up, my friend! » automatiquement lors de la première éclosion. Si vous voyez cette ligne avec **aucune réponse**
    et que les tokens restent à 0, l’agent ne s’est jamais exécuté.

    1. Redémarrez le Gateway :

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw gateway restart
    ```

    2. Vérifiez l’état + l’authentification :

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw status
    openclaw models status
    openclaw logs --follow
    ```

    3. Si cela bloque toujours, exécutez :

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw doctor
    ```

    Si le Gateway est distant, assurez-vous que le tunnel/la connexion Tailscale est actif et que l’interface
    pointe vers le bon Gateway. Consultez [Accès distant](/fr/gateway/remote).
  </Accordion>

  <Accordion title="Puis-je migrer ma configuration vers une nouvelle machine (Mac mini) sans refaire l’onboarding ?">
    Oui. Copiez le **répertoire d’état** et l’**espace de travail**, puis exécutez Doctor une fois. Cela
    garde votre bot « exactement identique » (mémoire, historique de session, authentification et état des canaux)
    tant que vous copiez **les deux** emplacements :

    1. Installez OpenClaw sur la nouvelle machine.
    2. Copiez `$OPENCLAW_STATE_DIR` (par défaut : `~/.openclaw`) depuis l’ancienne machine.
    3. Copiez votre espace de travail (par défaut : `~/.openclaw/workspace`).
    4. Exécutez `openclaw doctor` et redémarrez le service Gateway.

    Cela préserve la configuration, les profils d’authentification, les identifiants WhatsApp, les sessions et la mémoire. Si vous êtes en
    mode distant, rappelez-vous que l’hôte du gateway possède le magasin de sessions et l’espace de travail.

    **Important :** si vous ne committez/pushez que votre espace de travail vers GitHub, vous sauvegardez
    les **fichiers de mémoire + bootstrap**, mais **pas** l’historique de session ni l’authentification. Ils se trouvent
    sous `~/.openclaw/` (par exemple `~/.openclaw/agents/<agentId>/sessions/`).

    Lié : [Migration](/fr/install/migrating), [Emplacement des éléments sur le disque](/fr/help/faq#where-things-live-on-disk),
    [Espace de travail de l’agent](/fr/concepts/agent-workspace), [Doctor](/fr/gateway/doctor),
    [Mode distant](/fr/gateway/remote).
  </Accordion>

  <Accordion title="Où voir les nouveautés de la dernière version ?">
    Consultez le journal des changements GitHub :
    [https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md](https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md)

    Les entrées les plus récentes sont en haut. Si la section supérieure est marquée **Unreleased**, la section datée
    suivante est la dernière version publiée. Les entrées sont regroupées par **Points forts**, **Changements** et
    **Correctifs** (plus des sections documentation/autres si nécessaire).
  </Accordion>

  <Accordion title="Impossible d’accéder à docs.openclaw.ai (erreur SSL)">
    Certaines connexions Comcast/Xfinity bloquent incorrectement `docs.openclaw.ai` via Xfinity
    Advanced Security. Désactivez-le ou ajoutez `docs.openclaw.ai` à la liste d’autorisation, puis réessayez.
    Aidez-nous à le débloquer en signalant le problème ici : [https://spa.xfinity.com/check\_url\_status](https://spa.xfinity.com/check_url_status).

    Si vous ne parvenez toujours pas à accéder au site, les docs sont mises en miroir sur GitHub :
    [https://github.com/openclaw/openclaw/tree/main/docs](https://github.com/openclaw/openclaw/tree/main/docs)
  </Accordion>

  <Accordion title="Différence entre stable et beta">
    **Stable** et **beta** sont des **dist-tags npm**, pas des lignes de code séparées :

    * `latest` = stable
    * `beta` = version préliminaire pour les tests

    En général, une version stable arrive d’abord sur **beta**, puis une étape explicite
    de promotion déplace cette même version vers `latest`. Les mainteneurs peuvent aussi
    publier directement vers `latest` si nécessaire. C’est pourquoi beta et stable peuvent
    pointer vers la **même version** après promotion.

    Voir ce qui a changé :
    [https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md](https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md)

    Pour les commandes d’installation en une ligne et la différence entre beta et dev, consultez l’accordéon ci-dessous.
  </Accordion>

  <Accordion title="Comment installer la version beta et quelle est la différence entre beta et dev ?">
    **Beta** est le dist-tag npm `beta` (peut correspondre à `latest` après promotion).
    **Dev** est la tête mouvante de `main` (git) ; lorsqu’elle est publiée, elle utilise le dist-tag npm `dev`.

    Commandes en une ligne (macOS/Linux) :

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --beta
    ```

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git
    ```

    Programme d’installation Windows (PowerShell) :
    [https://openclaw.ai/install.ps1](https://openclaw.ai/install.ps1)

    Plus de détails : [Canaux de développement](/fr/install/development-channels) et [Indicateurs du programme d’installation](/fr/install/installer).
  </Accordion>

  <Accordion title="Comment essayer les tout derniers éléments ?">
    Deux options :

    1. **Canal dev (checkout git) :**

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw update --channel dev
    ```

    Cela bascule vers la branche `main` et met à jour depuis la source.

    2. **Installation modifiable (depuis le site du programme d’installation) :**

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
    ```

    Cela vous donne un dépôt local que vous pouvez modifier, puis mettre à jour via git.

    Si vous préférez un clone propre manuel, utilisez :

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    git clone https://github.com/openclaw/openclaw.git
    cd openclaw
    pnpm install
    pnpm build
    ```

    Docs : [Update](/fr/cli/update), [Canaux de développement](/fr/install/development-channels),
    [Install](/fr/install).
  </Accordion>

  <Accordion title="Combien de temps l’installation et l’onboarding prennent-ils généralement ?">
    Guide approximatif :

    * **Installation :** 2 à 5 minutes
    * **Onboarding QuickStart :** généralement quelques minutes
    * **Onboarding complet :** plus long lorsque la connexion au fournisseur, l’association d’un canal, l’installation du daemon,
      les téléchargements réseau, les skills ou les plugins facultatifs nécessitent une configuration supplémentaire

    L’assistant CLI affiche cette chronologie dès le départ. Vous pouvez ignorer les étapes facultatives et revenir
    plus tard avec `openclaw configure`.

    Si cela se bloque, utilisez [Programme d’installation bloqué](#quick-start-and-first-run-setup)
    et la boucle de débogage rapide dans [Je suis bloqué](#quick-start-and-first-run-setup).
  </Accordion>

  <Accordion title="Programme d’installation bloqué ? Comment obtenir plus de retour ?">
    Relancez le programme d’installation avec une **sortie détaillée** :

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    curl -fsSL https://openclaw.ai/install.sh | bash -s -- --verbose
    ```

    Installation beta avec sortie détaillée :

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    curl -fsSL https://openclaw.ai/install.sh | bash -s -- --beta --verbose
    ```

    Pour une installation modifiable (git) :

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --verbose
    ```

    Équivalent Windows (PowerShell) :

    ```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
    # install.ps1 has no dedicated -Verbose flag yet.
    Set-PSDebug -Trace 1
    & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
    Set-PSDebug -Trace 0
    ```

    Plus d’options : [Indicateurs du programme d’installation](/fr/install/installer).
  </Accordion>

  <Accordion title="L’installation Windows indique que git est introuvable ou que openclaw n’est pas reconnu">
    Deux problèmes Windows courants :

    **1) erreur npm spawn git / git introuvable**

    * Installez **Git for Windows** et assurez-vous que `git` est dans votre PATH.
    * Fermez puis rouvrez PowerShell, puis relancez le programme d’installation.

    **2) openclaw n’est pas reconnu après l’installation**

    * Votre dossier global bin npm n’est pas dans PATH.

    * Vérifiez le chemin :

      ```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
      npm config get prefix
      ```

    * Ajoutez ce répertoire à votre PATH utilisateur (aucun suffixe `\bin` n’est nécessaire sous Windows ; sur la plupart des systèmes, il s’agit de `%AppData%\npm`).

    * Fermez puis rouvrez PowerShell après avoir mis à jour PATH.

    Pour la configuration desktop, utilisez l’application native **Windows Hub**. Pour une configuration uniquement en terminal,
    le programme d’installation PowerShell et les chemins Gateway WSL2 sont tous deux pris en charge.
    Docs : [Windows](/fr/platforms/windows).
  </Accordion>

  <Accordion title="La sortie d’exécution Windows affiche du texte chinois illisible - que dois-je faire ?">
    Il s’agit généralement d’une incompatibilité de page de code de console dans les shells Windows natifs.

    Symptômes :

    * La sortie `system.run`/`exec` affiche le chinois sous forme de mojibake
    * La même commande s’affiche correctement dans un autre profil de terminal

    Solution de contournement rapide dans PowerShell :

    ```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
    chcp 65001
    [Console]::InputEncoding = [System.Text.UTF8Encoding]::new($false)
    [Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false)
    $OutputEncoding = [System.Text.UTF8Encoding]::new($false)
    ```

    Redémarrez ensuite le Gateway et réessayez votre commande :

    ```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw gateway restart
    ```

    Si vous reproduisez toujours cela sur la dernière version d’OpenClaw, suivez/signalez-le dans :

    * [Issue #30640](https://github.com/openclaw/openclaw/issues/30640)
  </Accordion>

  <Accordion title="Les docs n’ont pas répondu à ma question - comment obtenir une meilleure réponse ?">
    Utilisez l’**installation modifiable (git)** afin d’avoir l’intégralité de la source et des docs localement, puis demandez
    à votre bot (ou Claude/Codex) *depuis ce dossier* afin qu’il puisse lire le dépôt et répondre précisément.

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
    ```

    Plus de détails : [Install](/fr/install) et [Indicateurs du programme d’installation](/fr/install/installer).
  </Accordion>

  <Accordion title="Comment installer OpenClaw sur Linux ?">
    Réponse courte : suivez le guide Linux, puis lancez l’onboarding.

    * Chemin rapide Linux + installation du service : [Linux](/fr/platforms/linux).
    * Guide complet : [Bien démarrer](/fr/start/getting-started).
    * Programme d’installation + mises à jour : [Installation et mises à jour](/fr/install/updating).
  </Accordion>

  <Accordion title="Comment installer OpenClaw sur un VPS ?">
    N’importe quel VPS Linux fonctionne. Installez sur le serveur, puis utilisez SSH/Tailscale pour accéder au Gateway.

    Guides : [exe.dev](/fr/install/exe-dev), [Hetzner](/fr/install/hetzner), [Fly.io](/fr/install/fly).
    Accès à distance : [Gateway distant](/fr/gateway/remote).
  </Accordion>

  <Accordion title="Où se trouvent les guides d’installation cloud/VPS ?">
    Nous maintenons un **hub d’hébergement** avec les fournisseurs courants. Choisissez-en un et suivez le guide :

    * [Hébergement VPS](/fr/vps) (tous les fournisseurs au même endroit)
    * [Fly.io](/fr/install/fly)
    * [Hetzner](/fr/install/hetzner)
    * [exe.dev](/fr/install/exe-dev)

    Fonctionnement dans le cloud : le **Gateway s’exécute sur le serveur**, et vous y accédez
    depuis votre ordinateur portable/téléphone via la Control UI (ou Tailscale/SSH). Votre état + espace de travail
    résident sur le serveur ; traitez donc l’hôte comme la source de vérité et sauvegardez-le.

    Vous pouvez associer des **nodes** (Mac/iOS/Android/headless) à ce Gateway cloud pour accéder
    à l’écran/la caméra/le canvas local ou exécuter des commandes sur votre ordinateur portable tout en conservant le
    Gateway dans le cloud.

    Hub : [Platforms](/fr/platforms). Accès à distance : [Gateway distant](/fr/gateway/remote).
    Nodes : [Nodes](/fr/nodes), [Nodes CLI](/fr/cli/nodes).
  </Accordion>

  <Accordion title="Puis-je demander à OpenClaw de se mettre à jour lui-même ?">
    Réponse courte : **possible, non recommandé**. Le flux de mise à jour peut redémarrer le
    Gateway (ce qui interrompt la session active), peut nécessiter un checkout git propre et
    peut demander une confirmation. Plus sûr : exécutez les mises à jour depuis un shell en tant qu’opérateur.

    Utilisez la CLI :

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw update
    openclaw update status
    openclaw update --channel stable|beta|dev
    openclaw update --tag <dist-tag|version>
    openclaw update --no-restart
    ```

    Si vous devez automatiser depuis un agent :

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw update --yes --no-restart
    openclaw gateway restart
    ```

    Docs : [Update](/fr/cli/update), [Mise à jour](/fr/install/updating).
  </Accordion>

  <Accordion title="Que fait réellement l’onboarding ?">
    `openclaw onboard` est le parcours de configuration recommandé. En **mode local**, il vous guide à travers :

    * **Configuration modèle/auth** (OAuth fournisseur, clés d’API, setup-token Anthropic, ainsi que les options de modèle local comme LM Studio)
    * Emplacement de l’**espace de travail** + fichiers d’amorçage
    * **Paramètres du Gateway** (bind/port/auth/tailscale)
    * **Canaux** (WhatsApp, Telegram, Discord, Mattermost, Signal, iMessage, ainsi que les plugins de canal groupés comme QQ Bot)
    * **Installation du daemon** (LaunchAgent sur macOS ; unité utilisateur systemd sur Linux/WSL2)
    * Sélection des **vérifications d’état** et des **skills**

    Il définit également les attentes de durée avant le début des principales invites et avertit si votre
    modèle configuré est inconnu ou s’il manque une authentification.
  </Accordion>

  <Accordion title="Ai-je besoin d’un abonnement Claude ou OpenAI pour exécuter ceci ?">
    Non. Vous pouvez exécuter OpenClaw avec des **clés d’API** (Anthropic/OpenAI/autres) ou avec
    des **modèles uniquement locaux** afin que vos données restent sur votre appareil. Les abonnements (Claude
    Pro/Max ou OpenAI Codex) sont des moyens facultatifs d’authentifier ces fournisseurs.

    Pour Anthropic dans OpenClaw, la distinction pratique est :

    * **Clé d’API Anthropic** : facturation normale de l’API Anthropic
    * **Claude CLI / authentification d’abonnement Claude dans OpenClaw** : le personnel d’Anthropic
      nous a indiqué que cet usage est à nouveau autorisé, et OpenClaw traite l’usage de `claude -p`
      comme approuvé pour cette intégration, sauf si Anthropic publie une nouvelle
      politique

    Pour les hôtes de Gateway à longue durée de vie, les clés d’API Anthropic restent la configuration
    la plus prévisible. OpenAI Codex OAuth est explicitement pris en charge pour les outils externes
    comme OpenClaw.

    OpenClaw prend également en charge d’autres options hébergées de type abonnement, notamment
    **Qwen Cloud Coding Plan**, **MiniMax Coding Plan** et
    **Z.AI / GLM Coding Plan**.

    Docs : [Anthropic](/fr/providers/anthropic), [OpenAI](/fr/providers/openai),
    [Qwen Cloud](/fr/providers/qwen),
    [MiniMax](/fr/providers/minimax), [Z.AI (GLM)](/fr/providers/zai),
    [Modèles locaux](/fr/gateway/local-models), [Modèles](/fr/concepts/models).
  </Accordion>

  <Accordion title="Puis-je utiliser un abonnement Claude Max sans clé d’API ?">
    Oui.

    Le personnel d’Anthropic nous a indiqué que l’usage de Claude CLI de type OpenClaw est à nouveau autorisé, donc
    OpenClaw traite l’authentification d’abonnement Claude et l’usage de `claude -p` comme approuvés
    pour cette intégration, sauf si Anthropic publie une nouvelle politique. Si vous voulez
    la configuration côté serveur la plus prévisible, utilisez plutôt une clé d’API Anthropic.
  </Accordion>

  <Accordion title="Prenez-vous en charge l’authentification d’abonnement Claude (Claude Pro ou Max) ?">
    Oui.

    Le personnel d’Anthropic nous a indiqué que cet usage est à nouveau autorisé, donc OpenClaw traite
    la réutilisation de Claude CLI et l’usage de `claude -p` comme approuvés pour cette intégration,
    sauf si Anthropic publie une nouvelle politique.

    Le setup-token Anthropic reste disponible comme chemin de jeton OpenClaw pris en charge, mais OpenClaw préfère désormais la réutilisation de Claude CLI et `claude -p` lorsque c’est disponible.
    Pour les charges de travail de production ou multi-utilisateurs, l’authentification par clé d’API Anthropic reste le
    choix plus sûr et plus prévisible. Si vous voulez d’autres options hébergées
    de type abonnement dans OpenClaw, consultez [OpenAI](/fr/providers/openai), [Qwen / Model
    Cloud](/fr/providers/qwen), [MiniMax](/fr/providers/minimax) et [GLM
    Models](/fr/providers/zai).
  </Accordion>
</AccordionGroup>

<a id="why-am-i-seeing-http-429-ratelimiterror-from-anthropic" />

<AccordionGroup>
  <Accordion title="Pourquoi vois-je HTTP 429 rate_limit_error depuis Anthropic ?">
    Cela signifie que votre **quota/limite de débit Anthropic** est épuisé pour la fenêtre actuelle. Si vous
    utilisez **Claude CLI**, attendez que la fenêtre se réinitialise ou mettez votre forfait à niveau. Si vous
    utilisez une **clé API Anthropic**, consultez l’Anthropic Console
    pour l’utilisation/la facturation et augmentez les limites si nécessaire.

    Si le message est précisément :
    `Extra usage is required for long context requests`, la requête essaie d’utiliser
    la fenêtre de contexte 1M d’Anthropic (un modèle Claude 4.x 1M compatible GA ou une configuration héritée
    `context1m: true`). Cela ne fonctionne que lorsque votre identifiant est éligible
    à la facturation de contexte long (facturation par clé API ou chemin de connexion Claude d’OpenClaw
    avec Extra Usage activé).

    Astuce : définissez un **modèle de secours** afin qu’OpenClaw puisse continuer à répondre pendant qu’un fournisseur est limité par le débit.
    Voir [Modèles](/fr/cli/models), [OAuth](/fr/concepts/oauth) et
    [/gateway/troubleshooting#anthropic-429-extra-usage-required-for-long-context](/fr/gateway/troubleshooting#anthropic-429-extra-usage-required-for-long-context).
  </Accordion>

  <Accordion title="AWS Bedrock est-il pris en charge ?">
    Oui. OpenClaw dispose d’un fournisseur **Amazon Bedrock (Converse)** intégré. Lorsque des marqueurs d’environnement AWS sont présents, OpenClaw peut découvrir automatiquement le catalogue Bedrock streaming/texte et le fusionner comme fournisseur implicite `amazon-bedrock` ; sinon, vous pouvez activer explicitement `plugins.entries.amazon-bedrock.config.discovery.enabled` ou ajouter une entrée de fournisseur manuelle. Voir [Amazon Bedrock](/fr/providers/bedrock) et [Fournisseurs de modèles](/fr/providers/models). Si vous préférez un flux de clé géré, un proxy compatible OpenAI devant Bedrock reste une option valide.
  </Accordion>

  <Accordion title="Comment fonctionne l’authentification Codex ?">
    OpenClaw prend en charge **OpenAI Code (Codex)** via OAuth (connexion ChatGPT). Utilisez
    `openai/gpt-5.5` pour la configuration courante : authentification par abonnement ChatGPT/Codex plus
    exécution native du serveur d’application Codex. Les anciennes références Codex GPT sont
    une configuration héritée réparée par `openclaw doctor --fix`. L’accès direct par clé API OpenAI
    reste disponible pour les surfaces API OpenAI non-agent et pour les modèles d’agent
    via un profil de clé API `openai` ordonné.
    Voir [Fournisseurs de modèles](/fr/concepts/model-providers) et [Intégration (CLI)](/fr/start/wizard).
  </Accordion>

  <Accordion title="Pourquoi OpenClaw mentionne-t-il encore l’ancien préfixe OpenAI Codex ?">
    `openai` est l’identifiant de fournisseur et de profil d’authentification pour les clés API OpenAI comme pour
    l’OAuth ChatGPT/Codex. Vous pouvez encore voir l’ancien préfixe OpenAI Codex dans les configurations héritées et
    les avertissements de migration.
    Les anciennes configurations l’utilisaient aussi comme préfixe de modèle :

    * `openai/gpt-5.5` = authentification par abonnement ChatGPT/Codex avec runtime Codex natif pour les tours d’agent
    * référence héritée Codex GPT-5.5 = route de modèle héritée réparée par `openclaw doctor --fix`
    * `openai/gpt-5.5` plus un profil de clé API `openai` ordonné = authentification par clé API pour un modèle d’agent OpenAI
    * identifiants de profil d’authentification Codex hérités = identifiant de profil d’authentification hérité migré par `openclaw doctor --fix`

    Si vous voulez le chemin de facturation/limites direct de la plateforme OpenAI, définissez
    `OPENAI_API_KEY`. Si vous voulez l’authentification par abonnement ChatGPT/Codex, connectez-vous avec
    `openclaw models auth login --provider openai`. Gardez la référence de modèle
    `openai/gpt-5.5` ; les références de modèle Codex héritées sont une configuration héritée que
    `openclaw doctor --fix` réécrit.
  </Accordion>

  <Accordion title="Pourquoi les limites OAuth de Codex peuvent-elles différer de celles du web ChatGPT ?">
    L’OAuth Codex utilise des fenêtres de quota gérées par OpenAI et dépendantes du forfait. En pratique,
    ces limites peuvent différer de l’expérience du site web/de l’application ChatGPT, même lorsque
    les deux sont liées au même compte.

    OpenClaw peut afficher les fenêtres d’utilisation/quota du fournisseur actuellement visibles dans
    `openclaw models status`, mais il n’invente ni ne normalise les droits du web ChatGPT
    en accès API direct. Si vous voulez le chemin de facturation/limites direct de la plateforme OpenAI,
    utilisez `openai/*` avec une clé API.
  </Accordion>

  <Accordion title="Prenez-vous en charge l’authentification par abonnement OpenAI (OAuth Codex) ?">
    Oui. OpenClaw prend entièrement en charge **l’OAuth par abonnement OpenAI Code (Codex)**.
    OpenAI autorise explicitement l’utilisation de l’OAuth par abonnement dans des outils/flux de travail externes
    comme OpenClaw. L’intégration peut exécuter le flux OAuth pour vous.

    Voir [OAuth](/fr/concepts/oauth), [Fournisseurs de modèles](/fr/concepts/model-providers) et [Intégration (CLI)](/fr/start/wizard).
  </Accordion>

  <Accordion title="Comment configurer l’OAuth Gemini CLI ?">
    Gemini CLI utilise un **flux d’authentification de Plugin**, et non un identifiant client ou un secret dans `openclaw.json`.

    Étapes :

    1. Installez Gemini CLI localement afin que `gemini` soit sur le `PATH`
       * Homebrew : `brew install gemini-cli`
       * npm : `npm install -g @google/gemini-cli`
    2. Activez le Plugin : `openclaw plugins enable google`
    3. Connectez-vous : `openclaw models auth login --provider google-gemini-cli --set-default`
    4. Modèle par défaut après connexion : `google-gemini-cli/gemini-3-flash-preview`
    5. Si les requêtes échouent, définissez `GOOGLE_CLOUD_PROJECT` ou `GOOGLE_CLOUD_PROJECT_ID` sur l’hôte du Gateway

    Cela stocke les jetons OAuth dans les profils d’authentification sur l’hôte du Gateway. Détails : [Fournisseurs de modèles](/fr/concepts/model-providers).
  </Accordion>

  <Accordion title="Un modèle local convient-il pour des conversations informelles ?">
    Généralement non. OpenClaw a besoin d’un grand contexte et d’une sécurité robuste ; les petites cartes tronquent et divulguent. Si vous devez le faire, exécutez localement la version de modèle la **plus grande** possible (LM Studio) et consultez [/gateway/local-models](/fr/gateway/local-models). Les modèles plus petits/quantifiés augmentent le risque d’injection de prompt ; voir [Sécurité](/fr/gateway/security).
  </Accordion>

  <Accordion title="Comment conserver le trafic de modèles hébergés dans une région spécifique ?">
    Choisissez des points de terminaison épinglés à une région. OpenRouter expose des options hébergées aux États-Unis pour MiniMax, Kimi et GLM ; choisissez la variante hébergée aux États-Unis pour garder les données dans la région. Vous pouvez toujours lister Anthropic/OpenAI à côté de ces fournisseurs en utilisant `models.mode: "merge"` afin que les secours restent disponibles tout en respectant le fournisseur régional que vous sélectionnez.
  </Accordion>

  <Accordion title="Dois-je acheter un Mac Mini pour installer ceci ?">
    Non. OpenClaw fonctionne sur macOS ou Linux (Windows via WSL2). Un Mac mini est facultatif : certaines personnes
    en achètent un comme hôte toujours allumé, mais un petit VPS, un serveur domestique ou une machine de classe Raspberry Pi fonctionne aussi.

    Vous n’avez besoin d’un Mac que **pour les outils propres à macOS**. Pour iMessage, utilisez [iMessage](/fr/channels/imessage) avec `imsg` sur n’importe quel Mac connecté à Messages. Si le Gateway fonctionne sur Linux ou ailleurs, définissez `channels.imessage.cliPath` sur un wrapper SSH qui exécute `imsg` sur ce Mac. Si vous voulez d’autres outils propres à macOS, exécutez le Gateway sur un Mac ou associez un nœud macOS.

    Documentation : [iMessage](/fr/channels/imessage), [Nœuds](/fr/nodes), [Mode Mac distant](/fr/platforms/mac/remote).
  </Accordion>

  <Accordion title="Ai-je besoin d’un Mac mini pour la prise en charge d’iMessage ?">
    Vous avez besoin d’**un appareil macOS quelconque** connecté à Messages. Il n’est **pas** nécessaire que ce soit un Mac mini :
    n’importe quel Mac convient. **Utilisez [iMessage](/fr/channels/imessage)** avec `imsg` ; le Gateway peut s’exécuter sur ce Mac, ou il peut s’exécuter ailleurs avec un wrapper SSH `cliPath`.

    Configurations courantes :

    * Exécutez le Gateway sur Linux/VPS et définissez `channels.imessage.cliPath` sur un wrapper SSH qui exécute `imsg` sur un Mac connecté à Messages.
    * Exécutez tout sur le Mac si vous voulez la configuration mono-machine la plus simple.

    Documentation : [iMessage](/fr/channels/imessage), [Nœuds](/fr/nodes),
    [Mode Mac distant](/fr/platforms/mac/remote).
  </Accordion>

  <Accordion title="Si j’achète un Mac mini pour exécuter OpenClaw, puis-je le connecter à mon MacBook Pro ?">
    Oui. Le **Mac mini peut exécuter le Gateway**, et votre MacBook Pro peut se connecter comme
    **nœud** (appareil compagnon). Les nœuds n’exécutent pas le Gateway : ils fournissent des
    capacités supplémentaires comme écran/caméra/canevas et `system.run` sur cet appareil.

    Schéma courant :

    * Gateway sur le Mac mini (toujours allumé).
    * Le MacBook Pro exécute l’application macOS ou un hôte de nœud et s’associe au Gateway.
    * Utilisez `openclaw nodes status` / `openclaw nodes list` pour le voir.

    Documentation : [Nœuds](/fr/nodes), [CLI des nœuds](/fr/cli/nodes).
  </Accordion>

  <Accordion title="Puis-je utiliser Bun ?">
    Bun n’est **pas recommandé**. Nous observons des bogues de runtime, en particulier avec WhatsApp et Telegram.
    Utilisez **Node** pour des Gateways stables.

    Si vous voulez tout de même expérimenter avec Bun, faites-le sur un Gateway hors production
    sans WhatsApp/Telegram.
  </Accordion>

  <Accordion title="Telegram : que faut-il mettre dans allowFrom ?">
    `channels.telegram.allowFrom` est **l’identifiant utilisateur Telegram de l’expéditeur humain** (numérique). Ce n’est pas le nom d’utilisateur du bot.

    La configuration demande uniquement des identifiants utilisateur numériques. Si vous avez déjà des entrées héritées `@username` dans la configuration, `openclaw doctor --fix` peut essayer de les résoudre.

    Plus sûr (sans bot tiers) :

    * Envoyez un DM à votre bot, puis exécutez `openclaw logs --follow` et lisez `from.id`.

    API Bot officielle :

    * Envoyez un DM à votre bot, puis appelez `https://api.telegram.org/bot<bot_token>/getUpdates` et lisez `message.from.id`.

    Tiers (moins privé) :

    * Envoyez un DM à `@userinfobot` ou `@getidsbot`.

    Voir [/channels/telegram](/fr/channels/telegram#access-control-and-activation).
  </Accordion>

  <Accordion title="Plusieurs personnes peuvent-elles utiliser un même numéro WhatsApp avec différentes instances OpenClaw ?">
    Oui, via le **routage multi-agent**. Liez le **DM** WhatsApp de chaque expéditeur (pair `kind: "direct"`, expéditeur E.164 comme `+15551234567`) à un `agentId` différent, afin que chaque personne obtienne son propre espace de travail et son propre magasin de session. Les réponses proviennent toujours du **même compte WhatsApp**, et le contrôle d’accès DM (`channels.whatsapp.dmPolicy` / `channels.whatsapp.allowFrom`) est global par compte WhatsApp. Voir [Routage multi-agent](/fr/concepts/multi-agent) et [WhatsApp](/fr/channels/whatsapp).
  </Accordion>

  <Accordion title="Puis-je exécuter un agent de &#x22;chat rapide&#x22; et un agent &#x22;Opus pour le codage&#x22; ?">
    Oui. Utilisez le routage multi-agent : donnez à chaque agent son propre modèle par défaut, puis liez les routes entrantes (compte fournisseur ou pairs spécifiques) à chaque agent. Un exemple de configuration se trouve dans [Routage multi-agent](/fr/concepts/multi-agent). Voir aussi [Modèles](/fr/concepts/models) et [Configuration](/fr/gateway/configuration).
  </Accordion>

  <Accordion title="Homebrew fonctionne-t-il sur Linux ?">
    Oui. Homebrew prend en charge Linux (Linuxbrew). Configuration rapide :

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.profile
    eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"
    brew install <formula>
    ```

    Si vous exécutez OpenClaw via systemd, assurez-vous que le PATH du service inclut `/home/linuxbrew/.linuxbrew/bin` (ou votre préfixe brew) afin que les outils installés avec `brew` soient résolus dans les shells non connectés.
    Les versions récentes ajoutent aussi en tête des services systemd Linux les répertoires bin utilisateur courants (par exemple `~/.local/bin`, `~/.npm-global/bin`, `~/.local/share/pnpm`, `~/.bun/bin`) et respectent `PNPM_HOME`, `NPM_CONFIG_PREFIX`, `BUN_INSTALL`, `VOLTA_HOME`, `ASDF_DATA_DIR`, `NVM_DIR` et `FNM_DIR` lorsqu’ils sont définis.
  </Accordion>

  <Accordion title="Différence entre l’installation git modifiable et l’installation npm">
    * **Installation modifiable (git) :** extraction complète des sources, modifiable, idéale pour les contributeurs.
      Vous exécutez les builds localement et pouvez corriger le code/la documentation.
    * **Installation npm :** installation CLI globale, sans dépôt, idéale pour « simplement l’exécuter ».
      Les mises à jour proviennent des dist-tags npm.

    Documentation : [Bien démarrer](/fr/start/getting-started), [Mise à jour](/fr/install/updating).
  </Accordion>

  <Accordion title="Puis-je basculer plus tard entre les installations npm et git ?">
    Oui. Utilisez `openclaw update --channel ...` quand OpenClaw est déjà installé.
    Cela **ne supprime pas vos données** : cela change uniquement l’installation du code OpenClaw.
    Votre état (`~/.openclaw`) et votre espace de travail (`~/.openclaw/workspace`) restent intacts.

    De npm vers git :

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw update --channel dev
    ```

    De git vers npm :

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw update --channel stable
    ```

    Ajoutez `--dry-run` pour prévisualiser d’abord le changement de mode prévu. Le programme de mise à jour exécute
    les suivis de Doctor, actualise les sources des plugins pour le canal cible et
    redémarre le Gateway sauf si vous passez `--no-restart`.

    L’installeur peut aussi forcer l’un ou l’autre mode :

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
    curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm
    ```

    Conseils de sauvegarde : consultez [Stratégie de sauvegarde](/fr/help/faq#where-things-live-on-disk).
  </Accordion>

  <Accordion title="Dois-je exécuter le Gateway sur mon ordinateur portable ou sur un VPS ?">
    Réponse courte : **si vous voulez une fiabilité 24/7, utilisez un VPS**. Si vous voulez le
    minimum de friction et que les mises en veille/redémarrages vous conviennent, exécutez-le localement.

    **Ordinateur portable (Gateway local)**

    * **Avantages :** aucun coût de serveur, accès direct aux fichiers locaux, fenêtre de navigateur active.
    * **Inconvénients :** mises en veille/pertes réseau = déconnexions, les mises à jour/redémarrages de l’OS interrompent l’exécution, doit rester éveillé.

    **VPS / cloud**

    * **Avantages :** toujours actif, réseau stable, aucun problème de mise en veille d’ordinateur portable, plus facile à maintenir en fonctionnement.
    * **Inconvénients :** fonctionne souvent sans interface graphique (utilisez des captures d’écran), accès aux fichiers uniquement à distance, vous devez utiliser SSH pour les mises à jour.

    **Note spécifique à OpenClaw :** WhatsApp/Telegram/Slack/Mattermost/Discord fonctionnent tous correctement depuis un VPS. Le seul vrai compromis est **navigateur sans interface graphique** contre fenêtre visible. Consultez [Navigateur](/fr/tools/browser).

    **Choix recommandé par défaut :** VPS si vous avez déjà eu des déconnexions du gateway. Le local est excellent lorsque vous utilisez activement le Mac et voulez accéder aux fichiers locaux ou automatiser l’interface avec un navigateur visible.
  </Accordion>

  <Accordion title="Quelle est l’importance d’exécuter OpenClaw sur une machine dédiée ?">
    Ce n’est pas obligatoire, mais **recommandé pour la fiabilité et l’isolation**.

    * **Hôte dédié (VPS/Mac mini/Raspberry Pi) :** toujours actif, moins d’interruptions dues aux mises en veille/redémarrages, permissions plus propres, plus facile à maintenir en fonctionnement.
    * **Ordinateur portable/de bureau partagé :** parfaitement adapté aux tests et à l’utilisation active, mais attendez-vous à des pauses lorsque la machine se met en veille ou se met à jour.

    Si vous voulez le meilleur des deux mondes, gardez le Gateway sur un hôte dédié et associez votre ordinateur portable comme **node** pour les outils locaux d’écran/caméra/exec. Consultez [Nœuds](/fr/nodes).
    Pour les recommandations de sécurité, lisez [Sécurité](/fr/gateway/security).
  </Accordion>

  <Accordion title="Quelles sont les exigences minimales pour un VPS et l’OS recommandé ?">
    OpenClaw est léger. Pour un Gateway de base + un canal de discussion :

    * **Minimum absolu :** 1 vCPU, 1GB de RAM, environ 500MB de disque.
    * **Recommandé :** 1-2 vCPU, 2GB de RAM ou plus pour une marge confortable (journaux, médias, plusieurs canaux). Les outils Node et l’automatisation de navigateur peuvent être gourmands en ressources.

    OS : utilisez **Ubuntu LTS** (ou tout Debian/Ubuntu moderne). Le chemin d’installation Linux est le mieux testé sur cette plateforme.

    Docs : [Linux](/fr/platforms/linux), [Hébergement VPS](/fr/vps).
  </Accordion>

  <Accordion title="Puis-je exécuter OpenClaw dans une VM et quelles sont les exigences ?">
    Oui. Traitez une VM comme un VPS : elle doit rester toujours active, être joignable et disposer de suffisamment de
    RAM pour le Gateway et tous les canaux que vous activez.

    Recommandations de base :

    * **Minimum absolu :** 1 vCPU, 1GB de RAM.
    * **Recommandé :** 2GB de RAM ou plus si vous utilisez plusieurs canaux, l’automatisation de navigateur ou des outils multimédias.
    * **OS :** Ubuntu LTS ou un autre Debian/Ubuntu moderne.

    Si vous êtes sous Windows, utilisez **Windows Hub** pour la configuration de bureau, ou WSL2 lorsque
    vous voulez spécifiquement une VM Gateway de style Linux avec une large compatibilité
    d’outillage. Consultez [Windows](/fr/platforms/windows), [Hébergement VPS](/fr/vps).
    Si vous exécutez macOS dans une VM, consultez [VM macOS](/fr/install/macos-vm).
  </Accordion>
</AccordionGroup>

## Connexe

* [FAQ](/fr/help/faq) — la FAQ principale (modèles, sessions, gateway, sécurité, plus)
* [Vue d’ensemble de l’installation](/fr/install)
* [Bien démarrer](/fr/start/getting-started)
* [Dépannage](/fr/help/troubleshooting)