Mga slash command¶

Ang mga command ay pinoproseso ng Gateway. Karamihan sa mga command ay dapat ipadala bilang hiwalay na mensahe na nagsisimula sa /. The host-only bash chat command uses ! <cmd> (with /bash <cmd> as an alias).

May dalawang magkakaugnay na sistema:

• Commands: mga standalone na /... na mensahe.
• Mga Direktiba: /think, /verbose, /reasoning, /elevated, /exec, /model, /queue.
• Tinatanggal ang mga directive mula sa mensahe bago ito makita ng model.
• Sa normal na mga chat message (hindi directive-only), itinuturing silang “inline hints” at hindi nagpapanatili ng mga setting ng session.
• Sa directive-only na mga mensahe (ang mensahe ay naglalaman lamang ng mga directive), nagpapanatili sila sa session at nagre-reply ng isang acknowledgement.
• Directives are only applied for authorized senders (channel allowlists/pairing plus commands.useAccessGroups). Unauthorized senders see directives treated as plain text.

Mayroon ding ilang inline shortcut (para lamang sa allowlisted/awtorisadong mga nagpadala): /help, /commands, /status, /whoami (/id). They run immediately, are stripped before the model sees the message, and the remaining text continues through the normal flow.

Config¶

{
  commands: {
    native: "auto",
    nativeSkills: "auto",
    text: true,
    bash: false,
    bashForegroundMs: 2000,
    config: false,
    debug: false,
    restart: false,
    useAccessGroups: true,
  },
}

• commands.text (default true) ay nag-e-enable ng pag-parse ng /... sa mga chat message.
• Sa mga surface na walang native commands (WhatsApp/WebChat/Signal/iMessage/Google Chat/MS Teams), gumagana pa rin ang mga text command kahit itakda mo ito sa false.
• commands.native (default "auto") ay nagrerehistro ng mga native command.
• Auto: naka-on para sa Discord/Telegram; naka-off para sa Slack (hanggang magdagdag ka ng slash commands); hindi pinapansin para sa mga provider na walang native support.
• Itakda ang channels.discord.commands.native, channels.telegram.commands.native, o channels.slack.commands.native para i-override kada provider (bool o "auto").
• Ang false ay naglilinis ng mga naunang nairehistrong command sa Discord/Telegram sa pagsisimula. Ang mga Slack command ay pinamamahalaan sa Slack app at hindi awtomatikong inaalis.
• commands.nativeSkills (default "auto") ay nagrerehistro ng mga skill command nang native kapag sinusuportahan.
• Auto: naka-on para sa Discord/Telegram; naka-off para sa Slack (kinakailangan ng Slack ang paggawa ng isang slash command kada skill).
• Itakda ang channels.discord.commands.nativeSkills, channels.telegram.commands.nativeSkills, o channels.slack.commands.nativeSkills para i-override kada provider (bool o "auto").
• Ang commands.bash (default na false) ay nagpapagana sa ! <cmd> upang patakbuhin ang mga host shell command (/bash <cmd> ay isang alias; nangangailangan ng tools.elevated allowlists).
• commands.bashForegroundMs (default 2000) ay kumokontrol kung gaano katagal maghihintay ang bash bago lumipat sa background mode (0 ay agad na nagba-background).
• commands.config (default false) ay nag-e-enable sa /config (nagbabasa/nagsusulat ng openclaw.json).
• commands.debug (default false) ay nag-e-enable sa /debug (runtime-only na mga override).
• commands.useAccessGroups (default true) ay nagpapatupad ng mga allowlist/patakaran para sa mga command.

Command list¶

Text + native (kapag naka-enable):

