Commandes slash

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 acheminé 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 chaque fois que la gestion des commandes est activée pour l’interface.

Trois types de commandes

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,  },}

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImNoYW5uZWxzLjxjaGFubmVs .commands.enforceOwnerForCommands" type="boolean" default="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 détenir la portée interne operator.admin. Une entrée générique allowFrom n’est pas suffisante.

Liste des commandes

Les commandes proviennent de trois sources :

• Commandes intégrées au 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 plugins : appels registerCommand() du plugin

Leur disponibilité dépend des options de configuration, de l’interface du canal et des plugins installés/activés.

Commandes principales

Commandes d’ancrage

Les commandes d’ancrage font basculer la route de réponse de la session active vers un autre canal lié. Consultez Ancrage des canaux pour la configuration et le dépannage.

Générées à partir des Plugins de canal prenant en charge les commandes natives :

• /dock-discord (alias : /dock_discord)
• /dock-mattermost (alias : /dock_mattermost)
• /dock-slack (alias : /dock_slack)
• /dock-telegram (alias : /dock_telegram)

Les commandes d’ancrage nécessitent session.identityLinks. L’expéditeur source et le pair cible doivent appartenir au même groupe d’identités.

Commandes des Plugins intégrés

QQBot uniquement : /bot-ping, /bot-version, /bot-help, /bot-upgrade, /bot-logs

Commandes de Skills

Les Skills invocables par l’utilisateur sont exposées comme commandes à barre oblique :

• /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 de Skills est contrôlé par commands.nativeSkills et channels.<provider>.commands.nativeSkills.
• Les noms sont normalisés en a-z0-9_ (32 caractères maximum) ; les collisions reçoivent des suffixes numériques.

/tools : ce que l’agent peut utiliser maintenant

/tools répond à une question d’exécution : ce que cet agent peut utiliser immédiatement dans cette conversation — et non un catalogue statique de configuration.

/tools         # vue compacte/tools verbose # avec de courtes descriptions

Les résultats sont limités à la session. Le changement d’agent, de canal, de fil, d’autorisation de l’expéditeur ou de modèle peut modifier la sortie. Pour modifier le profil et les remplacements, utilisez le panneau Tools de l’interface de contrôle 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 dans 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 le point de terminaison et le mode API

Sur Discord, /model et /models ouvrent un sélecteur interactif avec des listes déroulantes de fournisseurs et de modèles. Le sélecteur respecte agents.defaults.models, y compris les entrées provider/*.

/config : écritures de la configuration sur disque

/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 non valides sont rejetées. Les mises à jour /config persistent après les redémarrages.

/mcp : configuration des serveurs MCP

/mcp show/mcp show context7/mcp set context7={"command":"uvx","args":["context7-mcp"]}/mcp unset context7

/mcp stocke la configuration dans celle d’OpenClaw, et non dans les paramètres de projet de l’agent intégré. /mcp show masque les champs contenant des identifiants, les valeurs reconnues des options relatives aux identifiants et les arguments présentant une forme connue de secret. Lorsqu’elle est exécutée depuis un groupe, la configuration est envoyée en privé au propriétaire ; si aucune route privée vers le propriétaire n’est disponible, la commande échoue de manière sécurisée et demande au propriétaire de réessayer depuis une conversation directe.

/debug : remplacements limités à l’exécution

/debug show/debug set messages.responsePrefix="[openclaw]"/debug set channels.whatsapp.allowFrom=["+1555","+4477"]/debug unset messages.responsePrefix/debug reset

/plugins : gestion des Plugins

/plugins/plugins list/plugin show context7/plugins enable context7/plugins disable context7/plugins install clawhub:<package>/plugins install npm:@openclaw/<official-package>/plugins install npm:<package> --force/plugins install git:<repository>@<ref> --force

/plugins enable|disable met à jour la configuration des Plugins et recharge à chaud l’environnement d’exécution des Plugins du Gateway pour les nouveaux tours des agents. /plugins install redémarre automatiquement les Gateways gérés, car les modules sources des Plugins ont changé. Les installations ClawHub de confiance et celles provenant du catalogue officiel ne nécessitent pas d’accusé de réception supplémentaire. Les sources npm, git, d’archive, npm-pack: et de chemin local arbitraires affichent un avertissement de provenance et nécessitent un --force final après examen de la source. Cette option confirme la prise en compte de la source et autorise le remplacement d’une installation existante ; elle ne contourne ni security.installPolicy ni les contrôles de sécurité du programme d’installation. Les versions ClawHub accompagnées d’avertissements de risque nécessitent toujours l’option distincte, disponible uniquement dans le shell, --acknowledge-clawhub-risk. Les installations issues de la place de marché, liées et épinglées restent également limitées au shell.

/trace : sortie de traçage des Plugins

/trace          # afficher l’état actuel du traçage/trace on/trace off

/trace affiche les lignes de traçage et de débogage des Plugins limitées à la session sans activer le mode entièrement détaillé. Il ne remplace ni /debug (remplacements d’exécution), ni /verbose (sortie normale des outils).

/btw : questions secondaires

/btw permet de poser rapidement une question secondaire sur le contexte de la session actuelle. Alias : /side.

/btw que faisons-nous actuellement ?/side qu’est-ce qui a changé pendant que l’exécution principale se poursuivait ?

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 secondaire Codex éphémère.
• Ne modifie pas le contexte futur de la session.
• N’est pas écrit dans l’historique de la transcription.

Consultez Questions secondaires BTW pour connaître le comportement complet.

Remarques sur les surfaces

Utilisation et état du fournisseur

• Utilisation/quota du fournisseur (par exemple, « Claude : 80 % restants ») 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 utiliser en dernier recours la dernière entrée d’utilisation de la transcription lorsque l’instantané de la session en direct contient peu d’informations.
• Exécution et environnement d’exécution : /status indique Execution pour le chemin effectif du bac à sable et Runtime pour l’entité qui exécute la session : OpenClaw Default, OpenAI Codex, un moteur CLI ou un moteur ACP.
• Jetons/coût par réponse : contrôlés par /usage off|tokens|full.
• /model status concerne les modèles, l’authentification et les points de terminaison, et non l’utilisation.

Pages connexes