Passer au contenu principal
Le Gateway gère les commandes envoyées sous forme de messages autonomes commençant par /. Les commandes bash réservées à l’hôte utilisent ! <cmd> (avec /bash <cmd> comme alias). Lorsqu’une conversation est liée à une session ACP, le texte normal est routé vers le harnais ACP. Les commandes de gestion du Gateway restent locales : /acp ... atteint toujours le gestionnaire de commandes OpenClaw, et /status ainsi que /unfocus restent locales lorsque la gestion des commandes est activée pour la surface.

​
Trois types de commandes

Commandes

Messages autonomes /... gérés par le Gateway. Doivent être envoyés comme seul contenu du message.

Directives

/think, /fast, /verbose, /trace, /reasoning, /elevated, /exec, /model, /queue — retirées du message avant que le modèle ne le voie. Conservent les paramètres de session lorsqu’elles sont envoyées seules ; agissent comme indications intégrées lorsqu’elles sont envoyées avec d’autre texte.

Raccourcis intégrés

/help, /commands, /status, /whoami — s’exécutent immédiatement et sont retirés avant que le modèle ne voie le texte restant. Expéditeurs autorisés uniquement.
  • Les directives sont retirées du message avant que le modèle ne le voie.
  • Dans les messages directive-only (le message contient uniquement des directives), elles persistent dans la session et répondent avec un accusé de réception.
  • Dans les messages de normal chat contenant d’autre texte, elles agissent comme indications intégrées et ne conservent pas les paramètres de session.
  • Les directives ne s’appliquent qu’aux expéditeurs autorisés. Si commands.allowFrom est défini, il s’agit de la seule liste d’autorisation utilisée ; sinon, l’autorisation provient des listes d’autorisation/appariements du canal, plus commands.useAccessGroups. Les expéditeurs non autorisés voient les directives traitées comme du texte brut.

​
Configuration

{
  commands: {
    native: "auto",
    nativeSkills: "auto",
    text: true,
    bash: false,
    bashForegroundMs: 2000,
    config: false,
    mcp: false,
    plugins: false,
    debug: false,
    restart: true,
    ownerAllowFrom: ["discord:123456789012345678"],
    ownerDisplay: "raw",
    ownerDisplaySecret: "${OWNER_ID_HASH_SECRET}",
    allowFrom: {
      "*": ["user1"],
      discord: ["user:123"],
    },
    useAccessGroups: true,
  },
}
​
commands.text
boolean
défaut:"true"
Active l’analyse de /... dans les messages de chat. Sur les surfaces sans commandes natives (WhatsApp, WebChat, Signal, iMessage, Google Chat, Microsoft Teams), les commandes texte fonctionnent même lorsque cette option est définie sur false.
​
commands.native
boolean | "auto"
défaut:"\"auto\""
Enregistre les commandes natives. Auto : activé pour Discord/Telegram ; désactivé pour Slack ; ignoré pour les fournisseurs sans prise en charge native. Remplacez par canal avec channels.<provider>.commands.native. Sur Discord, false ignore l’enregistrement des commandes slash ; les commandes précédemment enregistrées peuvent rester visibles jusqu’à leur suppression.
​
commands.nativeSkills
boolean | "auto"
défaut:"\"auto\""
Enregistre les commandes de skill de façon native lorsque c’est pris en charge. Auto : activé pour Discord/Telegram ; désactivé pour Slack. Remplacez avec channels.<provider>.commands.nativeSkills.
​
commands.bash
boolean
défaut:"false"
Active ! <cmd> pour exécuter des commandes shell sur l’hôte (alias /bash <cmd>). Nécessite les listes d’autorisation tools.elevated.
​
commands.bashForegroundMs
number
défaut:"2000"
Durée pendant laquelle bash attend avant de passer en mode arrière-plan (0 passe en arrière-plan immédiatement).
​
commands.config
boolean
défaut:"false"
Active /config (lit/écrit openclaw.json). Réservé au propriétaire.
​
commands.mcp
boolean
défaut:"false"
Active /mcp (lit/écrit la configuration MCP gérée par OpenClaw sous mcp.servers). Réservé au propriétaire.
​
commands.plugins
boolean
défaut:"false"
Active /plugins (découverte/statut des plugins, ainsi qu’installation et activation/désactivation). Écriture réservée au propriétaire.
​
commands.debug
boolean
défaut:"false"
Active /debug (remplacements de configuration uniquement à l’exécution). Réservé au propriétaire.
​
commands.restart
boolean
défaut:"true"
Active /restart et les actions d’outil de redémarrage du gateway.
​
commands.ownerAllowFrom
string[]
Liste d’autorisation explicite des propriétaires pour les surfaces de commandes réservées au propriétaire. Distincte de commands.allowFrom et de l’accès par appariement DM.
​
channels.<channel>.commands.enforceOwnerForCommands
boolean
défaut:"false"
Par canal : exige l’identité du propriétaire pour les commandes réservées au propriétaire. Lorsque true, l’expéditeur doit correspondre à commands.ownerAllowFrom ou posséder la portée interne operator.admin. Une entrée générique allowFrom n’est pas suffisante.
​
commands.ownerDisplay
"raw" | "hash"
Contrôle la façon dont les identifiants de propriétaire apparaissent dans le prompt système.
​
commands.ownerDisplaySecret
string
Secret HMAC utilisé lorsque commands.ownerDisplay: "hash".
​
commands.allowFrom
object
Liste d’autorisation par fournisseur pour l’autorisation des commandes. Lorsqu’elle est configurée, elle est la seule source d’autorisation pour les commandes et directives. Utilisez "*" pour une valeur par défaut globale ; les clés propres à un fournisseur la remplacent.
​
commands.useAccessGroups
boolean
défaut:"true"
Applique les listes d’autorisation/politiques pour les commandes lorsque commands.allowFrom n’est pas défini.

