Skip to main content
Gateway obsługuje polecenia wysyłane jako samodzielne wiadomości rozpoczynające się od /. Polecenia bash wykonywane wyłącznie na hoście używają ! <cmd> (z /bash <cmd> jako aliasem). Gdy konwersacja jest powiązana z sesją ACP, zwykły tekst jest kierowany do środowiska ACP. Polecenia zarządzania Gateway pozostają lokalne: /acp ... zawsze trafia do procedury obsługi poleceń OpenClaw, a /status oraz /unfocus pozostają lokalne, gdy obsługa poleceń jest włączona dla danego interfejsu.

Trzy typy poleceń

Polecenia

Samodzielne wiadomości /... obsługiwane przez Gateway. Muszą stanowić jedyną 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ą wysyłane samodzielnie; działają jako wskazówki w treści, gdy są wysyłane z innym tekstem.

Skróty w treści

/help, /commands, /status, /whoami — są wykonywane natychmiast i usuwane, zanim model zobaczy pozostały tekst. Tylko dla autoryzowanych nadawców.
  • Dyrektywy są usuwane z wiadomości, zanim zobaczy ją model.
  • W wiadomościach zawierających wyłącznie dyrektywy (wiadomość składa się tylko z dyrektyw) są one utrwalane w sesji, a odpowiedź zawiera potwierdzenie.
  • W wiadomościach zwykłego czatu zawierających inny tekst 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; w przeciwnym razie autoryzacja wynika z list dozwolonych/parowania kanałów oraz commands.useAccessGroups. W przypadku nieautoryzowanych nadawców dyrektywy są traktowane jak zwykły tekst.

Konfiguracja

boolean
domyślnie:"true"
Włącza analizowanie /... w wiadomościach czatu. W interfejsach bez poleceń natywnych (WhatsApp, WebChat, Signal, iMessage, Google Chat, Microsoft Teams) polecenia tekstowe działają nawet po ustawieniu na false.
boolean | "auto"
domyślnie:"\"auto\""
Rejestruje polecenia natywne. Tryb automatyczny: włączony dla Discord/Telegram; wyłączony dla Slack; ignorowany przez dostawców bez obsługi natywnej. Można go nadpisać dla poszczególnych kanałów za pomocą channels.<provider>.commands.native. W Discord false pomija rejestrację poleceń z ukośnikiem; wcześniej zarejestrowane polecenia mogą pozostać widoczne do czasu ich usunięcia.
boolean | "auto"
domyślnie:"\"auto\""
Rejestruje natywnie polecenia umiejętności, jeśli jest to obsługiwane. Tryb automatyczny: włączony dla Discord/Telegram; wyłączony dla Slack. Można go nadpisać za pomocą channels.<provider>.commands.nativeSkills.
boolean
domyślnie:"false"
Włącza ! <cmd> do wykonywania poleceń powłoki hosta (alias /bash <cmd>). Wymaga list dozwolonych tools.elevated.
number
domyślnie:"2000"
Czas oczekiwania bash przed przejściem w tryb działania w tle (0 natychmiast przełącza działanie w tło).
boolean
domyślnie:"false"
Włącza /config (odczytuje/zapisuje openclaw.json). Tylko dla właściciela.
boolean
domyślnie:"false"
Włącza /mcp (odczytuje/zapisuje konfigurację MCP zarządzaną przez OpenClaw w mcp.servers). Tylko dla właściciela.
boolean
domyślnie:"false"
Włącza /plugins (wykrywanie/status pluginów oraz instalowanie i włączanie/wyłączanie). Operacje zapisu tylko dla właściciela.
boolean
domyślnie:"false"
Włącza /debug (nadpisania konfiguracji tylko na czas działania). Tylko dla właściciela.
boolean
domyślnie:"true"
Włącza /restart oraz zewnętrzne żądania ponownego uruchomienia SIGUSR1.
string[]
Jawna lista właścicieli dozwolonych dla interfejsów poleceń dostępnych tylko właścicielowi. Niezależna od commands.allowFrom i dostępu przez parowanie wiadomości prywatnych.
boolean
domyślnie:"false"
Ustawienie dla kanału: wymaga tożsamości właściciela dla poleceń dostępnych tylko właścicielowi. Gdy true, nadawca musi odpowiadać commands.ownerAllowFrom lub mieć wewnętrzny zakres operator.admin. Wpis wieloznaczny allowFrom nie jest wystarczający.
"raw" | "hash"
Określa sposób wyświetlania identyfikatorów właścicieli w monicie systemowym.
string
Sekret HMAC używany, gdy commands.ownerDisplay: "hash".
object
Lista dozwolonych dla poszczególnych dostawców używana do autoryzacji poleceń. Po jej skonfigurowaniu jest jedynym źródłem autoryzacji poleceń i dyrektyw. "*" służy jako globalna wartość domyślna; klucze specyficzne dla dostawców ją nadpisują.
boolean
domyślnie:"true"
Wymusza listy dozwolonych/zasady dla poleceń, gdy commands.allowFrom nie jest ustawione.

