Comandi slash

Il Gateway gestisce i comandi inviati come messaggi autonomi che iniziano con /. I comandi bash solo per l'host usano ! <cmd> (con /bash <cmd> come alias).

Quando una conversazione è associata a una sessione ACP, il testo normale viene inoltrato all'harness ACP. I comandi di gestione del Gateway rimangono locali: /acp ... raggiunge sempre il gestore dei comandi di OpenClaw, mentre /status e /unfocus rimangono locali ogni volta che la gestione dei comandi è abilitata per l'interfaccia.

Tre tipi di comando

Configurazione

{  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"> Per canale: richiede l'identità del proprietario per i comandi riservati al proprietario. Quando true, il mittente deve corrispondere a commands.ownerAllowFrom o disporre dell'ambito interno operator.admin. Una voce jolly allowFrom non è sufficiente.

Elenco dei comandi

I comandi provengono da tre fonti:

• Comandi integrati principali: src/auto-reply/commands-registry.shared.ts
• Comandi dock generati: src/auto-reply/commands-registry.data.ts
• Comandi dei plugin: chiamate registerCommand() dei plugin

La disponibilità dipende dai flag di configurazione, dall'interfaccia del canale e dai plugin installati/abilitati.

Comandi principali

Comandi di aggancio

I comandi di aggancio spostano il percorso di risposta della sessione attiva su un altro canale collegato. Per la configurazione e la risoluzione dei problemi, consultare Aggancio dei canali.

Generati dai plugin dei canali con supporto per i comandi nativi:

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

I comandi di aggancio richiedono session.identityLinks. Il mittente di origine e il peer di destinazione devono appartenere allo stesso gruppo di identità.

Comandi dei plugin inclusi

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

Comandi delle skill

Le skill richiamabili dagli utenti sono esposte come comandi slash:

• /skill <name> [input] funziona sempre come punto di ingresso generico.
• Le Skills possono registrarsi come comandi diretti (ad esempio /prose per OpenProse).
• La registrazione dei comandi nativi delle skill è controllata da commands.nativeSkills e channels.<provider>.commands.nativeSkills.
• I nomi vengono normalizzati in a-z0-9_ (massimo 32 caratteri); in caso di collisione vengono aggiunti suffissi numerici.

/tools: ciò che l'agente può utilizzare ora

/tools risponde a una domanda sul runtime: ciò che questo agente può utilizzare in questo momento in questa conversazione, non un catalogo statico della configurazione.

/tools         # visualizzazione compatta/tools verbose # con brevi descrizioni

I risultati sono circoscritti alla sessione. La modifica dell'agente, del canale, del thread, dell'autorizzazione del mittente o del modello può modificare l'output. Per modificare i profili e le sostituzioni, utilizzare il pannello Strumenti della Control UI o le superfici di configurazione.

/model: selezione del modello

/model             # mostra il selettore del modello/model list        # equivalente/model 3           # seleziona per numero dal selettore/model openai/gpt-5.4/model opus@anthropic:default/model default     # cancella la selezione del modello della sessione/model status      # visualizzazione dettagliata con endpoint e modalità API

Su Discord, /model e /models aprono un selettore interattivo con menu a discesa per provider e modello. Il selettore rispetta agents.defaults.models, incluse le voci provider/*.

/config: scritture della configurazione su disco

/config show/config show messages.responsePrefix/config get messages.responsePrefix/config set messages.responsePrefix="[openclaw]"/config unset messages.responsePrefix

La configurazione viene convalidata prima della scrittura. Le modifiche non valide vengono rifiutate. Gli aggiornamenti di /config persistono dopo i riavvii.

/mcp: configurazione dei server MCP

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

/mcp memorizza la configurazione nella configurazione di OpenClaw, non nelle impostazioni del progetto dell'agente incorporato. /mcp show oscura i campi contenenti credenziali, i valori dei flag riconosciuti relativi alle credenziali e gli argomenti noti con formato simile a un segreto. Quando viene eseguito da un gruppo, la configurazione viene inviata privatamente al proprietario; se non è disponibile alcun percorso privato verso il proprietario, il comando termina in modo sicuro e chiede al proprietario di riprovare da una chat diretta.

/debug: sostituzioni solo per il runtime

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

/plugins: gestione dei plugin

/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 aggiorna la configurazione dei plugin e ricarica a caldo il runtime dei plugin del Gateway per i nuovi turni dell'agente. /plugins install riavvia automaticamente i Gateway gestiti perché i moduli sorgente dei plugin sono cambiati. Le installazioni attendibili da ClawHub e dal catalogo ufficiale non richiedono conferme aggiuntive. Le origini arbitrarie npm, git, archivio, npm-pack: e percorso locale mostrano un avviso sulla provenienza e richiedono un --force finale dopo la verifica dell'origine. Questo flag conferma l'origine e consente di sostituire un'installazione esistente; non aggira security.installPolicy né i controlli di sicurezza del programma di installazione. Le versioni di ClawHub con avvisi di rischio richiedono comunque il flag separato, disponibile solo nella shell, --acknowledge-clawhub-risk. Anche le installazioni da marketplace, collegate e bloccate a una versione rimangono disponibili solo nella shell.

/trace: output di tracciamento dei plugin

/trace          # mostra lo stato corrente del tracciamento/trace on/trace off

/trace mostra le righe di tracciamento/debug dei plugin circoscritte alla sessione senza attivare la modalità completamente dettagliata. Non sostituisce /debug (sostituzioni del runtime) né /verbose (normale output degli strumenti).

/btw: domande secondarie

/btw è una domanda secondaria rapida sul contesto della sessione corrente. Alias: /side.

/btw che cosa stiamo facendo in questo momento?/side che cosa è cambiato mentre l'esecuzione principale proseguiva?

A differenza di un normale messaggio:

• Utilizza la sessione corrente come contesto di riferimento.
• Nelle sessioni dell'harness Codex, viene eseguita come thread secondario temporaneo di Codex.
• Non modifica il contesto futuro della sessione.
• Non viene scritta nella cronologia della trascrizione.

Per il comportamento completo, consultare Domande secondarie BTW.

Note sulle superfici

Utilizzo e stato del provider

• Utilizzo/quota del provider (ad es. "Claude: 80% rimanente") viene visualizzato in /status per il provider del modello corrente quando il monitoraggio dell'utilizzo è abilitato.
• Le righe relative a token/cache in /status possono ricorrere alla voce di utilizzo più recente della trascrizione quando l'istantanea della sessione attiva contiene pochi dati.
• Esecuzione e runtime: /status indica Execution per il percorso effettivo della sandbox e Runtime per indicare chi esegue la sessione: OpenClaw Default, OpenAI Codex, un backend CLI o un backend ACP.
• Token/costo per risposta: controllati da /usage off|tokens|full.
• /model status riguarda modelli/autenticazione/endpoint, non l'utilizzo.

Correlati