Skip to main content
De Gateway verwerkt opdrachten die als zelfstandige berichten worden verzonden en beginnen met /. Bash-opdrachten die alleen op de host worden uitgevoerd, gebruiken ! <cmd> (met /bash <cmd> als alias). Wanneer een gesprek aan een ACP-sessie is gekoppeld, wordt normale tekst naar de ACP- harness gerouteerd. Beheeropdrachten voor de Gateway blijven lokaal: /acp ... bereikt altijd de OpenClaw-opdrachthandler, en /status plus /unfocus blijven lokaal wanneer opdrachtafhandeling voor het oppervlak is ingeschakeld.

Drie typen opdrachten

Opdrachten

Zelfstandige /...-berichten die door de Gateway worden verwerkt. Moeten als enige inhoud van het bericht worden verzonden.

Directieven

/think, /fast, /verbose, /trace, /reasoning, /elevated, /exec, /model, /queue — worden uit het bericht verwijderd voordat het model het ziet. Slaan sessie-instellingen blijvend op wanneer ze afzonderlijk worden verzonden; fungeren als inline-aanwijzingen wanneer ze samen met andere tekst worden verzonden.

Inline-snelkoppelingen

/help, /commands, /status, /whoami — worden onmiddellijk uitgevoerd en verwijderd voordat het model de resterende tekst ziet. Alleen geautoriseerde afzenders.
  • Directieven worden uit het bericht verwijderd voordat het model het ziet.
  • In berichten met alleen directieven (het bericht bevat uitsluitend directieven) worden ze blijvend in de sessie opgeslagen en wordt er met een bevestiging geantwoord.
  • In normale chatberichten met andere tekst fungeren ze als inline-aanwijzingen en worden sessie-instellingen niet blijvend opgeslagen.
  • Directieven zijn alleen van toepassing op geautoriseerde afzenders. Als commands.allowFrom is ingesteld, wordt uitsluitend die toelatingslijst gebruikt; anders is autorisatie afkomstig van kanaaltoelatingslijsten, koppeling en permanent afgedwongen toegangsgroepen. Bij niet-geautoriseerde afzenders worden directieven als platte tekst behandeld.

Configuratie

boolean
standaard:"true"
Schakelt het parseren van /... in chatberichten in. Op oppervlakken zonder systeemeigen opdrachten (WhatsApp, WebChat, Signal, iMessage, Google Chat, Microsoft Teams) werken tekst- opdrachten zelfs wanneer dit is ingesteld op false.
boolean | "auto"
standaard:"\"auto\""
Registreert systeemeigen opdrachten. Automatisch: ingeschakeld voor Discord/Telegram; uitgeschakeld voor Slack; genegeerd voor providers zonder systeemeigen ondersteuning. Overschrijf dit per kanaal met channels.<provider>.commands.native. Op Discord slaat false de registratie van slash-opdrachten over; eerder geregistreerde opdrachten kunnen zichtbaar blijven totdat ze worden verwijderd.
boolean | "auto"
standaard:"\"auto\""
Registreert Skills-opdrachten waar ondersteund als systeemeigen opdrachten. Automatisch: ingeschakeld voor Discord/Telegram; uitgeschakeld voor Slack. Overschrijf dit met channels.<provider>.commands.nativeSkills.
boolean
standaard:"false"
Schakelt ! <cmd> in om shellopdrachten op de host uit te voeren (/bash <cmd>-alias). Vereist tools.elevated-toelatingslijsten.
number
standaard:"2000"
Hoe lang bash wacht voordat naar de achtergrondmodus wordt overgeschakeld (0 schakelt onmiddellijk over naar de achtergrond).
boolean
standaard:"false"
Schakelt /config in (leest/schrijft openclaw.json). Alleen voor de eigenaar.
boolean
standaard:"false"
Schakelt /mcp in (leest/schrijft door OpenClaw beheerde MCP-configuratie onder mcp.servers). Alleen voor de eigenaar.
boolean
standaard:"false"
Schakelt /plugins in (detectie/status van plugins plus installeren en in-/uitschakelen). Schrijfbewerkingen zijn alleen voor de eigenaar.
boolean
standaard:"false"
Schakelt /debug in (configuratie-overschrijvingen alleen tijdens runtime). Alleen voor de eigenaar.
boolean
standaard:"true"
Schakelt /restart en externe SIGUSR1-herstartverzoeken in.
string[]
Expliciete toelatingslijst voor de eigenaar voor opdrachtoppervlakken die alleen voor de eigenaar zijn. Staat los van commands.allowFrom en toegang via DM-koppeling.
boolean
standaard:"false"
Per kanaal: vereist de identiteit van de eigenaar voor opdrachten die alleen voor de eigenaar zijn. Wanneer true, moet de afzender overeenkomen met commands.ownerAllowFrom of het interne bereik operator.admin hebben. Een jokertekenvermelding allowFrom is niet voldoende.
"raw" | "hash"
Bepaalt hoe eigenaar-id’s in de systeemprompt worden weergegeven.
string
HMAC-geheim dat wordt gebruikt wanneer commands.ownerDisplay: "hash".
object
Toelatingslijst per provider voor opdrachtautorisatie. Wanneer deze is geconfigureerd, is dit de enige autorisatiebron voor opdrachten en directieven. Gebruik "*" als algemene standaardwaarde; providerspecifieke sleutels overschrijven deze.

