Przejdź do głównej treści
Gateway obsługuje polecenia wysyłane jako samodzielne wiadomości zaczynające się od /. Polecenia bash działające tylko na hoście używają ! <cmd> (z /bash <cmd> jako aliasem). Gdy konwersacja jest powiązana z sesją ACP, zwykły tekst trafia do harnessa ACP. Polecenia zarządzania Gateway pozostają lokalne: /acp ... zawsze trafia do procedury obsługi poleceń OpenClaw, a /status oraz /unfocus pozostają lokalne zawsze, gdy obsługa poleceń jest włączona dla danej powierzchni.

​
Trzy typy poleceń

Polecenia

Samodzielne wiadomości /... obsługiwane przez Gateway. Muszą być wysłane jako jedyna treść wiadomości.

Dyrektywy

/think, /fast, /verbose, /trace, /reasoning, /elevated, /exec, /model, /queue — usuwane z wiadomości, zanim zobaczy ją model. Utrwalają ustawienia sesji, gdy są wysłane samodzielnie; działają jako wskazówki w treści, gdy są wysłane z innym tekstem.

Skróty w treści

/help, /commands, /status, /whoami — uruchamiane natychmiast i usuwane, zanim model zobaczy pozostały tekst. Tylko autoryzowani nadawcy.
  • Dyrektywy są usuwane z wiadomości, zanim zobaczy ją model.
  • W wiadomościach zawierających tylko dyrektywy (wiadomość składa się wyłącznie z dyrektyw) są utrwalane w sesji i odpowiadają potwierdzeniem.
  • W wiadomościach normalnego czatu z innym tekstem działają jako wskazówki w treści i nie utrwalają ustawień sesji.
  • Dyrektywy mają zastosowanie tylko do autoryzowanych nadawców. Jeśli ustawiono commands.allowFrom, jest to jedyna używana lista dozwolonych nadawców; w przeciwnym razie autoryzacja pochodzi z list dozwolonych nadawców/parowania kanału oraz commands.useAccessGroups. Nieautoryzowani nadawcy widzą dyrektywy traktowane jako zwykły tekst.

​
Konfiguracja

