2026-01-06 20:45:40 +00:00
---
summary: "Slash commands: text vs native, config, and supported commands"
read_when:
- Using or configuring chat commands
- Debugging command routing or permissions
---
# Slash commands
Commands are handled by the Gateway. Send them as a **standalone** message that starts with `/` .
2026-01-08 22:57:08 +01:00
Inline text like `hello /status` is ignored for commands.
Directives (`/think` , `/verbose` , `/reasoning` , `/elevated` ) are parsed even when inline and are stripped from the message before the model sees it.
2026-01-06 20:45:40 +00:00
## Config
```json5
{
commands: {
native: false,
text: true,
useAccessGroups: true
}
}
```
- `commands.text` (default `true` ) enables parsing `/...` in chat messages.
- On surfaces without native commands (WhatsApp/WebChat/Signal/iMessage), text commands still work even if you set this to `false` .
- `commands.native` (default `false` ) registers native commands on Discord/Slack/Telegram.
- `false` clears previously registered commands on Discord/Telegram at startup.
- Slack commands are managed in the Slack app and are not removed automatically.
- `commands.useAccessGroups` (default `true` ) enforces allowlists/policies for commands.
## Command list
Text + native (when enabled):
- `/help`
- `/status`
2026-01-06 23:05:05 +00:00
- `/stop`
2026-01-06 20:45:40 +00:00
- `/restart`
- `/activation mention|always` (groups only)
- `/send on|off|inherit` (owner-only)
- `/reset` or `/new`
- `/think <level>` (aliases: `/thinking` , `/t` )
- `/verbose on|off` (alias: `/v` )
2026-01-07 11:08:11 +01:00
- `/reasoning on|off|stream` (alias: `/reason` ; `stream` = Telegram draft only)
2026-01-06 20:45:40 +00:00
- `/elevated on|off` (alias: `/elev` )
2026-01-07 19:58:23 +00:00
- `/model <name>` (or `/<alias>` from `agent.models.*.alias` )
2026-01-08 03:40:39 +01:00
- `/queue <mode>` (plus options like `debounce:2s cap:25 drop:summarize` ; send `/queue` to see current settings)
2026-01-06 20:45:40 +00:00
Text-only:
2026-01-07 18:12:17 +01:00
- `/compact [instructions]` (see [/concepts/compaction ](/concepts/compaction ))
2026-01-06 20:45:40 +00:00
2026-01-08 03:22:14 +01:00
Notes:
- Commands accept an optional `:` between the command and args (e.g. `/think: high` , `/send: on` , `/help:` ).
2026-01-06 20:45:40 +00:00
## Surface notes
- **Text commands** run in the normal chat session (DMs share `main` , groups have their own session).
- **Native commands** use isolated sessions: `discord:slash:<userId>` , `slack:slash:<userId>` , `telegram:slash:<userId>` .
2026-01-06 23:05:05 +00:00
- **`/stop` ** targets the active chat session so it can abort the current run.
2026-01-06 20:45:40 +00:00
- **Slack:** `slack.slashCommand` is still supported for a single `/clawd` -style command. If you enable `commands.native` , you must create one Slack slash command per built-in command (same names as `/help` ).
