Polecenia z ukośnikiem

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ń

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,  },}

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImNoYW5uZWxzLjxjaGFubmVs .commands.enforceOwnerForCommands" type="boolean" default="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.

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

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.

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

/tools         # widok kompaktowy/tools verbose # z krótkimi opisami

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

/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 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 dostawcy i modelu. Selektor uwzględnia agents.defaults.models, w tym wpisy provider/*.

/config: zapis konfiguracji na dysku

/config show/config show messages.responsePrefix/config get messages.responsePrefix/config set messages.responsePrefix="[openclaw]"/config unset messages.responsePrefix

Konfiguracja jest sprawdzana przed zapisem. Nieprawidłowe zmiany są odrzucane. Aktualizacje /config są zachowywane po ponownym uruchomieniu.

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

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

/plugins: zarządzanie pluginami

/plugins/plugins list/plugin show context7/plugins enable context7/plugins disable context7/plugins install clawhub:<package>/plugins install npm:@openclaw/<official-package>/plugins install npm:<package> --force/plugins install git:<repository>@<ref> --force

/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          # pokaż bieżący stan śledzenia/trace on/trace off

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

/btw co teraz robimy?/side co zmieniło się podczas dalszego działania głównego uruchomienia?

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

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