• /help
• /commands
• /skill <name> [input] (magpatakbo ng skill ayon sa pangalan)
• /status (ipakita ang kasalukuyang status; kasama ang provider usage/quota para sa kasalukuyang model provider kapag available)
• /allowlist (ilista/idagdag/alisin ang mga entry ng allowlist)
• /approve <id> allow-once|allow-always|deny (i-resolve ang mga exec approval prompt)
• /context [list|detail|json] (ipaliwanag ang “context”; ipinapakita ng detail ang per-file + per-tool + per-skill + laki ng system prompt)
• /whoami (ipakita ang iyong sender id; alias: /id)
• /subagents list|stop|log|info|send (suriin, ihinto, i-log, o i-message ang mga sub-agent run para sa kasalukuyang session)
• /config show|get|set|unset (i-persist ang config sa disk, owner-only; nangangailangan ng commands.config: true)
• /debug show|set|unset|reset (runtime overrides, owner-only; nangangailangan ng commands.debug: true)
• /usage off|tokens|full|cost (per-response na usage footer o lokal na cost summary)
• /tts off|always|inbound|tagged|status|provider|limit|summary|audio (kontrolin ang TTS; tingnan ang /tts)
• Discord: ang native command ay /voice (nirereserba ng Discord ang /tts); gumagana pa rin ang text /tts.
• /stop
• /restart
• /dock-telegram (alias: /dock_telegram) (ilipat ang mga reply sa Telegram)
• /dock-discord (alias: /dock_discord) (ilipat ang mga reply sa Discord)
• /dock-slack (alias: /dock_slack) (ilipat ang mga reply sa Slack)
• /activation mention|always (mga grupo lamang)
• /send on|off|inherit (owner-only)
• /reset o /new [model] (opsyonal na model hint; ang natitira ay ipinapasa)
• /think <off|minimal|low|medium|high|xhigh> (dynamic na mga pagpipilian ayon sa model/provider; mga alias: /thinking, /t)
• /verbose on|full|off (alias: /v)
• /reasoning on|off|stream (alias: /reason; kapag naka-on, nagpapadala ng hiwalay na mensahe na may prefix na Reasoning:; stream = Telegram draft lamang)
• /elevated on|off|ask|full (alias: /elev; nilalampasan ng full ang mga exec approval)
• /exec host=<sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id> (magpadala ng /exec para ipakita ang kasalukuyan)
• /model <name> (alias: /models; o /<alias> mula sa agents.defaults.models.*.alias)
• /queue <mode> (kasama ang mga opsyon tulad ng debounce:2s cap:25 drop:summarize; magpadala ng /queue para makita ang kasalukuyang mga setting)
• /bash <command> (host-only; alias for ! <command>; requires commands.bash: true + tools.elevated allowlists)

Text-only:

• /compact [instructions] (tingnan ang /concepts/compaction)
• ! <command> (host-only; one at a time; use !poll + !stop for long-running jobs)
• !poll (suriin ang output / status; tumatanggap ng opsyonal na sessionId; gumagana rin ang /bash poll)
• !stop (ihinto ang tumatakbong bash job; tumatanggap ng opsyonal na sessionId; gumagana rin ang /bash stop)

Mga tala:

• Tumatanggap ang mga command ng opsyonal na : sa pagitan ng command at mga arg (hal. /think: high, /send: on, /help:).
• Tumatanggap ang /new <model> ng model alias, provider/model, o pangalan ng provider (fuzzy match); kung walang tugma, itinuturing ang teksto bilang body ng mensahe.
• Para sa buong breakdown ng provider usage, gamitin ang openclaw status --usage.
• Ang /allowlist add|remove ay nangangailangan ng commands.config=true at iginagalang ang channel configWrites.
• Kinokontrol ng /usage ang per-response na usage footer; ang /usage cost ay nagpi-print ng lokal na cost summary mula sa mga log ng OpenClaw session.
• Ang /restart ay naka-disable bilang default; itakda ang commands.restart: true para i-enable ito.
• Ang /verbose ay para sa pag-debug at dagdag na visibility; panatilihing off sa normal na paggamit.
• /reasoning (and /verbose) are risky in group settings: they may reveal internal reasoning or tool output you did not intend to expose. Prefer leaving them off, especially in group chats.
• Fast path: ang mga command-only na mensahe mula sa allowlisted na sender ay hinahawakan agad (nilalampasan ang queue + model).
• Group mention gating: ang mga command-only na mensahe mula sa allowlisted na sender ay nilalampasan ang mga kinakailangan sa mention.
• Inline shortcuts (allowlisted sender lamang): ang ilang command ay gumagana rin kapag naka-embed sa isang normal na mensahe at tinatanggal bago makita ng model ang natitirang teksto.
• Halimbawa: ang hey /status ay nagti-trigger ng status reply, at ang natitirang teksto ay nagpapatuloy sa normal na daloy.
• Sa kasalukuyan: /help, /commands, /status, /whoami (/id).
• Ang mga hindi awtorisadong command-only na mensahe ay tahimik na binabalewala, at ang mga inline /... token ay itinuturing bilang plain text.
• Skill commands: user-invocable skills are exposed as slash commands. Names are sanitized to a-z0-9_ (max 32 chars); collisions get numeric suffixes (e.g. _2).
• Pinapatakbo ng /skill <name> [input] ang isang skill ayon sa pangalan (kapaki-pakinabang kapag ang mga limitasyon ng native command ay pumipigil sa per-skill na mga command).
• Bilang default, ang mga skill command ay ipinapasa sa model bilang isang normal na request.
• Maaaring opsyonal na magdeklara ang mga Skill ng command-dispatch: tool upang i-route ang command direkta sa isang tool (deterministic, walang model).
• Halimbawa: /prose (OpenProse plugin) — tingnan ang OpenProse.
• Ipinapakita ng Telegram at Slack ang isang button menu kapag ang isang command ay may suportadong mga pagpipilian at inalis mo ang arg. Telegram and Slack show a button menu when a command supports choices and you omit the arg.

