Skills

Polecenia ukośnikowe

Gateway obsługuje polecenia wysyłane jako samodzielne wiadomości rozpoczynające się od /. Polecenia bash wykonywane wyłącznie na hoście używają składni ! <cmd> (z /bash <cmd> jako aliasem).

Gdy konwersacja jest powiązana z sesją ACP, zwykły tekst jest kierowany do mechanizmu ACP. Polecenia zarządzania Gateway pozostają lokalne: /acp ... zawsze trafia do modułu obsługi poleceń OpenClaw, a /status oraz /unfocus pozostają lokalne, gdy obsługa poleceń jest włączona dla danego interfejsu.

Trzy typy poleceń

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 w odpowiedzi wysyłane jest 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 wyłącznie do upoważnionych nadawców. Jeśli ustawiono commands.allowFrom, jest to jedyna używana lista dozwolonych nadawców; w przeciwnym razie autoryzacja wynika z list dozwolonych nadawców kanału/parowania oraz commands.useAccessGroups. Dyrektywy od nieupoważnionych nadawców są 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. W interfejsach bez poleceń natywnych (WhatsApp, WebChat, Signal, iMessage, Google Chat, Microsoft Teams) polecenia tekstowe działają nawet po ustawieniu wartości false.

commands.nativeboolean | "auto"default: "auto"

Rejestruje polecenia natywne. Tryb automatyczny: włączony dla Discord/Telegram; wyłączony dla Slack; ignorowany w przypadku dostawców bez obsługi natywnej. Ustawienie można nadpisać dla poszczególnych kanałów za pomocą channels.<provider>.commands.native. W Discord wartość false pomija rejestrację poleceń z ukośnikiem; wcześniej zarejestrowane polecenia mogą pozostać widoczne do czasu ich usunięcia.

commands.nativeSkillsboolean | "auto"default: "auto"

Rejestruje natywnie polecenia Skills, jeśli są obsługiwane. Tryb automatyczny: włączony dla Discord/Telegram; wyłączony dla Slack. Ustawienie można nadpisać za pomocą channels.<provider>.commands.nativeSkills.

commands.bashbooleandefault: false

Włącza wykonywanie poleceń powłoki hosta za pomocą ! <cmd> (alias /bash <cmd>). Wymaga list dozwolonych nadawców tools.elevated.

commands.bashForegroundMsnumberdefault: 2000

Określa, jak długo bash czeka przed przejściem do trybu działania w tle (0 powoduje natychmiastowe przejście do działania w tle).

commands.configbooleandefault: false

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

commands.mcpbooleandefault: false

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

commands.pluginsbooleandefault: false

Włącza /plugins (wykrywanie i stan pluginów oraz instalowanie, włączanie i wyłączanie). Operacje zapisu są dostępne tylko dla właściciela.

commands.debugbooleandefault: false

Włącza /debug (nadpisywanie konfiguracji tylko na czas działania). Tylko dla właściciela.

commands.restartbooleandefault: true

Włącza /restart oraz akcje narzędzi służące do ponownego uruchamiania Gateway.

commands.ownerAllowFromstring[]

Jawna lista dozwolonych właścicieli dla interfejsów poleceń dostępnych tylko dla właściciela. Niezależna od commands.allowFrom oraz dostępu przez parowanie wiadomości prywatnych.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImNoYW5uZWxzLjxjaGFubmVs .commands.enforceOwnerForCommands" type="boolean" default="false"> Ustawienie dla poszczególnych kanałów: wymaga tożsamości właściciela w przypadku poleceń dostępnych tylko dla właściciela. Gdy ma wartość true, nadawca musi pasować do commands.ownerAllowFrom lub mieć wewnętrzny zakres operator.admin. Wpis wieloznaczny na liście allowFrom nie jest wystarczający.

commands.ownerDisplay"raw" | "hash"

Określa sposób wyświetlania identyfikatorów właścicieli w monicie systemowym.

commands.ownerDisplaySecretstring

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

commands.allowFromobject

Lista dozwolonych nadawców dla poszczególnych dostawców, używana do autoryzacji poleceń. Po skonfigurowaniu jest jedynym źródłem autoryzacji poleceń i dyrektyw. Użyj "*" jako globalnej wartości domyślnej; klucze właściwe dla dostawców mają przed nią pierwszeństwo.