Opdrachtenlijst

Opdrachten zijn afkomstig uit drie bronnen:
  • Ingebouwde kernopdrachten: src/auto-reply/commands-registry.shared.ts
  • Gegenereerde dockopdrachten: src/auto-reply/commands-registry.data.ts
  • Pluginopdrachten: aanroepen van plugin registerCommand()
De beschikbaarheid hangt af van configuratievlaggen, het kanaaloppervlak en geïnstalleerde/ingeschakelde plugins.

Kernopdrachten

Expliciete /export-session-paden vervangen bestaande bestanden binnen de werkruimte. Laat het pad weg om een bestandsnaam te genereren die botsingen voorkomt.
De Control UI onderschept getypte /new om een nieuwe dashboardsessie te maken en ernaartoe over te schakelen, behalve wanneer session.dmScope: "main" is geconfigureerd en de huidige bovenliggende sessie de hoofdsessie van de agent is — in dat geval stelt /new de hoofdsessie ter plaatse opnieuw in. Getypte /reset voert nog steeds de interne reset van de Gateway uit. Gebruik /model default wanneer je een vastgezette modelselectie voor de sessie wilt wissen.
  • /verbose is bedoeld voor foutopsporing — houd dit bij normaal gebruik uitgeschakeld.
  • /trace toont alleen trace-/foutopsporingsregels die eigendom zijn van plugins; normale uitgebreide berichten blijven uitgeschakeld.
  • /fast auto|on|off slaat een sessie-overschrijving blijvend op; gebruik de optie inherit in de Sessions UI om deze te wissen.
  • /fast is providerspecifiek: OpenAI/Codex koppelen dit aan service_tier=priority; rechtstreekse Anthropic-verzoeken koppelen dit aan service_tier=auto of standard_only.
  • /reasoning, /verbose en /trace zijn riskant in groepsomgevingen — ze kunnen interne redeneringen of plugindiagnostiek onthullen. Houd ze uitgeschakeld in groepschats.
  • /model slaat het nieuwe model onmiddellijk blijvend op in de sessie.
  • Als de agent inactief is, gebruikt de volgende uitvoering het meteen.
  • Als er een uitvoering actief is, wordt de wisseling als in afwachting gemarkeerd en toegepast bij het volgende geldige nieuwe probeerpunt.

Dockopdrachten

Dockopdrachten schakelen de antwoordroute van de actieve sessie over naar een ander gekoppeld kanaal. Zie Kanaaldocking voor configuratie en probleemoplossing. Gegenereerd vanuit kanaalplugins met ondersteuning voor native opdrachten:
  • /dock-discord (alias: /dock_discord)
  • /dock-mattermost (alias: /dock_mattermost)
  • /dock-slack (alias: /dock_slack)
  • /dock-telegram (alias: /dock_telegram)
Dockopdrachten vereisen session.identityLinks. De afzender van de bron en de doelpeer moeten deel uitmaken van dezelfde identiteitsgroep.

Meegeleverde pluginopdrachten

Alleen voor QQBot: /bot-ping, /bot-version, /bot-help, /bot-upgrade, /bot-logs

Skillopdrachten

