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ń

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 oraz commands.useAccessGroups. Nieautoryzowani nadawcy widzą dyrektywy traktowane jako zwykły tekst.

Konfiguracja

json5
{  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: 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.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: false

Włącza ! <cmd> do uruchamiania poleceń powłoki hosta (alias /bash <cmd>). Wymaga list dozwolonych tools.elevated.

commands.bashForegroundMsnumberdefault: 2000

Jak długo bash czeka przed przełączeniem w tryb tła (0 przenosi w tło natychmiast).

commands.configbooleandefault: false

Włącza /config (odczytuje/zapisuje openclaw.json). Tylko właściciel.

commands.mcpbooleandefault: false

Włącza /mcp (odczytuje/zapisuje konfigurację MCP zarządzaną przez OpenClaw w mcp.servers). Tylko właściciel.

commands.pluginsbooleandefault: false

Włącza /plugins (wykrywanie/status pluginów oraz instalowanie i włączanie/wyłączanie). Zapisy tylko dla właściciela.

commands.debugbooleandefault: false

Włącza /debug (nadpisania konfiguracji tylko w czasie działania). Tylko właściciel.

commands.restartbooleandefault: true

Włą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.ownerDisplaySecretstring

Sekret HMAC używany, gdy commands.ownerDisplay: "hash".

commands.allowFromobject

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.useAccessGroupsbooleandefault: 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

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
  • /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.
Szczegóły przełączania modelu
  • /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.
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. /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.
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.

text
/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

text
/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

text
/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

text
/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

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

/plugins — zarządzanie plugin

text
/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

text
/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.

text
/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 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.
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/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

Was this useful?
On this page

On this page