Lista poleceń

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

Polecenia podstawowe

Jawne ścieżki /export-session zastępują istniejące pliki w obszarze roboczym. Pominięcie ścieżki powoduje wygenerowanie nazwy pliku odpornej na kolizje.
Control UI przechwytuje wpisane /new, aby utworzyć nową sesję panelu i przełączyć się na nią, z wyjątkiem sytuacji, gdy skonfigurowano session.dmScope: "main", a bieżącym elementem nadrzędnym jest główna sesja agenta — w takim przypadku /new resetuje główną sesję w miejscu. Wpisane /reset nadal wykonuje reset w miejscu przez Gateway. Użyj /model default, aby wyczyścić przypisany do sesji wybór modelu.
  • /verbose służy do debugowania — podczas zwykłego użycia należy pozostawić je wyłączone.
  • /trace ujawnia tylko wiersze śledzenia/debugowania należące do pluginu; zwykłe szczegółowe komunikaty pozostają wyłączone.
  • /fast auto|on|off utrwala nadpisanie sesji; aby je wyczyścić, użyj opcji inherit w interfejsie Sessions.
  • /fast zależy od dostawcy: OpenAI/Codex mapują je na service_tier=priority; bezpośrednie żądania Anthropic mapują je na service_tier=auto lub standard_only.
  • /reasoning, /verbose i /trace są ryzykowne w ustawieniach grupowych — mogą ujawnić wewnętrzne rozumowanie lub diagnostykę pluginu. W czatach grupowych należy pozostawić je wyłączone.
  • /model natychmiast utrwala nowy model w sesji.
  • Jeśli agent jest bezczynny, następny przebieg od razu go użyje.
  • Jeśli przebieg jest aktywny, przełączenie zostaje oznaczone jako oczekujące i zastosowane przy następnym bezpiecznym punkcie ponowienia.

Polecenia dokowania

Polecenia dokowania przełączają trasę odpowiedzi aktywnej sesji na inny połączony kanał. Informacje o konfiguracji i rozwiązywaniu problemów zawiera Dokowanie kanałów. Generowane przez pluginy kanałów obsługujące polecenia natywne:
  • /dock-discord (alias: /dock_discord)
  • /dock-mattermost (alias: /dock_mattermost)
  • /dock-slack (alias: /dock_slack)
  • /dock-telegram (alias: /dock_telegram)
Polecenia dokowania wymagają session.identityLinks. Nadawca źródłowy i docelowy uczestnik muszą należeć do tej samej grupy tożsamości.

Polecenia dołączonych pluginów

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

Polecenia skilli

Skille dostępne dla użytkowników są udostępniane jako polecenia z ukośnikiem:
  • /skill <name> [input] zawsze działa jako ogólny punkt wejścia.
  • Skille mogą być rejestrowane jako polecenia bezpośrednie (np. /prose dla OpenProse).
  • Rejestrowaniem natywnych poleceń skilli sterują commands.nativeSkills oraz channels.<provider>.commands.nativeSkills.
  • Nazwy są oczyszczane do postaci a-z0-9_ (maks. 32 znaki); w przypadku kolizji dodawane są sufiksy numeryczne.