Door gebruikers aanroepbare skills worden beschikbaar gesteld als slash-opdrachten:
  • /skill <name> [input] werkt altijd als algemeen toegangspunt.
  • Skills kunnen als rechtstreekse opdrachten worden geregistreerd (bijvoorbeeld /prose voor OpenProse).
  • De registratie van native skillopdrachten wordt bestuurd door commands.nativeSkills en channels.<provider>.commands.nativeSkills.
  • Namen worden opgeschoond tot a-z0-9_ (maximaal 32 tekens); bij botsingen worden numerieke achtervoegsels toegevoegd.
Skillopdrachten worden standaard als een normaal verzoek naar het model gerouteerd.Skills kunnen command-dispatch: tool declareren om rechtstreeks naar een tool te routeren (deterministisch, zonder betrokkenheid van het model). Voorbeeld: /prose (OpenProse-plugin) — zie OpenProse.
Discord gebruikt automatisch aanvullen voor dynamische opties en knopmenu’s wanneer vereiste argumenten zijn weggelaten. Telegram en Slack tonen een knopmenu voor opdrachten met keuzemogelijkheden. Dynamische keuzemogelijkheden worden bepaald aan de hand van het model van de doelsessie, zodat model- specifieke opties zoals /think-niveaus de /model-overschrijving van de sessie volgen.

/tools: wat de agent nu kan gebruiken

/tools beantwoordt een runtimevraag: wat deze agent op dit moment in dit gesprek kan gebruiken — niet een statische configuratiecatalogus.
Resultaten gelden per sessie. Als je de agent, het kanaal, de thread, de autorisatie van de afzender of het model wijzigt, kan de uitvoer veranderen. Gebruik voor het bewerken van profielen en overschrijvingen het paneel Tools in de Control UI of configuratieoppervlakken.

/model: modelselectie