{
  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.text
boolean
domyślnie:"true"
Włącza analizowanie /... w wiadomościach czatu. Na powierzchniach bez natywnych poleceń (WhatsApp, WebChat, Signal, iMessage, Google Chat, Microsoft Teams) polecenia tekstowe działają nawet wtedy, gdy ustawiono false.
​
commands.native
boolean | "auto"
domyślnie:"\"auto\""
Rejestruje natywne polecenia. Auto: włączone dla Discord/Telegram; wyłączone dla Slack; ignorowane dla dostawców bez natywnej obsługi. Nadpisz dla kanału za pomocą channels.<provider>.commands.native. W Discord false pomija rejestrację slash-command; wcześniej zarejestrowane polecenia mogą pozostać widoczne do momentu usunięcia.
​
commands.nativeSkills
boolean | "auto"
domyślnie:"\"auto\""
Rejestruje natywnie polecenia Skills, gdy jest to obsługiwane. Auto: włączone dla Discord/Telegram; wyłączone dla Slack. Nadpisz za pomocą channels.<provider>.commands.nativeSkills.
​
commands.bash
boolean
domyślnie:"false"
Włącza ! <cmd> do uruchamiania poleceń powłoki hosta (alias /bash <cmd>). Wymaga list dozwolonych tools.elevated.
​
commands.bashForegroundMs
number
domyślnie:"2000"
Jak długo bash czeka przed przełączeniem w tryb tła (0 przenosi w tło natychmiast).
​
commands.config
boolean
domyślnie:"false"
Włącza /config (odczytuje/zapisuje openclaw.json). Tylko właściciel.
​
commands.mcp
boolean
domyślnie:"false"
Włącza /mcp (odczytuje/zapisuje konfigurację MCP zarządzaną przez OpenClaw w mcp.servers). Tylko właściciel.
​
commands.plugins
boolean
domyślnie:"false"
Włącza /plugins (wykrywanie/status pluginów oraz instalowanie i włączanie/wyłączanie). Zapisy tylko dla właściciela.
​
commands.debug
boolean
domyślnie:"false"
Włącza /debug (nadpisania konfiguracji tylko w czasie działania). Tylko właściciel.
​
commands.restart
boolean
domyślnie:"true"
Włącza /restart oraz akcje narzędzi restartu gateway.
​
commands.ownerAllowFrom
string[]
Jawna lista dozwolonych właścicieli dla powierzchni poleceń dostępnych tylko dla właściciela. Oddzielna od commands.allowFrom i dostępu przez parowanie DM.
​
channels.<channel>.commands.enforceOwnerForCommands
boolean
domyślnie:"false"
Dla kanału: wymaga tożsamości właściciela dla poleceń dostępnych tylko dla właściciela. Gdy true, nadawca musi pasować do commands.ownerAllowFrom albo mieć wewnętrzny zakres operator.admin. Wpis wieloznaczny allowFrom nie wystarcza.
​
commands.ownerDisplay
"raw" | "hash"
Kontroluje, jak identyfikatory właściciela pojawiają się w prompcie systemowym.
​
commands.ownerDisplaySecret
string
Sekret HMAC używany, gdy commands.ownerDisplay: "hash".
​
commands.allowFrom
object
Lista dozwolonych nadawców dla autoryzacji poleceń, osobna dla każdego dostawcy. Po skonfigurowaniu jest jedynym źródłem autoryzacji dla poleceń i dyrektyw. Użyj "*" jako globalnej wartości domyślnej; klucze specyficzne dla dostawcy ją nadpisują.
​
commands.useAccessGroups
boolean
domyślnie:"true"
Wymusza listy dozwolonych nadawców/polityki dla poleceń, gdy commands.allowFrom nie jest ustawione.

​
Lista poleceń

Polecenia pochodzą z trzech źródeł:
  • Wbudowane polecenia core: src/auto-reply/commands-registry.shared.ts
  • Wygenerowane polecenia dock: src/auto-reply/commands-registry.data.ts
  • Polecenia pluginów: wywołania registerCommand() pluginów
Dostępność zależy od flag konfiguracji, powierzchni kanału oraz zainstalowanych/włączonych pluginów.

​
Polecenia core

PolecenieOpis
/new [model]Zarchiwizuj bieżącą sesję i rozpocznij nową
/reset [soft [message]]Zresetuj bieżącą sesję w miejscu. soft zachowuje transkrypt, usuwa ponownie używane identyfikatory sesji backendu CLI i ponownie uruchamia start
/name <title>Nadaj nazwę bieżącej sesji albo zmień jej nazwę. Pomiń tytuł, aby zobaczyć bieżącą nazwę i sugestię
/compact [instructions]Skompaktuj kontekst sesji. Zobacz Compaction
/stopPrzerwij bieżące uruchomienie
/session idle <duration|off>Zarządzaj wygasaniem bezczynności powiązania wątku
/session max-age <duration|off>Zarządzaj wygasaniem maksymalnego wieku powiązania wątku
/export-session [path]Wyeksportuj bieżącą sesję do HTML. Alias: /export
/export-trajectory [path]Wyeksportuj pakiet trajektorii JSONL dla bieżącej sesji. Alias: /trajectory
Control UI przechwytuje wpisane /new, aby utworzyć i przełączyć się na nową sesję dashboardu, z wyjątkiem sytuacji, gdy skonfigurowano session.dmScope: "main" i bieżący rodzic jest główną sesją agenta — w takim przypadku /new resetuje główną sesję w miejscu. Wpisane /reset nadal uruchamia reset w miejscu Gateway. Użyj /model default, gdy chcesz wyczyścić przypięty wybór modelu sesji.
PolecenieOpis
/think <level|default>Ustaw poziom myślenia albo wyczyść nadpisanie sesji. Aliasy: /thinking, /t
/verbose on|off|fullPrzełącz szczegółowe wyjście. Alias: /v
/trace on|offPrzełącz wyjście śledzenia pluginu dla bieżącej sesji
/fast [status|auto|on|off|default]Pokaż, ustaw albo wyczyść tryb szybki
/reasoning [on|off|stream]Przełącz widoczność rozumowania. Alias: /reason
/elevated [on|off|ask|full]Przełącz tryb podwyższony. Alias: /elev
/exec host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>Pokaż albo ustaw wartości domyślne exec
/login [codex|openai|openai-codex]Sparuj logowanie Codex/OpenAI z prywatnego czatu albo sesji Web UI. Tylko właściciel/admin
/model [name|#|status]Pokaż albo ustaw model
/models [provider] [page] [limit=<n>|all]Wypisz skonfigurowanych/dostępnych przez auth dostawców albo modele
/queue <mode>Zarządzaj zachowaniem kolejki aktywnych uruchomień. Zobacz Kolejka i Sterowanie kolejką
/steer <message>Wstrzyknij wskazówki do aktywnego uruchomienia. Alias: /tell. Zobacz Steer
  • /verbose służy do debugowania — w normalnym użyciu trzymaj je wyłączone.
  • /trace ujawnia tylko linie śledzenia/debugowania należące do pluginu; zwykłe szczegółowe komunikaty pozostają wyłączone.
  • /fast auto|on|off utrwala nadpisanie sesji; użyj opcji inherit w UI sesji, aby je wyczyścić.
  • /fast zależy od dostawcy: OpenAI/Codex mapują je na service_tier=priority; bezpośrednie żądania Anthropic mapują je na service_tier=auto albo standard_only.
  • /reasoning, /verbose i /trace są ryzykowne w ustawieniach grupowych — mogą ujawnić wewnętrzne rozumowanie albo diagnostykę pluginu. W czatach grupowych trzymaj je wyłączone.
  • /model natychmiast utrwala nowy model w sesji.
  • Jeśli agent jest bezczynny, następne uruchomienie użyje go od razu.
  • Jeśli uruchomienie jest aktywne, przełączenie jest oznaczane jako oczekujące i stosowane przy następnym czystym punkcie ponowienia.
PolecenieOpis
/helpPokaż krótkie podsumowanie pomocy
/commandsPokaż wygenerowany katalog poleceń
/tools [compact|verbose]Pokaż, czego bieżący agent może teraz użyć
/statusPokaż status wykonania/czasu działania, czas działania Gateway i systemu, stan pluginów oraz użycie/limit dostawcy
/status pluginsPokaż szczegółowy stan pluginów: błędy ładowania, kwarantanny, awarie kanałów, problemy z zależnościami, uwagi o zgodności
/goal [status|start|pause|resume|complete|block|clear] ...Zarządzaj trwałym celem bieżącej sesji
/diagnostics [note]Przepływ raportu wsparcia tylko dla właściciela. Za każdym razem prosi o zatwierdzenie exec
/crestodian <request>Uruchom pomocnika konfiguracji i naprawy Crestodian z DM właściciela
/tasksWypisz aktywne/ostatnie zadania w tle dla bieżącej sesji
/context [list|detail|map|json]Wyjaśnij, jak składany jest kontekst
/whoamiPokaż swój identyfikator nadawcy. Alias: /id
/usage off|tokens|full|reset|costKontroluj stopkę użycia dla odpowiedzi (reset/inherit/clear/default czyści nadpisanie sesji, aby ponownie odziedziczyć skonfigurowaną wartość domyślną) albo wydrukuj lokalne podsumowanie kosztów
PolecenieOpis
/skill <name> [input]Uruchom skill po nazwie
/allowlist [list|add|remove] ...Zarządzaj wpisami listy dozwolonych. Tylko tekst
/approve <id> <decision>Rozwiąż prompty zatwierdzeń exec albo pluginu
/btw <question>Zadaj pytanie poboczne bez zmieniania kontekstu sesji. Alias: /side. Zobacz BTW
PolecenieOpis
/subagents list|log|infoSprawdź uruchomienia subagentów w bieżącej sesji
/acp spawn|cancel|steer|close|sessions|status|set-mode|set|cwd|permissions|timeout|model|reset-options|doctor|install|helpZarządzaj sesjami ACP i opcjami środowiska uruchomieniowego. Sterowanie środowiskiem uruchomieniowym wymaga zewnętrznego właściciela albo wewnętrznej tożsamości administratora Gateway
/focus <target>Powiąż bieżący wątek Discord lub temat Telegram z celem sesji
/unfocusUsuń powiązanie bieżącego wątku
/agentsWyświetl agentów powiązanych z wątkiem dla bieżącej sesji
PolecenieWymagaOpis
/config show|get|set|unsetcommands.config: trueOdczytaj lub zapisz openclaw.json. Tylko dla właściciela
/mcp show|get|set|unsetcommands.mcp: trueOdczytaj lub zapisz konfigurację serwera MCP zarządzaną przez OpenClaw. Tylko dla właściciela
/plugins list|inspect|show|get|install|enable|disablecommands.plugins: trueSprawdź lub zmień stan plugin. Zapisy tylko dla właściciela. Alias: /plugin
/debug show|set|unset|resetcommands.debug: trueNadpisania konfiguracji tylko w środowisku uruchomieniowym. Tylko dla właściciela
/restartcommands.restart: true (domyślnie)Uruchom ponownie OpenClaw
/send on|off|inheritwłaścicielUstaw zasady wysyłania
PolecenieOpis
/tts on|off|status|chat|latest|provider|limit|summary|audio|helpSteruj TTS. Zobacz TTS
/activation mention|alwaysUstaw tryb aktywacji grupy
/bash <command>Uruchom polecenie powłoki hosta. Alias: ! <command>. Wymaga commands.bash: true
!poll [sessionId]Sprawdź zadanie bash działające w tle
!stop [sessionId]Zatrzymaj zadanie bash działające w tle

​
Polecenia Dock

Polecenia Dock przełączają trasę odpowiedzi aktywnej sesji do innego połączonego kanału. Zobacz dokowanie kanałów, aby uzyskać informacje o konfiguracji i rozwiązywaniu problemów. Wygenerowane z plugin kanałów obsługujących polecenia natywne:
  • /dock-discord (alias: /dock_discord)
  • /dock-mattermost (alias: /dock_mattermost)
  • /dock-slack (alias: /dock_slack)
  • /dock-telegram (alias: /dock_telegram)
Polecenia Dock wymagają session.identityLinks. Nadawca źródłowy i docelowy peer muszą być w tej samej grupie tożsamości.

​
Polecenia dołączonych plugin

PolecenieOpis
/dreaming [on|off|status|help]Włącz lub wyłącz Dreaming pamięci (właściciel albo administrator Gateway). Zobacz Dreaming
/pair [qr|status|pending|approve|cleanup|notify]Zarządzaj parowaniem urządzeń. Zobacz parowanie
/phone status|arm ...|disarmTymczasowo uzbrój polecenia węzła telefonu wysokiego ryzyka
/voice status|list|set <voiceId>Zarządzaj konfiguracją głosu Talk. Natywna nazwa Discord: /talkvoice
/card ...Wyślij presety kart rozszerzonych LINE. Zobacz LINE
/codex status|models|threads|resume|compact|review|diagnostics|account|mcp|skillsSteruj harness serwera aplikacji Codex. Zobacz harness Codex
Tylko QQBot: /bot-ping, /bot-version, /bot-help, /bot-upgrade, /bot-logs

​
Polecenia Skills

Skills wywoływane przez użytkownika są udostępniane jako polecenia ukośnikiem:
  • /skill <name> [input] zawsze działa jako ogólny punkt wejścia.
  • Skills mogą rejestrować się jako polecenia bezpośrednie (np. /prose dla OpenProse).
  • Natywna rejestracja poleceń Skills jest kontrolowana przez commands.nativeSkills oraz channels.<provider>.commands.nativeSkills.
  • Nazwy są oczyszczane do a-z0-9_ (maks. 32 znaki); kolizje dostają sufiksy numeryczne.
Domyślnie polecenia Skills są kierowane do modelu jako zwykłe żądanie.Skills mogą zadeklarować command-dispatch: tool, aby kierować bezpośrednio do narzędzia (deterministycznie, bez udziału modelu). Przykład: /prose (plugin OpenProse) — zobacz OpenProse.
Discord używa autouzupełniania dla opcji dynamicznych i menu przycisków, gdy wymagane argumenty są pominięte. Telegram i Slack pokazują menu przycisków dla poleceń z wyborami. Dynamiczne wybory są rozwiązywane względem modelu sesji docelowej, więc opcje zależne od modelu, takie jak poziomy /think, podążają za nadpisaniem /model sesji.

​
/tools — czego agent może teraz użyć

/tools odpowiada na pytanie środowiska uruchomieniowego: czego ten agent może użyć teraz w tej rozmowie — nie jest statycznym katalogiem konfiguracji. 
/tools         # compact view
/tools verbose # with short descriptions
Wyniki mają zakres sesji. Zmiana agenta, kanału, wątku, autoryzacji nadawcy lub modelu może zmienić wynik. Do edycji profilu i nadpisań użyj panelu Tools w Control UI albo powierzchni konfiguracji.

​
/model — wybór modelu

/model             # show model picker
/model list        # same
/model 3           # select by number from picker
/model openai/gpt-5.4
/model opus@anthropic:default
/model default     # clear the session model selection
/model status      # detailed view with endpoint and API mode
W Discord /model i /models otwierają interaktywny selektor z listami rozwijanymi dostawcy i modelu. Selektor respektuje agents.defaults.models, w tym wpisy provider/*.

​
/config — zapisy konfiguracji na dysku

Tylko dla właściciela. Domyślnie wyłączone — włącz przez commands.config: true.
/config show
/config show messages.responsePrefix
/config get messages.responsePrefix
/config set messages.responsePrefix="[openclaw]"
/config unset messages.responsePrefix
Konfiguracja jest walidowana przed zapisem. Nieprawidłowe zmiany są odrzucane. Aktualizacje /config utrzymują się po ponownych uruchomieniach.

​
/mcp — konfiguracja serwera MCP

Tylko dla właściciela. Domyślnie wyłączone — włącz przez commands.mcp: true.
/mcp show
/mcp show context7
/mcp set context7={"command":"uvx","args":["context7-mcp"]}
/mcp unset context7
/mcp przechowuje konfigurację w konfiguracji OpenClaw, a nie w ustawieniach projektu osadzonego agenta.

​
/debug — nadpisania tylko w środowisku uruchomieniowym

Tylko dla właściciela. Domyślnie wyłączone — włącz przez commands.debug: true. Nadpisania są stosowane natychmiast do nowych odczytów konfiguracji, ale nie są zapisywane na dysku.
/debug show
/debug set messages.responsePrefix="[openclaw]"
/debug set channels.whatsapp.allowFrom=["+1555","+4477"]
/debug unset messages.responsePrefix
/debug reset

​
/plugins — zarządzanie plugin

Zapisy tylko dla właściciela. Domyślnie wyłączone — włącz przez commands.plugins: true.
/plugins
/plugins list
/plugin show context7
/plugins enable context7
/plugins disable context7
/plugins install ./path/to/plugin
/plugins enable|disable aktualizuje konfigurację plugin i przeładowuje na gorąco środowisko uruchomieniowe plugin Gateway dla nowych tur agenta. /plugins install automatycznie uruchamia ponownie zarządzane Gateway, ponieważ moduły źródłowe plugin uległy zmianie.

​
/trace — wyjście śledzenia plugin

/trace          # show current trace state
/trace on
/trace off
/trace ujawnia linie śledzenia/debugowania plugin o zakresie sesji bez pełnego trybu szczegółowego. Nie zastępuje /debug (nadpisania środowiska uruchomieniowego) ani /verbose (normalne wyjście narzędzia).

​
/btw — pytania poboczne

/btw to szybkie pytanie poboczne dotyczące kontekstu bieżącej sesji. Alias: /side. 
/btw what are we doing right now?
/side what changed while the main run continued?
W przeciwieństwie do zwykłej wiadomości:
  • Używa bieżącej sesji jako kontekstu tła.
  • W sesjach harness Codex działa jako efemeryczny wątek poboczny Codex.
  • Nie zmienia przyszłego kontekstu sesji.
  • Nie jest zapisywane w historii transkryptu.
Zobacz pytania poboczne BTW, aby poznać pełne zachowanie.

​
Uwagi o powierzchniach

  • Polecenia tekstowe: działają w normalnej sesji czatu (DM współdzielą main, grupy mają własną sesję).
  • Natywne polecenia Discord: agent:<agentId>:discord:slash:<userId>
  • Natywne polecenia Slack: agent:<agentId>:slack:slash:<userId> (prefiks konfigurowalny przez channels.slack.slashCommand.sessionPrefix)
  • Natywne polecenia Telegram: telegram:slash:<userId> (kieruje do sesji czatu przez CommandTargetSessionKey)
  • /login codex wysyła kody parowania urządzenia tylko przez czat prywatny albo ścieżki odpowiedzi Web UI. Wywołania w grupie/temacie Telegram proszą właściciela, aby zamiast tego wysłał DM do bota.
  • /stop celuje w aktywną sesję czatu, aby przerwać bieżące uruchomienie.
channels.slack.slashCommand obsługuje pojedyncze polecenie w stylu /openclaw. Przy commands.native: true utwórz jedno polecenie ukośnikiem Slack dla każdego wbudowanego polecenia. Zarejestruj /agentstatus (nie /status), ponieważ Slack rezerwuje /status. Tekstowe /status nadal działa w wiadomościach Slack.
  • Wiadomości zawierające tylko polecenie od nadawców z listy dozwolonych są obsługiwane natychmiast (z pominięciem kolejki i modelu).
  • Skróty inline (/help, /commands, /status, /whoami) działają też osadzone w normalnych wiadomościach i są usuwane, zanim model zobaczy pozostały tekst.
  • Nieautoryzowane wiadomości zawierające tylko polecenie są po cichu ignorowane; tokeny inline /... są traktowane jako zwykły tekst.
  • Polecenia akceptują opcjonalny : między poleceniem a argumentami (/think: high, /send: on).
  • /new <model> akceptuje alias modelu, provider/model albo nazwę dostawcy (dopasowanie przybliżone); jeśli nie ma dopasowania, tekst jest traktowany jako treść wiadomości.
  • /allowlist add|remove wymaga commands.config: true i respektuje kanałowe configWrites.

​
Użycie i status dostawcy

  • Użycie/limit dostawcy (np. „Claude 80% left”) pokazuje się w /status dla bieżącego dostawcy modelu, gdy śledzenie użycia jest włączone.
  • Linie tokenów/pamięci podręcznej w /status mogą wrócić do najnowszego wpisu użycia transkryptu, gdy migawka sesji na żywo jest skąpa.
  • Wykonanie a środowisko uruchomieniowe: /status zgłasza Execution dla efektywnej ścieżki sandbox i Runtime dla tego, kto uruchamia sesję: OpenClaw Default, OpenAI Codex, backend CLI albo backend ACP.
  • Tokeny/koszt na odpowiedź: kontrolowane przez /usage off|tokens|full.
  • /model status dotyczy modeli/uwierzytelniania/endpointów, a nie użycia.

​
Powiązane

Skills

Jak polecenia ukośnikiem Skills są rejestrowane i bramkowane.

Tworzenie Skills

Zbuduj Skill, który rejestruje własne polecenie ukośnikiem.

BTW

Pytania poboczne bez zmiany kontekstu sesji.

Steer

Prowadź agenta w trakcie uruchomienia za pomocą /steer.