Domyślnie polecenia skilli są przekazywane do modelu jako zwykłe żądania.Skille mogą zadeklarować command-dispatch: tool, aby kierować żądania 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 oraz menu przycisków, gdy pominięto wymagane argumenty. Telegram i Slack wyświetlają menu przycisków dla poleceń z dostępnymi opcjami. Opcje dynamiczne są rozstrzygane na podstawie docelowego modelu sesji, dlatego opcje specyficzne dla modelu, takie jak poziomy /think, uwzględniają nadpisanie /model sesji.

/tools: czego agent może teraz używać

/tools odpowiada na pytanie dotyczące środowiska uruchomieniowego: z czego ten agent może korzystać teraz w tej rozmowie — nie jest to statyczny katalog konfiguracji.
Wyniki są ograniczone do sesji. Zmiana agenta, kanału, wątku, autoryzacji nadawcy lub modelu może zmienić dane wyjściowe. Do edycji profilu i nadpisań należy użyć panelu Tools w interfejsie Control UI lub powierzchni konfiguracji.

/model: wybór modelu

W Discord polecenia /model i /models otwierają interaktywny selektor z listami rozwijanymi dostawcy i modelu. Selektor uwzględnia agents.defaults.models, w tym wpisy provider/*.

/config: zapis konfiguracji na dysku

Tylko dla właściciela. Domyślnie wyłączone — włącza się za pomocą commands.config: true.
Konfiguracja jest sprawdzana przed zapisem. Nieprawidłowe zmiany są odrzucane. Aktualizacje /config są zachowywane po ponownym uruchomieniu.

/mcp: konfiguracja serwera MCP

Tylko dla właściciela. Domyślnie wyłączone — włącza się za pomocą commands.mcp: true.
/mcp przechowuje konfigurację w konfiguracji OpenClaw, a nie w ustawieniach projektu osadzonego agenta. /mcp show maskuje pola zawierające dane uwierzytelniające, wartości rozpoznanych flag danych uwierzytelniających oraz argumenty o znanych wzorcach sekretów. Po uruchomieniu z grupy konfiguracja jest wysyłana prywatnie do właściciela; jeśli prywatna trasa do właściciela nie jest dostępna, polecenie bezpiecznie kończy się niepowodzeniem i prosi właściciela o ponowienie próby na czacie bezpośrednim.

/debug: nadpisania tylko w środowisku uruchomieniowym

Tylko dla właściciela. Domyślnie wyłączone — włącza się za pomocą commands.debug: true. Nadpisania są natychmiast stosowane do nowych odczytów konfiguracji, ale nie są zapisywane na dysku.

/plugins: zarządzanie pluginami

Zapisy tylko dla właściciela. Domyślnie wyłączone — włącza się za pomocą commands.plugins: true.
/plugins enable|disable aktualizuje konfigurację pluginu i przeładowuje na gorąco środowisko uruchomieniowe pluginów Gateway na potrzeby nowych tur agenta. /plugins install automatycznie ponownie uruchamia zarządzane Gatewaye, ponieważ zmieniły się moduły źródłowe pluginu. Instalacje z zaufanego ClawHub i oficjalnego katalogu nie wymagają dodatkowego potwierdzenia. Dowolne źródła npm, git, archiwa, npm-pack: oraz ścieżki lokalne wyświetlają ostrzeżenie o pochodzeniu i wymagają końcowego --force po przejrzeniu źródła. Ta flaga potwierdza źródło i zezwala na zastąpienie istniejącej instalacji; nie pomija security.installPolicy ani kontroli bezpieczeństwa instalatora. Wydania ClawHub z ostrzeżeniami o ryzyku nadal wymagają oddzielnej flagi dostępnej tylko w powłoce: --acknowledge-clawhub-risk. Instalacje z marketplace’u, połączone i przypięte również pozostają dostępne tylko w powłoce.

/trace: dane wyjściowe śledzenia pluginu

/trace ujawnia ograniczone do sesji wiersze śledzenia/debugowania pluginu bez pełnego trybu szczegółowego. Nie zastępuje /debug (nadpisań środowiska uruchomieniowego) ani /verbose (zwykłych danych wyjściowych narzędzia).

/btw: pytania poboczne

/btw to szybkie pytanie poboczne dotyczące kontekstu bieżącej sesji. Alias: /side.
W odróżnieniu od zwykłej wiadomości:
  • Używa bieżącej sesji jako kontekstu pomocniczego.
  • W sesjach platformy testowej Codex działa jako efemeryczny wątek poboczny Codex.
  • Nie zmienia przyszłego kontekstu sesji.
  • Nie jest zapisywane w historii transkrypcji.
Pełny opis działania zawiera strona Pytania poboczne BTW.

Uwagi dotyczące powierzchni

  • Polecenia tekstowe: działają w zwykłej sesji czatu (wiadomości prywatne współdzielą main, grupy mają własne sesje).
  • Natywne polecenia Discord: agent:<agentId>:discord:slash:<userId>
  • Natywne polecenia Slack: agent:<agentId>:slack:slash:<userId> (prefiks można skonfigurować za pomocą channels.slack.slashCommand.sessionPrefix)
  • Natywne polecenia Telegram: telegram:slash:<userId> (kierowane do sesji czatu za pomocą CommandTargetSessionKey)
  • /login codex wysyła kody parowania urządzenia wyłącznie przez czat prywatny lub ścieżki odpowiedzi interfejsu Web UI. Wywołania w grupach lub tematach Telegram proszą właściciela o wysłanie prywatnej wiadomości do bota.
  • /stop jest kierowane do aktywnej sesji czatu, aby przerwać bieżące uruchomienie.
channels.slack.slashCommand obsługuje jedno polecenie w stylu /openclaw. W przypadku commands.native: true utwórz po jednym poleceniu ukośnikowym Slack dla każdego wbudowanego polecenia. Zarejestruj /agentstatus (nie /status), ponieważ Slack rezerwuje /status. Tekst /status nadal działa w wiadomościach Slack.
  • Wiadomości zawierające wyłącznie polecenie od nadawców z listy dozwolonych są obsługiwane natychmiast (z pominięciem kolejki i modelu).
  • Skróty w tekście (/help, /commands, /status, /whoami) działają również osadzone w zwykłych wiadomościach i są usuwane, zanim model zobaczy pozostały tekst.
  • Nieautoryzowane wiadomości zawierające wyłącznie polecenie są po cichu ignorowane; tokeny /... w tekście 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 lub 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 ustawienie kanału configWrites.

Użycie i stan dostawcy

  • Użycie/limit dostawcy (np. „Claude — pozostało 80%”) jest wyświetlane w /status dla dostawcy bieżącego modelu, gdy włączone jest śledzenie użycia.
  • Wiersze tokenów/pamięci podręcznej w /status mogą korzystać z najnowszego wpisu użycia w transkrypcji, gdy bieżąca migawka sesji zawiera niewiele danych.
  • Środowisko wykonania a środowisko uruchomieniowe: /status zgłasza Execution dla faktycznie używanej ścieżki piaskownicy oraz Runtime dla podmiotu uruchamiającego sesję: OpenClaw Default, OpenAI Codex, backend CLI lub backend ACP.
  • Tokeny/koszt na odpowiedź: kontrolowane przez /usage off|tokens|full.
  • /model status dotyczy modeli/uwierzytelniania/punktów końcowych, a nie użycia.

Powiązane

Skills

Sposób rejestrowania i ograniczania dostępu do poleceń ukośnikowych Skills.

Tworzenie Skills

Utwórz Skills, który rejestruje własne polecenie ukośnikowe.

BTW

Pytania poboczne bez zmiany kontekstu sesji.

Sterowanie

Kieruj agentem w trakcie działania za pomocą /steer.