Skills

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 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.

Détails du comportement des directives

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

json5

{  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.textbooleandefault: 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.nativeboolean | "auto"default: "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.nativeSkillsboolean | "auto"default: "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.bashbooleandefault: 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.bashForegroundMsnumberdefault: 2000

Durée pendant laquelle bash attend avant de passer en mode arrière-plan (0 passe en arrière-plan immédiatement).

commands.configbooleandefault: false

Active /config (lit/écrit openclaw.json). Réservé au propriétaire.

commands.mcpbooleandefault: false

Active /mcp (lit/écrit la configuration MCP gérée par OpenClaw sous mcp.servers). Réservé au propriétaire.

commands.pluginsbooleandefault: false

Active /plugins (découverte/statut des plugins, ainsi qu’installation et activation/désactivation). Écriture réservée au propriétaire.

commands.debugbooleandefault: false

Active /debug (remplacements de configuration uniquement à l’exécution). Réservé au propriétaire.

commands.restartbooleandefault: true

Active /restart et les actions d’outil de redémarrage du gateway.

commands.ownerAllowFromstring[]

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.

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 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.ownerDisplaySecretstring

Secret HMAC utilisé lorsque commands.ownerDisplay: "hash".

commands.allowFromobject

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.useAccessGroupsbooleandefault: 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

Sessions et exécutions

Commande	Description
`/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
`/stop`	Interrompre 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`

Contrôles du modèle et de l’exécution

Commande	Description
`/think <level\|default>`	Définir le niveau de réflexion ou effacer le remplacement de session. Alias : `/thinking`, `/t`
`/verbose on\|off\|full`	Activer/désactiver la sortie détaillée. Alias : `/v`
`/trace on\|off`	Activer/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

Sécurité de verbose / trace / fast / reasoning

/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.

Détails du changement de modèle

/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.

Découverte et statut

Commande	Description
`/help`	Afficher le court résumé d’aide
`/commands`	Afficher le catalogue de commandes généré
`/tools [compact\|verbose]`	Afficher ce que l’agent actuel peut utiliser dès maintenant
`/status`	Afficher 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 plugins`	Afficher 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
`/tasks`	Lister 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é
`/whoami`	Afficher votre identifiant d’expéditeur. Alias : `/id`
`/usage off\|tokens\|full\|reset\|cost`	Contrô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

Skills, listes d’autorisation, approbations

Commande	Description
`/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

Sous-agents et ACP

Commande	Description
`/subagents list\|log\|info`	Inspecter 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\|help`	Gé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
`/unfocus`	Supprimer la liaison du fil actuel
`/agents`	Lister les agents liés au fil pour la session actuelle

Écritures réservées au propriétaire et administration

Commande	Nécessite	Description
`/config show\|get\|set\|unset`	`commands.config: true`	Lire ou écrire `openclaw.json`. Réservé au propriétaire
`/mcp show\|get\|set\|unset`	`commands.mcp: true`	Lire ou écrire la configuration du serveur MCP gérée par OpenClaw. Réservé au propriétaire
`/plugins list\|inspect\|show\|get\|install\|enable\|disable`	`commands.plugins: true`	Inspecter ou modifier l’état des plugins. Réservé au propriétaire pour les écritures. Alias : `/plugin`
`/debug show\|set\|unset\|reset`	`commands.debug: true`	Remplacements de configuration uniquement à l’exécution. Réservé au propriétaire
`/restart`	`commands.restart: true` (par défaut)	Redémarrer OpenClaw
`/send on\|off\|inherit`	propriétaire	Définir la politique d’envoi

Voix, TTS, contrôle du canal

Commande	Description
`/tts on\|off\|status\|chat\|latest\|provider\|limit\|summary\|audio\|help`	Contrôler TTS. Voir TTS
`/activation mention\|always`	Dé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

Commande	Description
`/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 ...\|disarm`	Armer 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\|skills`	Contrô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.

Distribution des commandes Skills

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.

Arguments de commande native

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.

text

/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

text

/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

text

/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

text

/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

text

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

`/plugins` — gestion des plugins

text

/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

text

/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.

text

/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

Portée de session par 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.

Particularités de Slack

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.

Chemin rapide et raccourcis intégrés

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.

Notes sur les arguments

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.

Was this useful?

Commandes slash

Trois types de commandes

Configuration

Liste des commandes

Commandes du cœur

Commandes Dock

Commandes des plugins intégrés

Commandes Skills

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

`/model` — sélection du modèle

`/config` — écritures de configuration sur disque

`/mcp` — configuration du serveur MCP

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

`/plugins` — gestion des plugins

`/trace` — sortie de trace des plugins

`/btw` — questions annexes

Notes de surface

Utilisation et état du fournisseur

Associés

On this page

Molty

Trois types de commandes

Configuration

Liste des commandes

Commandes du cœur

Commandes Dock

Commandes des plugins intégrés

Commandes Skills

/tools — ce que l’agent peut utiliser maintenant

/model — sélection du modèle

/config — écritures de configuration sur disque

/mcp — configuration du serveur MCP

/debug — remplacements uniquement à l’exécution

/plugins — gestion des plugins

/trace — sortie de trace des plugins

/btw — questions annexes

Notes de surface

Utilisation et état du fournisseur

Associés

On this page

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

`/model` — sélection du modèle

`/config` — écritures de configuration sur disque

`/mcp` — configuration du serveur MCP

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

`/plugins` — gestion des plugins

`/trace` — sortie de trace des plugins

`/btw` — questions annexes