Skills
Polecenia z ukośnikiem
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ń
Samodzielne wiadomości /... obsługiwane przez Gateway. Muszą być wysłane jako
jedyna treść wiadomości.
/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.
/help, /commands, /status, /whoami — uruchamiane natychmiast i
usuwane, zanim model zobaczy pozostały tekst. Tylko autoryzowani nadawcy.
Szczegóły działania dyrektyw
- 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 orazcommands.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.textbooleandefault: trueWłą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.nativeboolean | "auto"default: "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.nativeSkillsboolean | "auto"default: "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.bashbooleandefault: falseWłącza ! <cmd> do uruchamiania poleceń powłoki hosta (alias /bash <cmd>). Wymaga
list dozwolonych tools.elevated.
commands.bashForegroundMsnumberdefault: 2000Jak długo bash czeka przed przełączeniem w tryb tła (0 przenosi w tło
natychmiast).
commands.configbooleandefault: falseWłącza /config (odczytuje/zapisuje openclaw.json). Tylko właściciel.
commands.mcpbooleandefault: falseWłącza /mcp (odczytuje/zapisuje konfigurację MCP zarządzaną przez OpenClaw w mcp.servers). Tylko właściciel.
commands.pluginsbooleandefault: falseWłącza /plugins (wykrywanie/status pluginów oraz instalowanie i włączanie/wyłączanie). Zapisy tylko dla właściciela.
commands.debugbooleandefault: falseWłącza /debug (nadpisania konfiguracji tylko w czasie działania). Tylko właściciel.
commands.restartbooleandefault: trueWłącza /restart oraz akcje narzędzi restartu gateway.
commands.ownerAllowFromstring[]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.
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImNoYW5uZWxzLjxjaGFubmVs
.commands.enforceOwnerForCommands" type="boolean" default="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.ownerDisplaySecretstringSekret HMAC używany, gdy commands.ownerDisplay: "hash".
commands.allowFromobjectLista 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.useAccessGroupsbooleandefault: trueWymusza 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
Sesje i uruchomienia
| Polecenie | Opis |
|---|---|
/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 |
/stop |
Przerwij 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 |
Model i kontrolki uruchomienia
| Polecenie | Opis |
|---|---|
/think <level|default> |
Ustaw poziom myślenia albo wyczyść nadpisanie sesji. Aliasy: /thinking, /t |
/verbose on|off|full |
Przełącz szczegółowe wyjście. Alias: /v |
/trace on|off |
Przełą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 |
bezpieczeństwo verbose / trace / fast / reasoning
/verbosesłuży do debugowania — w normalnym użyciu trzymaj je wyłączone./traceujawnia tylko linie śledzenia/debugowania należące do pluginu; zwykłe szczegółowe komunikaty pozostają wyłączone./fast auto|on|offutrwala nadpisanie sesji; użyj opcjiinheritw UI sesji, aby je wyczyścić./fastzależy od dostawcy: OpenAI/Codex mapują je naservice_tier=priority; bezpośrednie żądania Anthropic mapują je naservice_tier=autoalbostandard_only./reasoning,/verbosei/tracesą ryzykowne w ustawieniach grupowych — mogą ujawnić wewnętrzne rozumowanie albo diagnostykę pluginu. W czatach grupowych trzymaj je wyłączone.
Szczegóły przełączania modelu
/modelnatychmiast 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.
Wykrywanie i status
| Polecenie | Opis |
|---|---|
/help |
Pokaż krótkie podsumowanie pomocy |
/commands |
Pokaż wygenerowany katalog poleceń |
/tools [compact|verbose] |
Pokaż, czego bieżący agent może teraz użyć |
/status |
Pokaż status wykonania/czasu działania, czas działania Gateway i systemu, stan pluginów oraz użycie/limit dostawcy |
/status plugins |
Pokaż 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 |
/tasks |
Wypisz aktywne/ostatnie zadania w tle dla bieżącej sesji |
/context [list|detail|map|json] |
Wyjaśnij, jak składany jest kontekst |
/whoami |
Pokaż swój identyfikator nadawcy. Alias: /id |
/usage off|tokens|full|reset|cost |
Kontroluj 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 |
Skills, listy dozwolonych, zatwierdzenia
| Polecenie | Opis |
|---|---|
/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 |
Subagenci i ACP
| Polecenie | Opis |
|---|---|
/subagents list|log|info |
Sprawdź 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|help |
Zarzą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 |
/unfocus |
Usuń powiązanie bieżącego wątku |
/agents |
Wyświetl agentów powiązanych z wątkiem dla bieżącej sesji |
Zapisy tylko dla właściciela i administracja
| Polecenie | Wymaga | Opis |
|---|---|---|
/config show|get|set|unset |
commands.config: true |
Odczytaj lub zapisz openclaw.json. Tylko dla właściciela |
/mcp show|get|set|unset |
commands.mcp: true |
Odczytaj lub zapisz konfigurację serwera MCP zarządzaną przez OpenClaw. Tylko dla właściciela |
/plugins list|inspect|show|get|install|enable|disable |
commands.plugins: true |
Sprawdź lub zmień stan plugin. Zapisy tylko dla właściciela. Alias: /plugin |
/debug show|set|unset|reset |
commands.debug: true |
Nadpisania konfiguracji tylko w środowisku uruchomieniowym. Tylko dla właściciela |
/restart |
commands.restart: true (domyślnie) |
Uruchom ponownie OpenClaw |
/send on|off|inherit |
właściciel | Ustaw zasady wysyłania |
Głos, TTS, sterowanie kanałem
| Polecenie | Opis |
|---|---|
/tts on|off|status|chat|latest|provider|limit|summary|audio|help |
Steruj TTS. Zobacz TTS |
/activation mention|always |
Ustaw 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
| Polecenie | Opis |
|---|---|
/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 ...|disarm |
Tymczasowo 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|skills |
Steruj 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.
/prosedla OpenProse). - Natywna rejestracja poleceń Skills jest kontrolowana przez
commands.nativeSkillsorazchannels.<provider>.commands.nativeSkills. - Nazwy są oczyszczane do
a-z0-9_(maks. 32 znaki); kolizje dostają sufiksy numeryczne.
Dyspozycja poleceń Skills
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.
Argumenty poleceń natywnych
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 descriptionsWyniki 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 modeW 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
/config show/config show messages.responsePrefix/config get messages.responsePrefix/config set messages.responsePrefix="[openclaw]"/config unset messages.responsePrefixKonfiguracja jest walidowana przed zapisem. Nieprawidłowe zmiany są odrzucane. Aktualizacje /config
utrzymują się po ponownych uruchomieniach.
/mcp — konfiguracja serwera MCP
/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
/debug show/debug set messages.responsePrefix="[openclaw]"/debug set channels.whatsapp.allowFrom=["+1555","+4477"]/debug unset messages.responsePrefix/debug reset/plugins — zarządzanie plugin
/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
Zakres sesji według powierzchni
- 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 przezchannels.slack.slashCommand.sessionPrefix) - Natywne polecenia Telegram:
telegram:slash:<userId>(kieruje do sesji czatu przezCommandTargetSessionKey) /login codexwysył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./stopceluje w aktywną sesję czatu, aby przerwać bieżące uruchomienie.
Specyfika Slack
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.
Szybka ścieżka i skróty inline
- 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.
Uwagi o argumentach
- Polecenia akceptują opcjonalny
:między poleceniem a argumentami (/think: high,/send: on). /new <model>akceptuje alias modelu,provider/modelalbo nazwę dostawcy (dopasowanie przybliżone); jeśli nie ma dopasowania, tekst jest traktowany jako treść wiadomości./allowlist add|removewymagacommands.config: truei respektuje kanałoweconfigWrites.
Użycie i status dostawcy
- Użycie/limit dostawcy (np. „Claude 80% left”) pokazuje się w
/statusdla bieżącego dostawcy modelu, gdy śledzenie użycia jest włączone. - Linie tokenów/pamięci podręcznej w
/statusmogą wrócić do najnowszego wpisu użycia transkryptu, gdy migawka sesji na żywo jest skąpa. - Wykonanie a środowisko uruchomieniowe:
/statuszgłaszaExecutiondla efektywnej ścieżki sandbox iRuntimedla tego, kto uruchamia sesję:OpenClaw Default,OpenAI Codex, backend CLI albo backend ACP. - Tokeny/koszt na odpowiedź: kontrolowane przez
/usage off|tokens|full. /model statusdotyczy modeli/uwierzytelniania/endpointów, a nie użycia.