In Discord openen /model en /models een interactieve kiezer met vervolgkeuzelijsten voor providers en modellen. De kiezer respecteert agents.defaults.modelPolicy.allow, inclusief provider/*-vermeldingen. Zonder een expliciete toelatingslijst beperken modelvermeldingen en aliassen de selectie niet.

/config: configuratie naar schijf schrijven

Alleen voor eigenaren. Standaard uitgeschakeld — schakel dit in met commands.config: true.
De configuratie wordt vóór het schrijven gevalideerd. Ongeldige wijzigingen worden geweigerd. /config- updates blijven na opnieuw starten behouden.

/mcp: MCP-serverconfiguratie

Alleen voor eigenaren. Standaard uitgeschakeld — schakel dit in met commands.mcp: true.
/mcp slaat de configuratie op in de OpenClaw-configuratie, niet in de projectinstellingen van de ingebedde agent. /mcp show maakt velden met aanmeldgegevens, waarden van herkende vlaggen voor aanmeldgegevens en bekende argumenten die op geheimen lijken onleesbaar. Wanneer de opdracht vanuit een groep wordt uitgevoerd, wordt de configuratie privé naar de eigenaar verzonden; als er geen privéroute naar de eigenaar beschikbaar is, wordt de opdracht veilig afgebroken en wordt de eigenaar gevraagd het opnieuw te proberen vanuit een rechtstreeks gesprek.

/debug: overschrijvingen die alleen tijdens runtime gelden

Alleen voor eigenaren. Standaard uitgeschakeld — schakel dit in met commands.debug: true. Overschrijvingen worden onmiddellijk toegepast op nieuwe configuratielezingen, maar schrijven niet naar schijf.

/plugins: pluginbeheer

Schrijfbewerkingen alleen voor eigenaren. Standaard uitgeschakeld — schakel dit in met commands.plugins: true.
/plugins enable|disable werkt de pluginconfiguratie bij en herlaadt de pluginruntime van de Gateway tijdens bedrijf voor nieuwe agentbeurten. /plugins install start beheerde Gateways automatisch opnieuw omdat de bronmodules van de plugin zijn gewijzigd. Voor installaties uit vertrouwde ClawHub- bronnen en de officiële catalogus is geen extra bevestiging nodig. Willekeurige npm-, git-, archief-, npm-pack:- en lokale padbronnen tonen een herkomstwaarschuwing en vereisen een afsluitende --force nadat je de bron hebt gecontroleerd. Deze vlag bevestigt de bron en staat vervanging van een bestaande installatie toe; de vlag omzeilt security.installPolicy of de beveiligingscontroles van het installatieprogramma niet. Voor ClawHub-releases met risicowaarschuwingen blijft de afzonderlijke, uitsluitend via de shell beschikbare vlag --acknowledge-clawhub-risk vereist. Marketplace-, gekoppelde en vastgezette installaties blijven eveneens uitsluitend via de shell beschikbaar.

/trace: uitvoer van plugintracering

/trace toont sessiespecifieke tracerings-/debugregels van plugins zonder de volledig uitgebreide modus. Dit vervangt /debug (runtimeoverschrijvingen) of /verbose (normale tooluitvoer) niet.

/btw: tussenvragen

/btw is een snelle tussenvraag over de huidige sessiecontext. Alias: /side.
In tegenstelling tot een normaal bericht:
  • Gebruikt de huidige sessie als achtergrondcontext.
  • Wordt in Codex-harnassessies uitgevoerd als een tijdelijke Codex-zijthread.
  • Wijzigt toekomstige sessiecontext niet.
  • Wordt niet naar de transcriptgeschiedenis geschreven.
Zie BTW-tussenvragen voor het volledige gedrag.

Opmerkingen per oppervlak

  • Tekstopdrachten: worden uitgevoerd in de normale chatsessie (privéberichten delen main, groepen hebben hun eigen sessie).
  • Native Discord-opdrachten: agent:<agentId>:discord:slash:<userId>
  • Native Slack-opdrachten: agent:<agentId>:slack:slash:<userId> (voorvoegsel configureerbaar via channels.slack.slashCommand.sessionPrefix)
  • Native Telegram-opdrachten: telegram:slash:<userId> (richten zich via CommandTargetSessionKey op de chatsessie)
  • /login codex verzendt apparaatkoppelingscodes alleen via privégesprekken of antwoordpaden van de Web UI. Bij aanroepen vanuit Telegram-groepen/-onderwerpen wordt de eigenaar gevraagd de bot in een privébericht te benaderen.
  • /stop richt zich op de actieve chatsessie om de huidige uitvoering af te breken.
channels.slack.slashCommand ondersteunt één opdracht in /openclaw-stijl. Maak met commands.native: true één Slack-slashopdracht per ingebouwde opdracht. Registreer /agentstatus (niet /status), omdat Slack /status reserveert. Tekst /status werkt nog steeds in Slack-berichten.
  • Berichten die alleen een opdracht bevatten van afzenders op de toelatingslijst, worden onmiddellijk verwerkt (omzeilen wachtrij + model).
  • Inline-snelkoppelingen (/help, /commands, /status, /whoami) werken ook wanneer ze in normale berichten zijn opgenomen en worden verwijderd voordat het model de resterende tekst ziet.
  • Ongeautoriseerde berichten die alleen een opdracht bevatten, worden stilzwijgend genegeerd; inline /...-tokens worden als platte tekst behandeld.
  • Opdrachten accepteren een optionele : tussen de opdracht en de argumenten (/think: high, /send: on).
  • /new <model> accepteert een modelalias, provider/model of een providernaam (globale overeenkomst); als er geen overeenkomst is, wordt de tekst als de berichttekst behandeld.
  • /allowlist add|remove vereist commands.config: true en respecteert configWrites van het kanaal.

Providergebruik en -status

  • Providergebruik/-quotum (bijv. “Claude 80% resterend”) wordt in /status weergegeven voor de huidige modelprovider wanneer gebruiksregistratie is ingeschakeld.
  • Token-/cacheregels in /status kunnen terugvallen op de nieuwste gebruiksvermelding in het transcript wanneer de momentopname van de live sessie weinig gegevens bevat.
  • Uitvoering versus runtime: /status rapporteert Execution voor het effectieve sandboxpad en Runtime voor wie de sessie uitvoert: OpenClaw Default, OpenAI Codex, een CLI-backend of een ACP-backend.
  • Tokens/kosten per antwoord: beheerd door /usage off|tokens|full.
  • /model status gaat over modellen/authenticatie/eindpunten, niet over gebruik.

Gerelateerd

Skills

Hoe slashopdrachten van Skills worden geregistreerd en afgeschermd.

Skills maken

Bouw een Skill die zijn eigen slashopdracht registreert.

BTW

Zijvragen zonder de sessiecontext te wijzigen.

Sturen

Stuur de agent tijdens de uitvoering met /steer.