​
Liste des commandes

Les commandes proviennent de trois sources :
  • Commandes intégrées du cœur : src/auto-reply/commands-registry.shared.ts
  • Commandes de dock générées : src/auto-reply/commands-registry.data.ts
  • Commandes de Plugin : appels registerCommand() du plugin
La disponibilité dépend des indicateurs de configuration, de la surface du canal et des plugins installés/activés.

​
Commandes du cœur

CommandeDescription
/new [model]Archiver la session actuelle et en démarrer une nouvelle
/reset [soft [message]]Réinitialiser la session actuelle sur place. soft conserve la transcription, supprime les identifiants de session du backend CLI réutilisés et relance le démarrage
/name <title>Nommer ou renommer la session actuelle. Omettez le titre pour voir le nom actuel et une suggestion
/compact [instructions]Compacter le contexte de session. Voir Compaction
/stopInterrompre l’exécution actuelle
/session idle <duration|off>Gérer l’expiration d’inactivité de liaison au fil
/session max-age <duration|off>Gérer l’expiration d’âge maximal de liaison au fil
/export-session [path]Exporter la session actuelle en HTML. Alias : /export
/export-trajectory [path]Exporter un lot de trajectoire JSONL pour la session actuelle. Alias : /trajectory
Control UI intercepte /new saisi pour créer et basculer vers une nouvelle session de tableau de bord, sauf lorsque session.dmScope: "main" est configuré et que le parent actuel est la session principale de l’agent — dans ce cas, /new réinitialise la session principale sur place. /reset saisi exécute toujours la réinitialisation sur place du Gateway. Utilisez /model default lorsque vous voulez effacer une sélection de modèle de session épinglée.
CommandeDescription
/think <level|default>Définir le niveau de réflexion ou effacer le remplacement de session. Alias : /thinking, /t
/verbose on|off|fullActiver/désactiver la sortie détaillée. Alias : /v
/trace on|offActiver/désactiver la sortie de trace des plugins pour la session actuelle
/fast [status|auto|on|off|default]Afficher, définir ou effacer le mode rapide
/reasoning [on|off|stream]Activer/désactiver la visibilité du raisonnement. Alias : /reason
/elevated [on|off|ask|full]Activer/désactiver le mode élevé. Alias : /elev
/exec host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>Afficher ou définir les valeurs par défaut d’exécution
/login [codex|openai|openai-codex]Apparier une connexion Codex/OpenAI depuis un chat privé ou une session d’interface Web. Propriétaire/admin uniquement
/model [name|#|status]Afficher ou définir le modèle
/models [provider] [page] [limit=<n>|all]Lister les fournisseurs ou modèles configurés/disponibles via authentification
/queue <mode>Gérer le comportement de file d’attente des exécutions actives. Voir File d’attente et Pilotage de la file d’attente
/steer <message>Injecter des consignes dans l’exécution active. Alias : /tell. Voir Piloter
  • /verbose sert au débogage — gardez-le désactivé en utilisation normale.
  • /trace révèle uniquement les lignes de trace/débogage appartenant aux plugins ; les messages détaillés normaux restent désactivés.
  • /fast auto|on|off conserve un remplacement de session ; utilisez l’option inherit de l’interface Sessions pour l’effacer.
  • /fast dépend du fournisseur : OpenAI/Codex le mappe vers service_tier=priority ; les requêtes Anthropic directes le mappent vers service_tier=auto ou standard_only.
  • /reasoning, /verbose et /trace sont risqués dans les contextes de groupe — ils peuvent révéler le raisonnement interne ou des diagnostics de plugins. Gardez-les désactivés dans les chats de groupe.
  • /model conserve immédiatement le nouveau modèle dans la session.
  • Si l’agent est inactif, l’exécution suivante l’utilise immédiatement.
  • Si une exécution est active, le changement est marqué comme en attente et appliqué au prochain point de nouvelle tentative propre.
CommandeDescription
/helpAfficher le court résumé d’aide
/commandsAfficher le catalogue de commandes généré
/tools [compact|verbose]Afficher ce que l’agent actuel peut utiliser dès maintenant
/statusAfficher le statut d’exécution/runtime, la durée de fonctionnement du Gateway et du système, l’état des plugins, ainsi que l’utilisation/quota du fournisseur
/status pluginsAfficher l’état détaillé des plugins : erreurs de chargement, quarantaines, échecs de canal, problèmes de dépendances, avis de compatibilité
/goal [status|start|pause|resume|complete|block|clear] ...Gérer le goal durable de la session actuelle
/diagnostics [note]Flux de rapport de support réservé au propriétaire. Demande l’approbation d’exécution à chaque fois
/crestodian <request>Exécuter l’assistant de configuration et de réparation Crestodian depuis un DM propriétaire
/tasksLister les tâches d’arrière-plan actives/récentes pour la session actuelle
/context [list|detail|map|json]Expliquer comment le contexte est assemblé
/whoamiAfficher votre identifiant d’expéditeur. Alias : /id
/usage off|tokens|full|reset|costContrôler le pied de page d’utilisation par réponse (reset/inherit/clear/default efface le remplacement de session pour réhériter de la valeur par défaut configurée) ou afficher un résumé local des coûts
CommandeDescription
/skill <name> [input]Exécuter une skill par nom
/allowlist [list|add|remove] ...Gérer les entrées de liste d’autorisation. Texte uniquement
/approve <id> <decision>Résoudre les demandes d’approbation d’exécution ou de plugin
/btw <question>Poser une question secondaire sans modifier le contexte de session. Alias : /side. Voir BTW
CommandeDescription
/subagents list|log|infoInspecter les exécutions de sous-agents pour la session actuelle
/acp spawn|cancel|steer|close|sessions|status|set-mode|set|cwd|permissions|timeout|model|reset-options|doctor|install|helpGérer les sessions ACP et les options d’exécution. Les contrôles d’exécution nécessitent une identité de propriétaire externe ou d’administrateur interne du Gateway
/focus <target>Lier le fil Discord actuel ou le sujet Telegram à une cible de session
/unfocusSupprimer la liaison du fil actuel
/agentsLister les agents liés au fil pour la session actuelle
CommandeNécessiteDescription
/config show|get|set|unsetcommands.config: trueLire ou écrire openclaw.json. Réservé au propriétaire
/mcp show|get|set|unsetcommands.mcp: trueLire ou écrire la configuration du serveur MCP gérée par OpenClaw. Réservé au propriétaire
/plugins list|inspect|show|get|install|enable|disablecommands.plugins: trueInspecter ou modifier l’état des plugins. Réservé au propriétaire pour les écritures. Alias : /plugin
/debug show|set|unset|resetcommands.debug: trueRemplacements de configuration uniquement à l’exécution. Réservé au propriétaire
/restartcommands.restart: true (par défaut)Redémarrer OpenClaw
/send on|off|inheritpropriétaireDéfinir la politique d’envoi
CommandeDescription
/tts on|off|status|chat|latest|provider|limit|summary|audio|helpContrôler TTS. Voir TTS
/activation mention|alwaysDéfinir le mode d’activation de groupe
/bash <command>Exécuter une commande shell de l’hôte. Alias : ! <command>. Nécessite commands.bash: true
!poll [sessionId]Vérifier une tâche bash en arrière-plan
!stop [sessionId]Arrêter une tâche bash en arrière-plan

​
Commandes Dock

Les commandes Dock basculent la route de réponse de la session active vers un autre canal lié. Voir Ancrage de canal pour la configuration et le dépannage. Généré à partir des plugins de canal avec prise en charge des commandes natives :
  • /dock-discord (alias : /dock_discord)
  • /dock-mattermost (alias : /dock_mattermost)
  • /dock-slack (alias : /dock_slack)
  • /dock-telegram (alias : /dock_telegram)
Les commandes Dock nécessitent session.identityLinks. L’expéditeur source et le pair cible doivent se trouver dans le même groupe d’identité.

​
Commandes des plugins intégrés

CommandeDescription
/dreaming [on|off|status|help]Activer ou désactiver le Dreaming de mémoire (propriétaire ou administrateur du Gateway). Voir Dreaming
/pair [qr|status|pending|approve|cleanup|notify]Gérer l’appairage d’appareil. Voir Appairage
/phone status|arm ...|disarmArmer temporairement les commandes de nœud téléphonique à haut risque
/voice status|list|set <voiceId>Gérer la configuration de voix Talk. Nom natif Discord : /talkvoice
/card ...Envoyer des préréglages de cartes riches LINE. Voir LINE
/codex status|models|threads|resume|compact|review|diagnostics|account|mcp|skillsContrôler le harnais serveur d’application Codex. Voir Harnais Codex
Uniquement QQBot : /bot-ping, /bot-version, /bot-help, /bot-upgrade, /bot-logs

​
Commandes Skills

Les Skills invocables par l’utilisateur sont exposés comme commandes slash :
  • /skill <name> [input] fonctionne toujours comme point d’entrée générique.
  • Les Skills peuvent s’enregistrer comme commandes directes (par exemple /prose pour OpenProse).
  • L’enregistrement natif des commandes Skills est contrôlé par commands.nativeSkills et channels.<provider>.commands.nativeSkills.
  • Les noms sont nettoyés en a-z0-9_ (32 caractères max.) ; les collisions reçoivent des suffixes numériques.
Par défaut, les commandes Skills sont routées vers le modèle comme une requête normale.Les Skills peuvent déclarer command-dispatch: tool pour router directement vers un outil (déterministe, sans intervention du modèle). Exemple : /prose (plugin OpenProse) — voir OpenProse.
Discord utilise l’autocomplétion pour les options dynamiques et les menus de boutons lorsque les arguments requis sont omis. Telegram et Slack affichent un menu de boutons pour les commandes avec choix. Les choix dynamiques se résolvent par rapport au modèle de session cible, donc les options propres au modèle comme les niveaux /think suivent le remplacement /model de la session.

​
/tools — ce que l’agent peut utiliser maintenant

/tools répond à une question d’exécution : ce que cet agent peut utiliser maintenant dans cette conversation — et non un catalogue de configuration statique. 
/tools         # vue compacte
/tools verbose # avec descriptions courtes
Les résultats sont limités à la session. Changer d’agent, de canal, de fil, d’autorisation d’expéditeur ou de modèle peut modifier la sortie. Pour modifier les profils et remplacements, utilisez le panneau Tools de l’interface Control UI ou les surfaces de configuration.

​
/model — sélection du modèle

/model             # afficher le sélecteur de modèle
/model list        # identique
/model 3           # sélectionner par numéro depuis le sélecteur
/model openai/gpt-5.4
/model opus@anthropic:default
/model default     # effacer la sélection de modèle de la session
/model status      # vue détaillée avec endpoint et mode API
Sur Discord, /model et /models ouvrent un sélecteur interactif avec des menus déroulants de fournisseur et de modèle. Le sélecteur respecte agents.defaults.models, y compris les entrées provider/*.

​
/config — écritures de configuration sur disque

Réservé au propriétaire. Désactivé par défaut — activez avec commands.config: true.
/config show
/config show messages.responsePrefix
/config get messages.responsePrefix
/config set messages.responsePrefix="[openclaw]"
/config unset messages.responsePrefix
La configuration est validée avant l’écriture. Les modifications invalides sont rejetées. Les mises à jour /config persistent après les redémarrages.

​
/mcp — configuration du serveur MCP

Réservé au propriétaire. Désactivé par défaut — activez avec commands.mcp: true.
/mcp show
/mcp show context7
/mcp set context7={"command":"uvx","args":["context7-mcp"]}
/mcp unset context7
/mcp stocke la configuration dans la configuration OpenClaw, et non dans les paramètres de projet de l’agent intégré.

​
/debug — remplacements uniquement à l’exécution

Réservé au propriétaire. Désactivé par défaut — activez avec commands.debug: true. Les remplacements s’appliquent immédiatement aux nouvelles lectures de configuration, mais ne sont pas écrits sur disque.
/debug show
/debug set messages.responsePrefix="[openclaw]"
/debug set channels.whatsapp.allowFrom=["+1555","+4477"]
/debug unset messages.responsePrefix
/debug reset

​
/plugins — gestion des plugins

Réservé au propriétaire pour les écritures. Désactivé par défaut — activez avec commands.plugins: true.
/plugins
/plugins list
/plugin show context7
/plugins enable context7
/plugins disable context7
/plugins install ./path/to/plugin
/plugins enable|disable met à jour la configuration des plugins et recharge à chaud l’exécution des plugins du Gateway pour les nouveaux tours d’agent. /plugins install redémarre automatiquement les Gateways gérés, car les modules source des plugins ont changé.

​
/trace — sortie de trace des plugins

/trace          # afficher l’état actuel de la trace
/trace on
/trace off
/trace révèle les lignes de trace/débogage des plugins limitées à la session sans mode verbeux complet. Il ne remplace pas /debug (remplacements d’exécution) ni /verbose (sortie normale des outils).

​
/btw — questions annexes

/btw est une question annexe rapide sur le contexte de la session actuelle. Alias : /side. 
/btw what are we doing right now?
/side what changed while the main run continued?
Contrairement à un message normal :
  • Utilise la session actuelle comme contexte d’arrière-plan.
  • Dans les sessions du harnais Codex, s’exécute comme un fil annexe Codex éphémère.
  • Ne modifie pas le contexte futur de la session.
  • N’est pas écrit dans l’historique de transcription.
Voir Questions annexes BTW pour le comportement complet.

​
Notes de surface

  • Commandes texte : s’exécutent dans la session de chat normale (les DM partagent main, les groupes ont leur propre session).
  • Commandes natives Discord : agent:<agentId>:discord:slash:<userId>
  • Commandes natives Slack : agent:<agentId>:slack:slash:<userId> (préfixe configurable via channels.slack.slashCommand.sessionPrefix)
  • Commandes natives Telegram : telegram:slash:<userId> (cible la session de chat via CommandTargetSessionKey)
  • /login codex envoie les codes d’appairage d’appareil uniquement via chat privé ou chemins de réponse Web UI. Les invocations dans un groupe/sujet Telegram demandent plutôt au propriétaire d’envoyer un DM au bot.
  • /stop cible la session de chat active pour interrompre l’exécution actuelle.
channels.slack.slashCommand prend en charge une seule commande de style /openclaw. Avec commands.native: true, créez une commande slash Slack par commande intégrée. Enregistrez /agentstatus (et non /status), car Slack réserve /status. Le texte /status fonctionne toujours dans les messages Slack.
  • Les messages constitués uniquement d’une commande provenant d’expéditeurs autorisés sont traités immédiatement (contournement de la file + modèle).
  • Les raccourcis intégrés (/help, /commands, /status, /whoami) fonctionnent aussi dans les messages normaux et sont retirés avant que le modèle voie le texte restant.
  • Les messages non autorisés constitués uniquement d’une commande sont ignorés silencieusement ; les jetons /... intégrés sont traités comme du texte brut.
  • Les commandes acceptent un : facultatif entre la commande et les arguments (/think: high, /send: on).
  • /new <model> accepte un alias de modèle, provider/model, ou un nom de fournisseur (correspondance approximative) ; en l’absence de correspondance, le texte est traité comme corps du message.
  • /allowlist add|remove nécessite commands.config: true et respecte configWrites du canal.

​
Utilisation et état du fournisseur

  • Utilisation/quota du fournisseur (par exemple, « Claude 80 % restant ») s’affiche dans /status pour le fournisseur du modèle actuel lorsque le suivi de l’utilisation est activé.
  • Les lignes de jetons/cache dans /status peuvent se rabattre sur la dernière entrée d’utilisation de transcription lorsque l’instantané de session en direct est clairsemé.
  • Exécution vs runtime : /status signale Execution pour le chemin de bac à sable effectif et Runtime pour qui exécute la session : OpenClaw Default, OpenAI Codex, un backend CLI ou un backend ACP.
  • Jetons/coût par réponse : contrôlé par /usage off|tokens|full.
  • /model status concerne les modèles/authentification/endpoints, pas l’utilisation.

​
Associés

Skills

Comment les commandes slash Skills sont enregistrées et contrôlées.

Création de Skills

Créez un skill qui enregistre sa propre commande slash.

BTW

Questions annexes sans modifier le contexte de session.

Steer

Guider l’agent en cours d’exécution avec /steer.