commands.useAccessGroupsbooleandefault: true

Wymusza stosowanie list dozwolonych nadawców i zasad dla poleceń, gdy nie ustawiono commands.allowFrom.

Lista poleceń

Polecenia pochodzą z trzech źródeł:

  • Wbudowane polecenia rdzenia: src/auto-reply/commands-registry.shared.ts
  • Wygenerowane polecenia docka: src/auto-reply/commands-registry.data.ts
  • Polecenia Pluginów: wywołania registerCommand() w pluginach

Dostępność zależy od flag konfiguracji, interfejsu kanału oraz zainstalowanych i włączonych pluginów.

Polecenia rdzenia

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 transkrypcję, usuwa ponownie używane identyfikatory sesji zaplecza CLI i ponownie wykonuje procedurę uruchamiania
/name <title> Nadaj nazwę bieżącej sesji lub 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 wygaśnięciem powiązania wątku z powodu bezczynności
/session max-age <duration|off> Zarządzaj wygaśnięciem powiązania wątku po osiągnięciu maksymalnego wieku
/export-session [path] Wyeksportuj bieżącą sesję do formatu HTML. Alias: /export
/export-trajectory [path] Wyeksportuj pakiet trajektorii JSONL dla bieżącej sesji. Alias: /trajectory
Sterowanie modelem i uruchomieniem
Polecenie Opis
/think <level|default> Ustaw poziom rozumowania lub wyczyść nadpisanie sesji. Aliasy: /thinking, /t
/verbose on|off|full Przełącz szczegółowe dane wyjściowe. Alias: /v
/trace on|off Przełącz dane śledzenia Pluginu dla bieżącej sesji
/fast [status|auto|on|off|default] Wyświetl, ustaw lub wyczyść tryb szybki
/reasoning [on|off|stream] Przełącz widoczność rozumowania. Alias: /reason
/elevated [on|off|ask|full] Przełącz tryb podwyższonych uprawnień. Alias: /elev
/exec host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id> Wyświetl lub ustaw wartości domyślne wykonywania
/login [codex|openai|openai-codex] Sparuj logowanie Codex/OpenAI z prywatnego czatu lub sesji Web UI. Tylko właściciel/administrator
/model [name|#|status] Wyświetl lub ustaw model
/models [provider] [page] [limit=<n>|all] Wyświetl skonfigurowanych lub dostępnych po uwierzytelnieniu dostawców albo modele
/queue <mode> Zarządzaj zachowaniem kolejki aktywnych uruchomień. Zobacz Kolejka i Sterowanie kolejką
/steer <message> Wprowadź wskazówki do aktywnego uruchomienia. Alias: /tell. Zobacz Sterowanie
bezpieczeństwo verbose / trace / fast / reasoning
  • /verbose służy do debugowania — podczas zwykłego użytkowania pozostaw tę opcję wyłączoną.
  • /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; użyj opcji inherit w interfejsie Sessions, aby je wyczyścić.
  • /fast zależy od dostawcy: OpenAI/Codex odwzorowują go na service_tier=priority; bezpośrednie żądania Anthropic odwzorowują go na service_tier=auto lub standard_only.
  • /reasoning, /verbose i /trace są ryzykowne w grupach — mogą ujawnić wewnętrzne rozumowanie lub diagnostykę Pluginu. Pozostaw je wyłączone na czatach grupowych.
Szczegóły przełączania modelu
  • /model natychmiast zapisuje nowy model w sesji.
  • Jeśli agent jest bezczynny, następne uruchomienie użyje go od razu.
  • Jeśli uruchomienie jest aktywne, przełączenie zostaje oznaczone jako oczekujące i zastosowane w następnym bezpiecznym punkcie ponowienia.
Wykrywanie i stan
Polecenie Opis
/help Wyświetl krótkie podsumowanie pomocy
/commands Wyświetl wygenerowany katalog poleceń
/tools [compact|verbose] Wyświetl, z czego bieżący agent może teraz korzystać
/status Wyświetl stan wykonywania/środowiska uruchomieniowego, czas działania Gateway i systemu, kondycję Pluginów oraz wykorzystanie/limity dostawców
/status plugins Wyświetl szczegółową kondycję Pluginów: błędy ładowania, kwarantanny, awarie Pluginów kanałów, problemy z zależnościami i powiadomienia o zgodności. Wymaga commands.plugins: true
/goal [status|start|edit|pause|resume|complete|block|clear] ... Zarządzaj trwałym celem bieżącej sesji
/diagnostics [note] Przepływ raportu pomocy technicznej dostępny tylko dla właściciela. Za każdym razem prosi o zatwierdzenie wykonania
/crestodian <request> Uruchom pomocnika konfiguracji i naprawy Crestodian z wiadomości prywatnej właściciela
/tasks Wyświetl aktywne/ostatnie zadania w tle dla bieżącej sesji
/context [list|detail|map|json] Wyjaśnij sposób tworzenia kontekstu
/whoami Wyświetl identyfikator nadawcy. Alias: /id
/usage off|tokens|full|reset|cost Steruj stopką wykorzystania dla każdej odpowiedzi (reset/inherit/clear/default usuwa nadpisanie sesji, aby ponownie odziedziczyć skonfigurowaną wartość domyślną) lub wyświetl lokalne podsumowanie kosztów
Skills, listy dozwolonych elementów i zatwierdzenia
Polecenie Opis
/skill <name> [input] Uruchom umiejętność według nazwy
/learn [request] Utwórz wersję roboczą jednej umiejętności gotowej do przeglądu na podstawie bieżącej rozmowy lub wskazanych źródeł za pomocą Warsztatu umiejętności
/allowlist [list|add|remove] ... Zarządzaj wpisami listy dozwolonych elementów. Tylko tekst
/approve <id> <decision> Rozstrzygnij monity o zatwierdzenie wykonania lub Pluginu
/btw <question> Zadaj pytanie poboczne bez zmieniania kontekstu sesji. Alias: /side. Zobacz Pytanie poboczne
Subagenci i ACP
Polecenie Opis
/subagents list|log|info Sprawdź uruchomienia subagentów dla 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 wykonawczego. Sterowanie środowiskiem wykonawczym wymaga tożsamości zewnętrznego właściciela lub wewnętrznego 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 i administracja tylko dla właściciela
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ądzanego przez OpenClaw. Tylko dla właściciela
/plugins list|inspect|show|get|install|enable|disable commands.plugins: true Sprawdź lub zmień stan pluginu. Operacje zapisu tylko dla właściciela. Alias: /plugin
/debug show|set|unset|reset commands.debug: true Nadpisania konfiguracji wyłącznie w środowisku wykonawczym. 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 i 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 grupowej
/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 dokowania

Polecenia dokowania przełączają trasę odpowiedzi aktywnej sesji na inny połączony kanał. Informacje o konfiguracji i rozwiązywaniu problemów znajdziesz w sekcji 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

Polecenie Opis
/dreaming [on|off|status|help] Włącz lub wyłącz Dreaming pamięci (właściciel lub 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 Node wysokiego ryzyka (kamera/ekran/komputer/zapis). Zobacz Korzystanie z komputera
/voice status|list|set <voiceId> Zarządzaj konfiguracją głosu Talk. Natywna nazwa w Discord: /talkvoice
/card ... Wysyłaj ustawienia wstępne rozbudowanych kart LINE. Zobacz LINE
/codex <action> ... Powiąż, steruj i sprawdzaj środowisko testowe serwera aplikacji Codex (stan, wątki, wznawianie, model, tryb szybki, uprawnienia, Compaction, przegląd, MCP, Skills i inne). Zobacz Środowisko testowe Codex

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

Polecenia Skills

Skills dostępne dla użytkownika są udostępniane jako polecenia z 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 sterowana przez commands.nativeSkills i channels.<provider>.commands.nativeSkills.
  • Nazwy są oczyszczane do formatu a-z0-9_ (maks. 32 znaki); w przypadku kolizji otrzymują przyrostki liczbowe.
Przekazywanie poleceń Skills

Domyślnie polecenia Skills są przekazywane do modelu jako zwykłe żądania.

Skills mogą zadeklarować command-dispatch: tool, aby przekazywać je 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 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ą rozpoznawane względem modelu sesji docelowej, dlatego opcje specyficzne dla modelu, takie jak poziomy /think, uwzględniają nadpisanie /model danej sesji.

/tools: z czego agent może teraz korzystać

/tools odpowiada na pytanie dotyczące środowiska wykonawczego: z czego ten agent może korzystać teraz w tej rozmowie — nie jest to statyczny katalog konfiguracji.

text
/tools         # widok skrócony/tools verbose # z krótkimi opisami

Wyniki dotyczą konkretnej 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 interfejsie Control UI lub powierzchni konfiguracji.

/model: wybór modelu

text
/model             # pokaż selektor modelu/model list        # to samo/model 3           # wybierz według numeru z selektora/model openai/gpt-5.4/model opus@anthropic:default/model default     # wyczyść wybór modelu dla sesji/model status      # widok szczegółowy z punktem końcowym i trybem API

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

/config: zapisywanie 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 weryfikowana przed zapisem. Nieprawidłowe zmiany są odrzucane. Aktualizacje wykonane przez /config są zachowywane po ponownym uruchomieniu.

/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. /mcp show maskuje pola zawierające dane uwierzytelniające, rozpoznane wartości flag danych uwierzytelniających oraz argumenty o znanych formatach sekretów. Po uruchomieniu w grupie konfiguracja jest wysyłana prywatnie do właściciela; jeśli prywatna trasa do właściciela nie jest dostępna, polecenie bezpiecznie odmawia wykonania i prosi właściciela o ponowienie próby w bezpośrednim czacie.

/debug: nadpisania wyłącznie w środowisku wykonawczym

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

/plugins: zarządzanie pluginami

text
/plugins/plugins list/plugin show context7/plugins enable context7/plugins disable context7/plugins install ./path/to/plugin

/plugins enable|disable aktualizuje konfigurację pluginu i przeładowuje na gorąco środowisko wykonawcze pluginów Gateway dla nowych tur agenta. /plugins install automatycznie uruchamia ponownie zarządzane instancje Gateway, ponieważ zmieniły się moduły źródłowe pluginu.

/trace: dane wyjściowe śledzenia pluginu

text
/trace          # pokaż bieżący stan śledzenia/trace on/trace off

/trace ujawnia wiersze śledzenia i debugowania pluginów dotyczące sesji bez włączania pełnego trybu szczegółowego. Nie zastępuje /debug (nadpisania środowiska wykonawczego) ani /verbose (zwykłe dane wyjściowe narzędzi).

/btw: pytania poboczne

/btw służy do szybkiego zadawania pytań pobocznych dotyczących kontekstu bieżącej sesji. Alias: /side.

text
/btw co teraz robimy?/side co się zmieniło, gdy główne uruchomienie było kontynuowane?

W przeciwieństwie do zwykłej wiadomości:

  • Używa bieżącej sesji jako kontekstu pomocniczego.
  • W sesjach środowiska testowego 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 znajdziesz w sekcji Pytania poboczne BTW.

Uwagi dotyczące powierzchni

Zakres sesji dla poszczególnych 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 konfigurowany przez channels.slack.slashCommand.sessionPrefix)
  • Natywne polecenia Telegram: telegram:slash:<userId> (wskazują sesję czatu przez CommandTargetSessionKey)
  • /login codex wysyła kody parowania urządzenia wyłącznie przez prywatny czat 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 wskazuje aktywną sesję czatu, aby przerwać bieżące uruchomienie.
Specyfika Slack

channels.slack.slashCommand obsługuje pojedyncze polecenie w stylu /openclaw. Gdy commands.native: true, utwórz po jednym poleceniu Slack z ukośnikiem 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 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
  • Polecenia akceptują opcjonalny znak : 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 znajdzie dopasowania, tekst jest traktowany jako treść wiadomości.
  • /allowlist add|remove wymaga commands.config: true i uwzględnia ustawienie kanału configWrites.

Użycie i stan dostawcy

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

Powiązane

Was this useful?
On this page

On this page