/.
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.Szczegóły działania dyrektyw
Szczegóły działania dyrektyw
- 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 orazcommands.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
Polecenia podstawowe
Sesje i przebiegi
Sesje i przebiegi
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.Sterowanie modelem i przebiegiem
Sterowanie modelem i przebiegiem
Bezpieczeństwo trybów szczegółowego, śledzenia, szybkiego i rozumowania
Bezpieczeństwo trybów szczegółowego, śledzenia, szybkiego i rozumowania
/verbosesłuży do debugowania — podczas zwykłego użycia należy pozostawić je wyłączone./traceujawnia tylko wiersze śledzenia/debugowania należące do pluginu; zwykłe szczegółowe komunikaty pozostają wyłączone./fast auto|on|offutrwala nadpisanie sesji; aby je wyczyścić, użyj opcjiinheritw interfejsie Sessions./fastzależy od dostawcy: OpenAI/Codex mapują je naservice_tier=priority; bezpośrednie żądania Anthropic mapują je naservice_tier=autolubstandard_only./reasoning,/verbosei/tracesą ryzykowne w ustawieniach grupowych — mogą ujawnić wewnętrzne rozumowanie lub diagnostykę pluginu. W czatach grupowych należy pozostawić je wyłączone.
Szczegóły przełączania modelu
Szczegóły przełączania modelu
/modelnatychmiast 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.
Wykrywanie i status
Wykrywanie i status
Skills, listy dozwolonych elementów, zatwierdzenia
Skills, listy dozwolonych elementów, zatwierdzenia
Subagenci i ACP
Subagenci i ACP
Zapisy i administracja tylko dla właściciela
Zapisy i administracja tylko dla właściciela
Głos, TTS i sterowanie kanałem
Głos, TTS i sterowanie kanałem
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)
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.
/prosedla OpenProse). - Rejestrowaniem natywnych poleceń skilli sterują
commands.nativeSkillsorazchannels.<provider>.commands.nativeSkills. - Nazwy są oczyszczane do postaci
a-z0-9_(maks. 32 znaki); w przypadku kolizji dodawane są sufiksy numeryczne.
Przekazywanie poleceń skilli
Przekazywanie poleceń skilli
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.Argumenty poleceń natywnych
Argumenty poleceń natywnych
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.
/model: wybór modelu
/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./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.
- 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.
Uwagi dotyczące powierzchni
Zakres sesji według powierzchni
Zakres sesji według 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 codexwysył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./stopjest kierowane do aktywnej sesji czatu, aby przerwać bieżące uruchomienie.
Specyfika Slack
Specyfika Slack
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.Szybka ścieżka i skróty w tekście
Szybka ścieżka i skróty w tekście
- 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.
Uwagi dotyczące argumentów
Uwagi dotyczące argumentów
- Polecenia akceptują opcjonalny
:między poleceniem a argumentami (/think: high,/send: on). /new <model>akceptuje alias modelu,provider/modellub nazwę dostawcy (dopasowanie przybliżone); jeśli nie ma dopasowania, tekst jest traktowany jako treść wiadomości./allowlist add|removewymagacommands.config: truei respektuje ustawienie kanałuconfigWrites.
Użycie i stan dostawcy
- Użycie/limit dostawcy (np. „Claude — pozostało 80%”) jest wyświetlane w
/statusdla dostawcy bieżącego modelu, gdy włączone jest śledzenie użycia. - Wiersze tokenów/pamięci podręcznej w
/statusmogą korzystać z najnowszego wpisu użycia w transkrypcji, gdy bieżąca migawka sesji zawiera niewiele danych. - Środowisko wykonania a środowisko uruchomieniowe:
/statuszgłaszaExecutiondla faktycznie używanej ścieżki piaskownicy orazRuntimedla podmiotu uruchamiającego sesję:OpenClaw Default,OpenAI Codex, backend CLI lub backend ACP. - Tokeny/koszt na odpowiedź: kontrolowane przez
/usage off|tokens|full. /model statusdotyczy 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.