Usage surfaces (ano ang lumalabas saan)¶

• Provider usage/quota (halimbawa: “Claude 80% left”) ay lumalabas sa /status para sa kasalukuyang model provider kapag naka-enable ang usage tracking.
• Per-response tokens/cost ay kinokontrol ng /usage off|tokens|full (idinadagdag sa mga normal na reply).
• Ang /model status ay tungkol sa models/auth/endpoints, hindi usage.

Model selection (/model)¶

Ang /model ay ipinatutupad bilang isang directive.

Mga halimbawa:

/model
/model list
/model 3
/model openai/gpt-5.2
/model opus@anthropic:default
/model status

Mga tala:

• Ang /model at /model list ay nagpapakita ng compact, may bilang na picker (model family + mga available na provider).
• Pinipili ng /model <#> mula sa picker na iyon (at mas pinipili ang kasalukuyang provider kapag posible).
• Ipinapakita ng /model status ang detalyadong view, kabilang ang naka-configure na provider endpoint (baseUrl) at API mode (api) kapag available.

Debug overrides¶

/debug lets you set runtime-only config overrides (memory, not disk). Naka-disable bilang default; paganahin gamit ang commands.debug: true. Ang /config ay nagsusulat sa iyong on-disk config (openclaw.json).

Mga halimbawa:

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

Mga tala:

• Agad na ina-apply ang mga override sa mga bagong pagbasa ng config, ngunit hindi nagsusulat sa openclaw.json.
• Gamitin ang /debug reset para i-clear ang lahat ng override at bumalik sa on-disk na config.

Config updates¶

Owner-only. Naka-disable bilang default; paganahin gamit ang commands.config: true. Slack: Ang channels.slack.slashCommand ay suportado pa rin para sa iisang /openclaw-style na command.

Mga halimbawa:

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

Mga tala:

• Binabalidate ang config bago magsulat; tinatanggihan ang mga invalid na pagbabago.
• Ang mga update ng /config ay nagpapatuloy kahit mag-restart.

Surface notes¶

• Text commands ay tumatakbo sa normal na chat session (ang mga DM ay nagbabahagi ng main, ang mga grupo ay may sariling session).
• Native commands ay gumagamit ng mga hiwalay na session:
• Discord: agent:<agentId>:discord:slash:<userId>
• Slack: agent:<agentId>:slack:slash:<userId> (ang prefix ay configurable sa pamamagitan ng channels.slack.slashCommand.sessionPrefix)
• Telegram: telegram:slash:<userId> (tinutumbok ang chat session sa pamamagitan ng CommandTargetSessionKey)
• Ang /stop ay tumutumbok sa aktibong chat session upang ma-abort nito ang kasalukuyang run.
• Slack: channels.slack.slashCommand is still supported for a single /openclaw-style command. If you enable commands.native, you must create one Slack slash command per built-in command (same names as /help). Ang mga sub-agent ay mga background agent run na nililikha mula sa isang umiiral na agent run.