--- read_when: - Vous voulez effectuer un audit de sécurité rapide sur la configuration/l’état - Vous souhaitez appliquer des suggestions de « correction » sûres (permissions, valeurs par défaut renforcées) summary: Référence CLI pour `openclaw security` (auditer et corriger les pièges de sécurité courants) title: Sécurité x-i18n: generated_at: "2026-05-11T20:28:58Z" model: gpt-5.5 provider: openai source_hash: fb7c65b2d5b17ade8756997f53f28283fbbc9146ccc460fb0e2d49b6d64777e5 source_path: cli/security.md workflow: 16 --- # `openclaw security` Outils de sécurité (audit + corrections facultatives). Connexe : - Guide de sécurité : [Sécurité](/fr/gateway/security) ## Audit ```bash openclaw security audit openclaw security audit --deep openclaw security audit --deep --password openclaw security audit --deep --token openclaw security audit --fix openclaw security audit --json ``` La commande simple `security audit` reste sur le chemin froid de configuration/système de fichiers/lecture seule. Elle ne découvre pas les collecteurs de sécurité d’exécution des plugins par défaut ; les audits courants ne chargent donc pas chaque runtime de Plugin installé. Utilisez `--deep` pour inclure des sondes Gateway en direct au mieux et des collecteurs d’audit de sécurité appartenant aux plugins ; les appelants internes explicites peuvent aussi choisir ces collecteurs appartenant aux plugins lorsqu’ils disposent déjà d’un périmètre de runtime approprié. L’audit avertit lorsque plusieurs expéditeurs de DM partagent la session principale et recommande le **mode DM sécurisé** : `session.dmScope="per-channel-peer"` (ou `per-account-channel-peer` pour les canaux multi-comptes) pour les boîtes de réception partagées. Cela vise le renforcement des boîtes de réception coopératives/partagées. Un Gateway unique partagé par des opérateurs mutuellement non fiables/adversariaux n’est pas une configuration recommandée ; séparez les limites de confiance avec des gateways distincts (ou des utilisateurs/hôtes OS distincts). Il émet aussi `security.trust_model.multi_user_heuristic` lorsque la configuration suggère une entrée probablement partagée entre utilisateurs (par exemple une politique DM/groupe ouverte, des cibles de groupe configurées ou des règles d’expéditeur génériques), et rappelle qu’OpenClaw utilise par défaut un modèle de confiance d’assistant personnel. Pour les configurations partagées intentionnelles, la recommandation de l’audit est de mettre toutes les sessions en bac à sable, de limiter l’accès au système de fichiers au workspace, et de garder les identités ou identifiants personnels/privés hors de ce runtime. Il avertit aussi lorsque de petits modèles (`<=300B`) sont utilisés sans bac à sable et avec les outils web/navigateur activés. Pour l’entrée Webhook, il avertit lorsque `hooks.token` réutilise le jeton Gateway, lorsque `hooks.token` est court, lorsque `hooks.path="/"`, lorsque `hooks.defaultSessionKey` n’est pas défini, lorsque `hooks.allowedAgentIds` n’est pas restreint, lorsque les remplacements `sessionKey` de requête sont activés, et lorsque les remplacements sont activés sans `hooks.allowedSessionKeyPrefixes`. Il avertit aussi lorsque des paramètres Docker de bac à sable sont configurés alors que le mode bac à sable est désactivé, lorsque `gateway.nodes.denyCommands` utilise des entrées inefficaces de type motif ou inconnues (correspondance exacte uniquement des noms de commande de node, pas filtrage du texte shell), lorsque `gateway.nodes.allowCommands` active explicitement des commandes node dangereuses, lorsque le profil global `tools.profile="minimal"` est remplacé par des profils d’outils d’agent, lorsque les outils d’écriture/édition sont désactivés mais que `exec` reste disponible sans limite de système de fichiers contraignante par bac à sable, lorsque des groupes ouverts exposent des outils de runtime/système de fichiers sans protections de bac à sable/workspace, et lorsque des outils de Plugin installés peuvent être accessibles avec une politique d’outils permissive. Il signale aussi `gateway.allowRealIpFallback=true` (risque d’usurpation d’en-tête si les proxys sont mal configurés) et `discovery.mdns.mode="full"` (fuite de métadonnées via les enregistrements TXT mDNS). Il avertit aussi lorsque le navigateur en bac à sable utilise le réseau Docker `bridge` sans `sandbox.browser.cdpSourceRange`. Il signale aussi les modes réseau Docker dangereux pour le bac à sable (y compris `host` et les jonctions d’espaces de noms `container:*`). Il avertit aussi lorsque des conteneurs Docker de navigateur en bac à sable existants ont des étiquettes de hachage manquantes ou obsolètes (par exemple des conteneurs antérieurs à la migration sans `openclaw.browserConfigEpoch`) et recommande `openclaw sandbox recreate --browser --all`. Il avertit aussi lorsque les enregistrements d’installation de Plugin/hook basés sur npm ne sont pas épinglés, n’ont pas de métadonnées d’intégrité ou divergent des versions de paquet actuellement installées. Il avertit lorsque les listes d’autorisation de canaux reposent sur des noms/e-mails/tags modifiables au lieu d’ID stables (Discord, Slack, Google Chat, Microsoft Teams, périmètres Mattermost et IRC le cas échéant). Il avertit lorsque `gateway.auth.mode="none"` laisse les API HTTP Gateway accessibles sans secret partagé (`/tools/invoke` plus tout point de terminaison `/v1/*` activé). Les paramètres préfixés par `dangerous`/`dangerously` sont des remplacements opérateur explicites de dernier recours ; en activer un n’est pas, en soi, un rapport de vulnérabilité de sécurité. Pour l’inventaire complet des paramètres dangereux, consultez la section « Résumé des indicateurs non sécurisés ou dangereux » dans [Sécurité](/fr/gateway/security). Comportement de SecretRef : - `security audit` résout les SecretRefs pris en charge en mode lecture seule pour ses chemins ciblés. - Si un SecretRef n’est pas disponible dans le chemin de commande actuel, l’audit continue et signale `secretDiagnostics` (au lieu de planter). - `--token` et `--password` remplacent uniquement l’authentification des sondes profondes pour cette invocation de commande ; ils ne réécrivent pas la configuration ni les mappages SecretRef. ## Sortie JSON Utilisez `--json` pour les contrôles CI/politique : ```bash openclaw security audit --json | jq '.summary' openclaw security audit --deep --json | jq '.findings[] | select(.severity=="critical") | .checkId' ``` Si `--fix` et `--json` sont combinés, la sortie inclut à la fois les actions de correction et le rapport final : ```bash openclaw security audit --fix --json | jq '{fix: .fix.ok, summary: .report.summary}' ``` ## Ce que `--fix` modifie `--fix` applique des remédiations sûres et déterministes : - bascule les `groupPolicy="open"` courants vers `groupPolicy="allowlist"` (y compris les variantes de compte dans les canaux pris en charge) - lorsque la politique de groupe WhatsApp bascule vers `allowlist`, initialise `groupAllowFrom` depuis le fichier `allowFrom` stocké lorsque cette liste existe et que la configuration ne définit pas déjà `allowFrom` - définit `logging.redactSensitive` de `"off"` à `"tools"` - renforce les autorisations pour l’état/la configuration et les fichiers sensibles courants (`credentials/*.json`, `auth-profiles.json`, `sessions.json`, session `*.jsonl`) - renforce aussi les fichiers d’inclusion de configuration référencés depuis `openclaw.json` - utilise `chmod` sur les hôtes POSIX et des réinitialisations `icacls` sur Windows `--fix` ne fait **pas** ce qui suit : - faire tourner les jetons/mots de passe/clés API - désactiver des outils (`gateway`, `cron`, `exec`, etc.) - modifier les choix de liaison/authentification/exposition réseau du gateway - supprimer ou réécrire des plugins/Skills ## Connexe - [Référence CLI](/fr/cli) - [Audit de sécurité](/fr/gateway/security)