--- read_when: - Praca nad funkcjami kanału Discord summary: Stan obsługi, możliwości i konfiguracja bota Discord title: Discord x-i18n: generated_at: "2026-07-03T02:56:53Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: b7e8724b02baa1a2dba1ac932e20533c9293b6021f30b1a79107349c34f195e5 source_path: channels/discord.md workflow: 16 --- Gotowe do wiadomości DM i kanałów serwera przez oficjalny Gateway Discord. Wiadomości DM Discord domyślnie używają trybu parowania. Natywne działanie poleceń i katalog poleceń. Diagnostyka międzykanałowa i przepływ naprawy. ## Szybka konfiguracja Musisz utworzyć nową aplikację z botem, dodać bota do swojego serwera i sparować go z OpenClaw. Zalecamy dodanie bota do własnego prywatnego serwera. Jeśli jeszcze go nie masz, [najpierw go utwórz](https://support.discord.com/hc/en-us/articles/204849977-How-do-I-create-a-server) (wybierz **Create My Own > For me and my friends**). Przejdź do [Discord Developer Portal](https://discord.com/developers/applications) i kliknij **New Application**. Nazwij ją na przykład „OpenClaw”. Kliknij **Bot** na pasku bocznym. Ustaw **Username** na nazwę, której używasz dla swojego agenta OpenClaw. Nadal na stronie **Bot** przewiń w dół do **Privileged Gateway Intents** i włącz: - **Message Content Intent** (wymagane) - **Server Members Intent** (zalecane; wymagane dla list dozwolonych ról i dopasowywania nazw do identyfikatorów) - **Presence Intent** (opcjonalne; potrzebne tylko do aktualizacji obecności) Przewiń z powrotem w górę strony **Bot** i kliknij **Reset Token**. Mimo nazwy spowoduje to wygenerowanie pierwszego tokenu — nic nie jest „resetowane”. Skopiuj token i zapisz go w bezpiecznym miejscu. To jest Twój **Bot Token** i wkrótce będzie potrzebny. Kliknij **OAuth2** na pasku bocznym. Wygenerujesz URL zaproszenia z odpowiednimi uprawnieniami, aby dodać bota do swojego serwera. Przewiń w dół do **OAuth2 URL Generator** i włącz: - `bot` - `applications.commands` Poniżej pojawi się sekcja **Bot Permissions**. Włącz co najmniej: **Uprawnienia ogólne** - Wyświetlanie kanałów **Uprawnienia tekstowe** - Wysyłanie wiadomości - Czytanie historii wiadomości - Osadzanie linków - Załączanie plików - Dodawanie reakcji (opcjonalne) To bazowy zestaw dla zwykłych kanałów tekstowych. Jeśli planujesz publikować w wątkach Discord, w tym w przepływach kanałów forum lub multimediów, które tworzą albo kontynuują wątek, włącz także **Send Messages in Threads**. Skopiuj wygenerowany URL na dole, wklej go w przeglądarce, wybierz swój serwer i kliknij **Continue**, aby połączyć. Bot powinien być teraz widoczny na serwerze Discord. Wróć do aplikacji Discord i włącz Tryb dewelopera, aby móc kopiować wewnętrzne identyfikatory. 1. Kliknij **User Settings** (ikona koła zębatego obok awatara) → przewiń do **Developer** na pasku bocznym → włącz **Developer Mode** *(Uwaga: w aplikacji mobilnej Discord Tryb dewelopera znajduje się w **App Settings** → **Advanced**)* 2. Kliknij prawym przyciskiem **ikonę serwera** na pasku bocznym → **Copy Server ID** 3. Kliknij prawym przyciskiem **własny awatar** → **Copy User ID** Zapisz **Server ID** i **User ID** obok swojego Bot Token — wszystkie trzy wyślesz do OpenClaw w następnym kroku. Aby parowanie działało, Discord musi zezwalać botowi na wysyłanie Ci wiadomości DM. Kliknij prawym przyciskiem **ikonę serwera** → **Privacy Settings** → włącz **Direct Messages**. Dzięki temu członkowie serwera (w tym boty) mogą wysyłać Ci wiadomości DM. Pozostaw to włączone, jeśli chcesz używać wiadomości DM Discord z OpenClaw. Jeśli planujesz używać tylko kanałów serwera, możesz wyłączyć wiadomości DM po sparowaniu. Token bota Discord jest sekretem (jak hasło). Ustaw go na maszynie uruchamiającej OpenClaw, zanim napiszesz do swojego agenta. ```bash export DISCORD_BOT_TOKEN="YOUR_BOT_TOKEN" cat > discord.patch.json5 <<'JSON5' { channels: { discord: { enabled: true, token: { source: "env", provider: "default", id: "DISCORD_BOT_TOKEN" }, }, }, } JSON5 openclaw config patch --file ./discord.patch.json5 --dry-run openclaw config patch --file ./discord.patch.json5 openclaw gateway ``` Jeśli OpenClaw działa już jako usługa w tle, uruchom ją ponownie przez aplikację OpenClaw dla Mac albo zatrzymując i ponownie uruchamiając proces `openclaw gateway run`. W przypadku instalacji jako usługi zarządzanej uruchom `openclaw gateway install` z powłoki, w której obecny jest `DISCORD_BOT_TOKEN`, albo zapisz zmienną w `~/.openclaw/.env`, aby usługa mogła rozpoznać env SecretRef po restarcie. Jeśli host jest blokowany lub ograniczany przez Discord podczas początkowego odczytu aplikacji, ustaw identyfikator aplikacji/klienta Discord z Developer Portal, aby uruchamianie mogło pominąć to wywołanie REST. Użyj `channels.discord.applicationId` dla konta domyślnego albo `channels.discord.accounts..applicationId`, gdy uruchamiasz wiele botów Discord. Porozmawiaj ze swoim agentem OpenClaw na dowolnym istniejącym kanale (np. Telegram) i przekaż mu to. Jeśli Discord jest Twoim pierwszym kanałem, użyj zamiast tego karty CLI / konfiguracja. > „Ustawiłem już token bota Discord w konfiguracji. Dokończ konfigurację Discord z User ID `` i Server ID ``.” Jeśli wolisz konfigurację opartą na pliku, ustaw: ```json5 { channels: { discord: { enabled: true, token: { source: "env", provider: "default", id: "DISCORD_BOT_TOKEN", }, }, }, } ``` Fallback env dla konta domyślnego: ```bash DISCORD_BOT_TOKEN=... ``` W przypadku konfiguracji skryptowej lub zdalnej zapisz ten sam blok JSON5 za pomocą `openclaw config patch --file ./discord.patch.json5 --dry-run`, a następnie uruchom ponownie bez `--dry-run`. Wartości `token` w postaci zwykłego tekstu są obsługiwane. Wartości SecretRef są również obsługiwane dla `channels.discord.token` przez dostawców env/file/exec. Zobacz [Zarządzanie sekretami](/pl/gateway/secrets). W przypadku wielu botów Discord trzymaj token każdego bota i identyfikator aplikacji pod jego kontem. Najwyższego poziomu `channels.discord.applicationId` jest dziedziczone przez konta, więc ustawiaj je tam tylko wtedy, gdy każde konto ma używać tego samego identyfikatora aplikacji. ```json5 { channels: { discord: { enabled: true, accounts: { personal: { token: { source: "env", provider: "default", id: "DISCORD_PERSONAL_TOKEN" }, applicationId: "111111111111111111", }, work: { token: { source: "env", provider: "default", id: "DISCORD_WORK_TOKEN" }, applicationId: "222222222222222222", }, }, }, }, } ``` Poczekaj, aż Gateway będzie działać, a następnie wyślij wiadomość DM do bota w Discord. Odpowie kodem parowania. Wyślij kod parowania do swojego agenta na istniejącym kanale: > „Zatwierdź ten kod parowania Discord: ``” ```bash openclaw pairing list discord openclaw pairing approve discord ``` Kody parowania wygasają po 1 godzinie. Teraz możesz rozmawiać ze swoim agentem w Discord przez wiadomość DM. Rozpoznawanie tokenu uwzględnia konto. Wartości tokenu z konfiguracji mają pierwszeństwo przed fallbackiem env. `DISCORD_BOT_TOKEN` jest używany tylko dla konta domyślnego. Jeśli dwa włączone konta Discord rozpoznają ten sam token bota, OpenClaw uruchamia tylko jeden monitor Gateway dla tego tokenu. Token pochodzący z konfiguracji ma pierwszeństwo przed domyślnym fallbackiem env; w przeciwnym razie wygrywa pierwsze włączone konto, a zduplikowane konto jest zgłaszane jako wyłączone. W przypadku zaawansowanych wywołań wychodzących (narzędzie wiadomości/akcje kanału) jawny `token` dla pojedynczego wywołania jest używany dla tego wywołania. Dotyczy to akcji wysyłania oraz akcji typu odczyt/sondaż (na przykład read/search/fetch/thread/pins/permissions). Ustawienia polityki konta i ponawiania nadal pochodzą z wybranego konta w aktywnej migawce środowiska uruchomieniowego. ## Zalecane: skonfiguruj obszar roboczy serwera Gdy wiadomości DM działają, możesz skonfigurować swój serwer Discord jako pełny obszar roboczy, w którym każdy kanał otrzymuje własną sesję agenta z własnym kontekstem. Jest to zalecane dla prywatnych serwerów, na których jesteś tylko Ty i Twój bot. Dzięki temu agent może odpowiadać w dowolnym kanale na Twoim serwerze, nie tylko w wiadomościach DM. > „Dodaj mój Discord Server ID `` do listy dozwolonych serwerów” ```json5 { channels: { discord: { groupPolicy: "allowlist", guilds: { YOUR_SERVER_ID: { requireMention: true, users: ["YOUR_USER_ID"], }, }, }, }, } ``` Domyślnie agent odpowiada w kanałach serwera tylko po @wzmiance. Na prywatnym serwerze prawdopodobnie chcesz, aby odpowiadał na każdą wiadomość. W kanałach serwera zwykłe odpowiedzi są domyślnie publikowane automatycznie. W przypadku wspólnych, stale aktywnych pokojów włącz `messages.groupChat.visibleReplies: "message_tool"`, aby agent mógł obserwować i publikować tylko wtedy, gdy uzna, że odpowiedź na kanale jest przydatna. Najlepiej działa to z modelami najnowszej generacji, niezawodnymi w użyciu narzędzi, takimi jak GPT 5.5. Zdarzenia pokoju w tle pozostają ciche, chyba że narzędzie wyśle wiadomość. Pełną konfigurację trybu obserwacji znajdziesz w [Zdarzeniach pokoju w tle](/pl/channels/ambient-room-events). Jeśli Discord pokazuje pisanie, a logi pokazują użycie tokenów, ale nie opublikowano wiadomości, sprawdź, czy tura została skonfigurowana jako zdarzenie pokoju w tle albo czy włączono widoczne odpowiedzi przez narzędzie wiadomości. > „Zezwól mojemu agentowi odpowiadać na tym serwerze bez konieczności @wzmianki” Ustaw `requireMention: false` w konfiguracji serwera: ```json5 { channels: { discord: { guilds: { YOUR_SERVER_ID: { requireMention: false, }, }, }, }, } ``` Aby wymagać wysyłania przez narzędzie wiadomości dla widocznych odpowiedzi grupowych/kanałowych, ustaw `messages.groupChat.visibleReplies: "message_tool"`. Domyślnie pamięć długoterminowa (MEMORY.md) ładuje się tylko w sesjach DM. Kanały serwera nie ładują automatycznie MEMORY.md. > „Gdy zadaję pytania w kanałach Discord, użyj memory_search lub memory_get, jeśli potrzebujesz długoterminowego kontekstu z MEMORY.md.” Jeśli potrzebujesz wspólnego kontekstu w każdym kanale, umieść stabilne instrukcje w `AGENTS.md` lub `USER.md` (są wstrzykiwane do każdej sesji). Przechowuj długoterminowe notatki w `MEMORY.md` i uzyskuj do nich dostęp na żądanie za pomocą narzędzi pamięci. Teraz utwórz kilka kanałów na swoim serwerze Discord i zacznij rozmawiać. Agent widzi nazwę kanału, a każdy kanał otrzymuje własną izolowaną sesję — możesz więc skonfigurować `#coding`, `#home`, `#research` albo cokolwiek pasuje do Twojego przepływu pracy. ## Model środowiska uruchomieniowego - Gateway zarządza połączeniem Discord. - Routing odpowiedzi jest deterministyczny: odpowiedzi przychodzące z Discord wracają do Discord. - Metadane gildii/kanału Discord są dodawane do promptu modelu jako niezaufany kontekst, a nie jako widoczny dla użytkownika prefiks odpowiedzi. Jeśli model skopiuje tę otoczkę z powrotem, OpenClaw usuwa skopiowane metadane z odpowiedzi wychodzących oraz z przyszłego kontekstu odtwarzania. - Domyślnie (`session.dmScope=main`) bezpośrednie czaty współdzielą główną sesję agenta (`agent:main:main`). - Kanały gildii mają izolowane klucze sesji (`agent::discord:channel:`). - Grupowe wiadomości DM są domyślnie ignorowane (`channels.discord.dm.groupEnabled=false`). - Natywne polecenia ukośnikowe działają w izolowanych sesjach poleceń (`agent::discord:slash:`), nadal przenosząc `CommandTargetSessionKey` do trasowanej sesji konwersacji. - Tekstowe dostarczanie ogłoszeń Cron/Heartbeat do Discord używa końcowej odpowiedzi widocznej dla asystenta jeden raz. Media i ustrukturyzowane ładunki komponentów pozostają wielowiadomościowe, gdy agent emituje wiele możliwych do dostarczenia ładunków. ## Kanały forum Kanały forum i mediów Discord akceptują tylko posty w wątkach. OpenClaw obsługuje dwa sposoby ich tworzenia: - Wyślij wiadomość do nadrzędnego forum (`channel:`), aby automatycznie utworzyć wątek. Tytuł wątku używa pierwszego niepustego wiersza Twojej wiadomości. - Użyj `openclaw message thread create`, aby utworzyć wątek bezpośrednio. Nie przekazuj `--message-id` dla kanałów forum. Przykład: wyślij do nadrzędnego forum, aby utworzyć wątek ```bash openclaw message send --channel discord --target channel: \ --message "Topic title\nBody of the post" ``` Przykład: jawnie utwórz wątek forum ```bash openclaw message thread create --channel discord --target channel: \ --thread-name "Topic title" --message "Body of the post" ``` Nadrzędne fora nie akceptują komponentów Discord. Jeśli potrzebujesz komponentów, wyślij wiadomość do samego wątku (`channel:`). ## Komponenty interaktywne OpenClaw obsługuje kontenery komponentów Discord v2 dla wiadomości agentów. Użyj narzędzia wiadomości z ładunkiem `components`. Wyniki interakcji są kierowane z powrotem do agenta jako zwykłe wiadomości przychodzące i stosują istniejące ustawienia Discord `replyToMode`. Obsługiwane bloki: - `text`, `section`, `separator`, `actions`, `media-gallery`, `file` - Wiersze akcji pozwalają na maksymalnie 5 przycisków albo jedno menu wyboru - Typy wyboru: `string`, `user`, `role`, `mentionable`, `channel` Domyślnie komponenty są jednorazowego użytku. Ustaw `components.reusable=true`, aby pozwolić na wielokrotne używanie przycisków, wyborów i formularzy do czasu ich wygaśnięcia. Aby ograniczyć, kto może kliknąć przycisk, ustaw `allowedUsers` na tym przycisku (identyfikatory użytkowników Discord, tagi lub `*`). Po skonfigurowaniu niedopasowani użytkownicy otrzymają efemeryczną odmowę. Wywołania zwrotne komponentów wygasają domyślnie po 30 minutach. Ustaw `channels.discord.agentComponents.ttlMs`, aby zmienić czas życia tego rejestru wywołań zwrotnych dla domyślnego konta Discord, albo `channels.discord.accounts..agentComponents.ttlMs`, aby nadpisać jedno konto w konfiguracji wielokontowej. Wartość jest w milisekundach, musi być dodatnią liczbą całkowitą i jest ograniczona do `86400000` (24 godziny). Dłuższe TTL są przydatne w przepływach przeglądu lub zatwierdzania, które wymagają, aby przyciski pozostawały używalne, ale wydłużają też okno, w którym stara wiadomość Discord nadal może wyzwolić akcję. Preferuj najkrótsze TTL pasujące do przepływu pracy i zachowaj wartość domyślną, gdy nieaktualne wywołania zwrotne byłyby zaskakujące. Polecenia ukośnikowe `/model` i `/models` otwierają interaktywny wybór modelu z listami rozwijanymi dostawcy, modelu i zgodnego środowiska wykonawczego oraz krokiem Prześlij. `/models add` jest przestarzałe i teraz zwraca komunikat o przestarzałości zamiast rejestrować modele z czatu. Odpowiedź selektora jest efemeryczna i może jej używać tylko użytkownik, który ją wywołał. Menu wyboru Discord są ograniczone do 25 opcji, więc dodaj wpisy `provider/*` do `agents.defaults.models`, gdy chcesz, aby selektor pokazywał dynamicznie wykryte modele tylko dla wybranych dostawców, takich jak `openai` lub `vllm`. Załączniki plików: - Bloki `file` muszą wskazywać na odwołanie do załącznika (`attachment://`) - Przekaż załącznik przez `media`/`path`/`filePath` (pojedynczy plik); użyj `media-gallery` dla wielu plików - Użyj `filename`, aby nadpisać nazwę przesyłanego pliku, gdy powinna odpowiadać odwołaniu do załącznika Formularze modalne: - Dodaj `components.modal` z maksymalnie 5 polami - Typy pól: `text`, `checkbox`, `radio`, `select`, `role-select`, `user-select` - OpenClaw automatycznie dodaje przycisk wyzwalający Przykład: ```json5 { channel: "discord", action: "send", to: "channel:123456789012345678", message: "Optional fallback text", components: { reusable: true, text: "Choose a path", blocks: [ { type: "actions", buttons: [ { label: "Approve", style: "success", allowedUsers: ["123456789012345678"], }, { label: "Decline", style: "danger" }, ], }, { type: "actions", select: { type: "string", placeholder: "Pick an option", options: [ { label: "Option A", value: "a" }, { label: "Option B", value: "b" }, ], }, }, ], modal: { title: "Details", triggerLabel: "Open form", fields: [ { type: "text", label: "Requester" }, { type: "select", label: "Priority", options: [ { label: "Low", value: "low" }, { label: "High", value: "high" }, ], }, ], }, }, } ``` ## Kontrola dostępu i routing `channels.discord.dmPolicy` kontroluje dostęp DM. `channels.discord.allowFrom` jest kanoniczną listą dozwolonych DM. - `pairing` (domyślnie) - `allowlist` - `open` (wymaga, aby `channels.discord.allowFrom` zawierało `"*"`) - `disabled` Jeśli polityka DM nie jest otwarta, nieznani użytkownicy są blokowani (lub proszeni o parowanie w trybie `pairing`). Priorytet w konfiguracji wielokontowej: - `channels.discord.accounts.default.allowFrom` dotyczy tylko konta `default`. - Dla jednego konta `allowFrom` ma pierwszeństwo przed starszym `dm.allowFrom`. - Nazwane konta dziedziczą `channels.discord.allowFrom`, gdy ich własne `allowFrom` i starsze `dm.allowFrom` nie są ustawione. - Nazwane konta nie dziedziczą `channels.discord.accounts.default.allowFrom`. Starsze `channels.discord.dm.policy` i `channels.discord.dm.allowFrom` są nadal odczytywane dla zgodności. `openclaw doctor --fix` migruje je do `dmPolicy` i `allowFrom`, gdy może to zrobić bez zmiany dostępu. Format celu DM dla dostarczania: - `user:` - wzmianka `<@id>` Same numeryczne identyfikatory zwykle są rozwiązywane jako identyfikatory kanałów, gdy aktywna jest wartość domyślna kanału, ale identyfikatory wymienione w efektywnej liście DM `allowFrom` konta są traktowane jako cele DM użytkownika dla zgodności. Wiadomości DM Discord i autoryzacja poleceń tekstowych mogą używać dynamicznych wpisów `accessGroup:` w `channels.discord.allowFrom`. Nazwy grup dostępu są współdzielone między kanałami wiadomości. Użyj `type: "message.senders"` dla statycznej grupy, której członkowie są wyrażeni w normalnej składni `allowFrom` każdego kanału, albo `type: "discord.channelAudience"`, gdy bieżąca publiczność `ViewChannel` kanału Discord ma dynamicznie definiować członkostwo. Współdzielone zachowanie grup dostępu jest udokumentowane tutaj: [Grupy dostępu](/pl/channels/access-groups). ```json5 { accessGroups: { operators: { type: "message.senders", members: { "*": ["global-owner-id"], discord: ["discord:123456789012345678"], telegram: ["987654321"], }, }, }, channels: { discord: { dmPolicy: "allowlist", allowFrom: ["accessGroup:operators"], }, }, } ``` Kanał tekstowy Discord nie ma osobnej listy członków. `type: "discord.channelAudience"` modeluje członkostwo tak: nadawca DM jest członkiem skonfigurowanej gildii i obecnie ma efektywne uprawnienie `ViewChannel` na skonfigurowanym kanale po zastosowaniu ról i nadpisań kanału. Przykład: pozwól każdemu, kto widzi `#maintainers`, wysyłać DM do bota, pozostawiając DM zamknięte dla wszystkich innych. ```json5 { accessGroups: { maintainers: { type: "discord.channelAudience", guildId: "1456350064065904867", channelId: "1456744319972282449", membership: "canViewChannel", }, }, channels: { discord: { dmPolicy: "allowlist", allowFrom: ["accessGroup:maintainers"], }, }, } ``` Możesz mieszać wpisy dynamiczne i statyczne: ```json5 { accessGroups: { maintainers: { type: "discord.channelAudience", guildId: "1456350064065904867", channelId: "1456744319972282449", }, }, channels: { discord: { dmPolicy: "allowlist", allowFrom: ["accessGroup:maintainers", "discord:123456789012345678"], }, }, } ``` Wyszukiwania kończą się zamknięciem dostępu w razie błędu. Jeśli Discord zwróci `Missing Access`, wyszukiwanie członka się nie powiedzie albo kanał należy do innej gildii, nadawca DM jest traktowany jako nieautoryzowany. Włącz **Server Members Intent** w Discord Developer Portal dla bota, gdy używasz grup dostępu opartych na publiczności kanału. DM nie zawierają stanu członka gildii, więc OpenClaw rozwiązuje członka przez Discord REST w czasie autoryzacji. Obsługą gildii steruje `channels.discord.groupPolicy`: - `open` - `allowlist` - `disabled` Bezpieczna baza, gdy istnieje `channels.discord`, to `allowlist`. Zachowanie `allowlist`: - gildia musi pasować do `channels.discord.guilds` (preferowane `id`, akceptowany slug) - opcjonalne listy dozwolonych nadawców: `users` (zalecane stabilne identyfikatory) i `roles` (tylko identyfikatory ról); jeśli skonfigurowano którąkolwiek z nich, nadawcy są dozwoleni, gdy pasują do `users` LUB `roles` - bezpośrednie dopasowywanie nazw/tagów jest domyślnie wyłączone; włącz `channels.discord.dangerouslyAllowNameMatching: true` tylko jako awaryjny tryb zgodności - nazwy/tagi są obsługiwane dla `users`, ale identyfikatory są bezpieczniejsze; `openclaw security audit` ostrzega, gdy używane są wpisy nazw/tagów - jeśli gildia ma skonfigurowane `channels`, kanały spoza listy są odrzucane - jeśli gildia nie ma bloku `channels`, wszystkie kanały w tej dozwolonej gildii są dozwolone Przykład: ```json5 { channels: { discord: { groupPolicy: "allowlist", guilds: { "123456789012345678": { requireMention: true, ignoreOtherMentions: true, users: ["987654321098765432"], roles: ["123456789012345678"], channels: { general: { allow: true }, help: { allow: true, requireMention: true }, }, }, }, }, }, } ``` Jeśli ustawisz tylko `DISCORD_BOT_TOKEN` i nie utworzysz bloku `channels.discord`, rezerwowe zachowanie środowiska wykonawczego to `groupPolicy="allowlist"` (z ostrzeżeniem w logach), nawet jeśli `channels.defaults.groupPolicy` ma wartość `open`. Wiadomości gildii domyślnie wymagają wzmianki. Wykrywanie wzmianek obejmuje: - jawną wzmiankę o bocie - skonfigurowane wzorce wzmianek (`agents.list[].groupChat.mentionPatterns`, rezerwowo `messages.groupChat.mentionPatterns`) - domyślne zachowanie odpowiedzi do bota w obsługiwanych przypadkach Podczas pisania wychodzących wiadomości Discord używaj kanonicznej składni wzmianek: `<@USER_ID>` dla użytkowników, `<#CHANNEL_ID>` dla kanałów i `<@&ROLE_ID>` dla ról. Nie używaj starszej formy wzmianki pseudonimu `<@!USER_ID>`. `requireMention` jest konfigurowane per gildia/kanał (`channels.discord.guilds...`). `ignoreOtherMentions` opcjonalnie odrzuca wiadomości, które wspominają innego użytkownika/rolę, ale nie bota (z wyłączeniem @everyone/@here). Grupowe DM: - domyślnie: ignorowane (`dm.groupEnabled=false`) - opcjonalna lista dozwolonych przez `dm.groupChannels` (identyfikatory kanałów lub slugi) ### Routing agentów oparty na rolach Użyj `bindings[].match.roles`, aby kierować członków gildii Discord do różnych agentów według identyfikatora roli. Powiązania oparte na rolach akceptują tylko identyfikatory ról i są oceniane po powiązaniach peer lub parent-peer oraz przed powiązaniami tylko dla gildii. Jeśli powiązanie ustawia też inne pola dopasowania (na przykład `peer` + `guildId` + `roles`), wszystkie skonfigurowane pola muszą pasować. ```json5 { bindings: [ { agentId: "opus", match: { channel: "discord", guildId: "123456789012345678", roles: ["111111111111111111"], }, }, { agentId: "sonnet", match: { channel: "discord", guildId: "123456789012345678", }, }, ], } ``` ## Polecenia natywne i autoryzacja poleceń - `commands.native` domyślnie ma wartość `"auto"` i jest włączone dla Discord. - Nadpisanie dla kanału: `channels.discord.commands.native`. - `commands.native=false` pomija rejestrację i czyszczenie poleceń slash Discord podczas uruchamiania. Wcześniej zarejestrowane polecenia mogą pozostać widoczne w Discord, dopóki nie usuniesz ich z aplikacji Discord. - Autoryzacja poleceń natywnych używa tych samych list dozwolonych/polityk Discord co zwykła obsługa wiadomości. - Polecenia nadal mogą być widoczne w interfejsie Discord dla użytkowników bez autoryzacji; wykonanie nadal egzekwuje autoryzację OpenClaw i zwraca komunikat „brak autoryzacji”. Zobacz [Polecenia slash](/pl/tools/slash-commands), aby poznać katalog poleceń i ich działanie. Domyślne ustawienia poleceń slash: - `ephemeral: true` ## Szczegóły funkcji Discord obsługuje tagi odpowiedzi w wyjściu agenta: - `[[reply_to_current]]` - `[[reply_to:]]` Kontrolowane przez `channels.discord.replyToMode`: - `off` (domyślnie) - `first` - `all` - `batched` Uwaga: `off` wyłącza niejawne wątkowanie odpowiedzi. Jawne tagi `[[reply_to_*]]` nadal są respektowane. `first` zawsze dołącza niejawną natywną referencję odpowiedzi do pierwszej wychodzącej wiadomości Discord w turze. `batched` dołącza niejawną natywną referencję odpowiedzi Discord tylko wtedy, gdy zdarzenie przychodzące było zdebounce'owaną partią wielu wiadomości. Jest to przydatne, gdy chcesz używać natywnych odpowiedzi głównie dla niejednoznacznych, gwałtownych czatów, a nie dla każdej tury z pojedynczą wiadomością. Identyfikatory wiadomości są udostępniane w kontekście/historii, aby agenci mogli kierować odpowiedzi do konkretnych wiadomości. Discord domyślnie generuje rozbudowane osadzenia linków dla adresów URL. OpenClaw domyślnie tłumi te wygenerowane osadzenia w wychodzących wiadomościach Discord, dzięki czemu adresy URL wysłane przez agenta pozostają zwykłymi linkami, chyba że włączysz je jawnie: ```json5 { channels: { discord: { suppressEmbeds: false, }, }, } ``` Ustaw `channels.discord.accounts..suppressEmbeds`, aby nadpisać ustawienie dla jednego konta. Wysyłki narzędzia wiadomości agenta mogą też przekazać `suppressEmbeds: false` dla pojedynczej wiadomości. Jawne ładunki `embeds` Discord nie są tłumione przez domyślne ustawienie podglądu linków. OpenClaw może streamować szkice odpowiedzi, wysyłając tymczasową wiadomość i edytując ją w miarę napływania tekstu. `channels.discord.streaming` przyjmuje `off` | `partial` | `block` | `progress` (domyślnie). `progress` utrzymuje jeden edytowalny szkic statusu i aktualizuje go postępem narzędzi aż do finalnego dostarczenia; współdzielona etykieta startowa jest przewijaną linią, więc znika z widoku tak jak reszta, gdy pojawi się wystarczająco dużo pracy. `streamMode` to starszy alias runtime. Uruchom `openclaw doctor --fix`, aby przepisać utrwaloną konfigurację na klucz kanoniczny. Ustaw `channels.discord.streaming.mode` na `off`, aby wyłączyć edycje podglądu Discord. Jeśli streaming blokowy Discord jest jawnie włączony, OpenClaw pomija stream podglądu, aby uniknąć podwójnego streamowania. ```json5 { channels: { discord: { streaming: { mode: "progress", progress: { label: "auto", maxLines: 8, maxLineChars: 120, toolProgress: true, commentary: false, }, }, }, }, } ``` - `partial` edytuje jedną wiadomość podglądu w miarę napływania tokenów. - `block` emituje fragmenty o rozmiarze szkicu (użyj `draftChunk`, aby dostroić rozmiar i punkty podziału, ograniczone do `textChunkLimit`). - Media, błędy i finały z jawną odpowiedzią anulują oczekujące edycje podglądu. - `streaming.preview.toolProgress` (domyślnie `true`) kontroluje, czy aktualizacje narzędzia/postępu ponownie używają wiadomości podglądu. - Wiersze narzędzia/postępu są renderowane jako kompaktowe emoji + tytuł + szczegóły, gdy są dostępne, na przykład `🛠️ Bash: run tests` albo `🔎 Web Search: for "query"`. - `streaming.progress.commentary` (domyślnie `false`) włącza tekst komentarza/preambuły asystenta w tymczasowym szkicu postępu. Komentarz jest czyszczony przed wyświetleniem, pozostaje przejściowy i nie zmienia dostarczenia finalnej odpowiedzi. - `streaming.progress.maxLineChars` kontroluje budżet podglądu postępu na linię. Proza jest skracana na granicach słów; szczegóły poleceń i ścieżek zachowują użyteczne sufiksy. - `streaming.preview.commandText` / `streaming.progress.commandText` kontroluje szczegóły polecenia/exec w kompaktowych liniach postępu: `raw` (domyślnie) albo `status` (tylko etykieta narzędzia). Ukryj surowy tekst polecenia/exec, zachowując kompaktowe linie postępu: ```json { "channels": { "discord": { "streaming": { "mode": "progress", "progress": { "toolProgress": true, "commandText": "status" } } } } } ``` Streaming podglądu obsługuje tylko tekst; odpowiedzi z mediami wracają do zwykłego dostarczania. Gdy streaming `block` jest jawnie włączony, OpenClaw pomija stream podglądu, aby uniknąć podwójnego streamowania. Kontekst historii gildii: - domyślne `channels.discord.historyLimit` to `20` - fallback: `messages.groupChat.historyLimit` - `0` wyłącza Kontrole historii DM: - `channels.discord.dmHistoryLimit` - `channels.discord.dms[""].historyLimit` Zachowanie wątków: - Wątki Discord są kierowane jako sesje kanału i dziedziczą konfigurację kanału nadrzędnego, chyba że zostaną nadpisane. - Sesje wątków dziedziczą wybór `/model` na poziomie sesji kanału nadrzędnego jako fallback tylko dla modelu; lokalne wybory `/model` w wątku nadal mają pierwszeństwo, a historia transkrypcji nadrzędnej nie jest kopiowana, chyba że włączono dziedziczenie transkrypcji. - `channels.discord.thread.inheritParent` (domyślnie `false`) włącza zasiewanie nowych automatycznych wątków z transkrypcji nadrzędnej. Nadpisania dla konta znajdują się pod `channels.discord.accounts..thread.inheritParent`. - Reakcje narzędzia wiadomości mogą rozwiązywać cele DM `user:`. - `guilds..channels..requireMention: false` jest zachowywane podczas fallbacku aktywacji na etapie odpowiedzi. Tematy kanałów są wstrzykiwane jako **niezaufany** kontekst. Listy dozwolonych określają, kto może wyzwolić agenta, a nie stanowią pełnej granicy redakcji dodatkowego kontekstu. Discord może powiązać wątek z celem sesji, aby kolejne wiadomości w tym wątku nadal były kierowane do tej samej sesji (w tym sesji podagentów). Polecenia: - `/focus ` powiąż bieżący/nowy wątek z celem podagenta/sesji - `/unfocus` usuń bieżące powiązanie wątku - `/agents` pokaż aktywne uruchomienia i stan powiązania - `/session idle ` sprawdź/zaktualizuj automatyczne odłączanie po bezczynności dla skupionych powiązań - `/session max-age ` sprawdź/zaktualizuj twardy maksymalny wiek dla skupionych powiązań Konfiguracja: ```json5 { session: { threadBindings: { enabled: true, idleHours: 24, maxAgeHours: 0, }, }, channels: { discord: { threadBindings: { enabled: true, idleHours: 24, maxAgeHours: 0, spawnSessions: true, defaultSpawnContext: "fork", }, }, }, } ``` Uwagi: - `session.threadBindings.*` ustawia domyślne wartości globalne. - `channels.discord.threadBindings.*` nadpisuje zachowanie Discord. - `spawnSessions` kontroluje automatyczne tworzenie/powiązanie wątków dla `sessions_spawn({ thread: true })` i tworzenia wątków ACP. Domyślnie: `true`. - `defaultSpawnContext` kontroluje natywny kontekst podagenta dla tworzeń powiązanych z wątkiem. Domyślnie: `"fork"`. - Przestarzałe klucze `spawnSubagentSessions`/`spawnAcpSessions` są migrowane przez `openclaw doctor --fix`. - Jeśli powiązania wątków są wyłączone dla konta, `/focus` i powiązane operacje powiązań wątków są niedostępne. Zobacz [Podagenci](/pl/tools/subagents), [Agenci ACP](/pl/tools/acp-agents) oraz [Dokumentację konfiguracji](/pl/gateway/configuration-reference). Dla stabilnych, „zawsze włączonych” przestrzeni roboczych ACP skonfiguruj typowane powiązania ACP najwyższego poziomu wskazujące rozmowy Discord. Ścieżka konfiguracji: - `bindings[]` z `type: "acp"` i `match.channel: "discord"` Przykład: ```json5 { agents: { list: [ { id: "codex", runtime: { type: "acp", acp: { agent: "codex", backend: "acpx", mode: "persistent", cwd: "/workspace/openclaw", }, }, }, ], }, bindings: [ { type: "acp", agentId: "codex", match: { channel: "discord", accountId: "default", peer: { kind: "channel", id: "222222222222222222" }, }, acp: { label: "codex-main" }, }, ], channels: { discord: { guilds: { "111111111111111111": { channels: { "222222222222222222": { requireMention: false, }, }, }, }, }, }, } ``` Uwagi: - `/acp spawn codex --bind here` wiąże bieżący kanał lub wątek w miejscu i utrzymuje przyszłe wiadomości w tej samej sesji ACP. Wiadomości wątku dziedziczą powiązanie kanału nadrzędnego. - W powiązanym kanale lub wątku `/new` i `/reset` resetują tę samą sesję ACP w miejscu. Tymczasowe powiązania wątków mogą nadpisywać rozwiązywanie celu, gdy są aktywne. - `spawnSessions` bramkuje tworzenie/powiązanie wątku podrzędnego przez `--thread auto|here`. Zobacz [Agenci ACP](/pl/tools/acp-agents), aby poznać szczegóły zachowania powiązań. Tryb powiadomień o reakcjach dla gildii: - `off` - `own` (domyślnie) - `all` - `allowlist` (używa `guilds..users`) Zdarzenia reakcji są przekształcane w zdarzenia systemowe i dołączane do kierowanej sesji Discord. `ackReaction` wysyła emoji potwierdzenia, gdy OpenClaw przetwarza przychodzącą wiadomość. Kolejność rozwiązywania: - `channels.discord.accounts..ackReaction` - `channels.discord.ackReaction` - `messages.ackReaction` - fallback emoji tożsamości agenta (`agents.list[].identity.emoji`, w przeciwnym razie "👀") Uwagi: - Discord akceptuje emoji unicode lub nazwy niestandardowych emoji. - Użyj `""`, aby wyłączyć reakcję dla kanału lub konta. Zapisy konfiguracji inicjowane przez kanał są domyślnie włączone. Dotyczy to przepływów `/config set|unset` (gdy funkcje poleceń są włączone). Wyłącz: ```json5 { channels: { discord: { configWrites: false, }, }, } ``` Kieruj ruch WebSocket Gateway Discord oraz startowe wyszukiwania REST (identyfikator aplikacji + rozwiązywanie listy dozwolonych) przez proxy HTTP(S) z `channels.discord.proxy`. Proxy WebSocket Discord Gateway jest jawne; połączenia WebSocket nie dziedziczą zmiennych środowiskowych proxy z otoczenia procesu Gateway. Startowe wyszukiwania REST używają tego proxy, gdy skonfigurowano `channels.discord.proxy`. ```json5 { channels: { discord: { proxy: "http://proxy.example:8080", }, }, } ``` Nadpisanie dla konta: ```json5 { channels: { discord: { accounts: { primary: { proxy: "http://proxy.example:8080", }, }, }, }, } ``` Włącz rozwiązywanie PluralKit, aby mapować proksowane wiadomości na tożsamość członka systemu: ```json5 { channels: { discord: { pluralkit: { enabled: true, token: "pk_live_...", // optional; needed for private systems }, }, }, } ``` Uwagi: - listy dozwolonych mogą używać `pk:` - nazwy wyświetlane członków są dopasowywane według nazwy/slugu tylko wtedy, gdy `channels.discord.dangerouslyAllowNameMatching: true` - wyszukiwania używają oryginalnego identyfikatora wiadomości i są ograniczone oknem czasowym - jeśli wyszukiwanie się nie powiedzie, proksowane wiadomości są traktowane jako wiadomości bota i odrzucane, chyba że `allowBots=true` Używaj `mentionAliases`, gdy agenci potrzebują deterministycznych wzmianek wychodzących dla znanych użytkowników Discord. Klucze to uchwyty bez początkowego `@`; wartości to identyfikatory użytkowników Discord. Nieznane uchwyty, `@everyone`, `@here` oraz wzmianki wewnątrz spanów kodu Markdown pozostają bez zmian. ```json5 { channels: { discord: { mentionAliases: { Vladislava: "123456789012345678", }, accounts: { ops: { mentionAliases: { OpsLead: "234567890123456789", }, }, }, }, }, } ``` Aktualizacje obecności są stosowane po ustawieniu pola statusu lub aktywności albo po włączeniu automatycznej obecności. Przykład tylko ze statusem: ```json5 { channels: { discord: { status: "idle", }, }, } ``` Przykład aktywności (status niestandardowy jest domyślnym typem aktywności): ```json5 { channels: { discord: { activity: "Focus time", activityType: 4, }, }, } ``` Przykład streamingu: ```json5 { channels: { discord: { activity: "Live coding", activityType: 1, activityUrl: "https://twitch.tv/openclaw", }, }, } ``` Mapa typów aktywności: - 0: Granie - 1: Streaming (wymaga `activityUrl`) - 2: Słuchanie - 3: Oglądanie - 4: Niestandardowa (używa tekstu aktywności jako stanu statusu; emoji jest opcjonalne) - 5: Rywalizacja Przykład automatycznej obecności (sygnał kondycji runtime): ```json5 { channels: { discord: { autoPresence: { enabled: true, intervalMs: 30000, minUpdateIntervalMs: 15000, exhaustedText: "token exhausted", }, }, }, } ``` Automatyczna obecność mapuje dostępność runtime na status Discord: sprawny => online, zdegradowany lub nieznany => idle, wyczerpany lub niedostępny => dnd. Opcjonalne nadpisania tekstu: - `autoPresence.healthyText` - `autoPresence.degradedText` - `autoPresence.exhaustedText` (obsługuje placeholder `{reason}`) Discord obsługuje zatwierdzenia oparte na przyciskach w wiadomościach prywatnych i może opcjonalnie publikować monity o zatwierdzenie w kanale źródłowym. Ścieżka konfiguracji: - `channels.discord.execApprovals.enabled` - `channels.discord.execApprovals.approvers` (opcjonalne; gdy to możliwe, wraca do `commands.ownerAllowFrom`) - `channels.discord.execApprovals.target` (`dm` | `channel` | `both`, domyślnie: `dm`) - `agentFilter`, `sessionFilter`, `cleanupAfterResolve` Discord automatycznie włącza natywne zatwierdzenia exec, gdy `enabled` jest nieustawione lub ma wartość `"auto"` i można rozwiązać co najmniej jednego zatwierdzającego, z `execApprovals.approvers` albo z `commands.ownerAllowFrom`. Discord nie wnioskuje zatwierdzających exec z kanałowego `allowFrom`, starszego `dm.allowFrom` ani bezpośredniej wiadomości `defaultTo`. Ustaw `enabled: false`, aby jawnie wyłączyć Discord jako natywnego klienta zatwierdzeń. W przypadku wrażliwych poleceń grupowych tylko dla właściciela, takich jak `/diagnostics` i `/export-trajectory`, OpenClaw wysyła monity o zatwierdzenie i końcowe wyniki prywatnie. Najpierw próbuje wiadomości prywatnej Discord, gdy wywołujący właściciel ma trasę właściciela Discord; jeśli nie jest dostępna, wraca do pierwszej dostępnej trasy właściciela z `commands.ownerAllowFrom`, takiej jak Telegram. Gdy `target` to `channel` lub `both`, monit o zatwierdzenie jest widoczny w kanale. Tylko rozwiązani zatwierdzający mogą używać przycisków; inni użytkownicy otrzymują efemeryczną odmowę. Monity o zatwierdzenie zawierają tekst polecenia, więc włączaj dostarczanie do kanału tylko w zaufanych kanałach. Jeśli identyfikatora kanału nie można wyprowadzić z klucza sesji, OpenClaw wraca do dostarczania przez wiadomość prywatną. Discord renderuje także współdzielone przyciski zatwierdzania używane przez inne kanały czatu. Natywny adapter Discord głównie dodaje trasowanie wiadomości prywatnych do zatwierdzających i fanout kanałowy. Gdy te przyciski są obecne, są podstawowym UX zatwierdzania; OpenClaw powinien dołączać ręczne polecenie `/approve` tylko wtedy, gdy wynik narzędzia mówi, że zatwierdzenia czatu są niedostępne albo ręczne zatwierdzenie jest jedyną ścieżką. Jeśli natywny runtime zatwierdzeń Discord nie jest aktywny, OpenClaw zachowuje widoczny lokalny deterministyczny monit `/approve `. Jeśli runtime jest aktywny, ale natywnej karty nie można dostarczyć do żadnego celu, OpenClaw wysyła w tym samym czacie zastępcze powiadomienie z dokładnym poleceniem `/approve` z oczekującego zatwierdzenia. Uwierzytelnianie Gateway i rozwiązywanie zatwierdzeń są zgodne ze współdzielonym kontraktem klienta Gateway (identyfikatory `plugin:` są rozwiązywane przez `plugin.approval.resolve`; inne identyfikatory przez `exec.approval.resolve`). Zatwierdzenia domyślnie wygasają po 30 minutach. Zobacz [Zatwierdzenia exec](/pl/tools/exec-approvals). ## Narzędzia i bramki akcji Akcje wiadomości Discord obejmują wiadomości, administrację kanałem, moderację, obecność i akcje metadanych. Podstawowe przykłady: - wiadomości: `sendMessage`, `readMessages`, `editMessage`, `deleteMessage`, `threadReply` - reakcje: `react`, `reactions`, `emojiList` - moderacja: `timeout`, `kick`, `ban` - obecność: `setPresence` Akcja `event-create` przyjmuje opcjonalny parametr `image` (URL lub ścieżkę do pliku lokalnego), aby ustawić obraz okładki zaplanowanego wydarzenia. Bramki akcji znajdują się pod `channels.discord.actions.*`. Domyślne zachowanie bramek: | Grupa akcji | Domyślnie | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------- | | reactions, messages, threads, pins, polls, search, memberInfo, roleInfo, channelInfo, channels, voiceStatus, events, stickers, emojiUploads, stickerUploads, permissions | włączone | | roles | wyłączone | | moderation | wyłączone | | presence | wyłączone | ## Interfejs komponentów v2 OpenClaw używa komponentów Discord v2 do zatwierdzeń exec i znaczników międzykontekstowych. Akcje wiadomości Discord mogą także przyjmować `components` dla niestandardowego interfejsu (zaawansowane; wymaga skonstruowania payloadu komponentu przez narzędzie discord), podczas gdy starsze `embeds` pozostają dostępne, ale nie są zalecane. - `channels.discord.ui.components.accentColor` ustawia kolor akcentu używany przez kontenery komponentów Discord (hex). - Ustaw dla konta za pomocą `channels.discord.accounts..ui.components.accentColor`. - `channels.discord.agentComponents.ttlMs` kontroluje, jak długo wysłane callbacki komponentów Discord pozostają zarejestrowane (domyślnie `1800000`, maksymalnie `86400000`). Ustaw dla konta za pomocą `channels.discord.accounts..agentComponents.ttlMs`. - `embeds` są ignorowane, gdy obecne są komponenty v2. - Zwykłe podglądy URL są domyślnie tłumione. Ustaw `suppressEmbeds: false` w akcji wiadomości, gdy pojedynczy link wychodzący powinien się rozwinąć. Przykład: ```json5 { channels: { discord: { ui: { components: { accentColor: "#5865F2", }, }, }, }, } ``` ## Głos Discord ma dwie odrębne powierzchnie głosowe: **kanały głosowe** czasu rzeczywistego (ciągłe rozmowy) i **załączniki wiadomości głosowych** (format podglądu fali dźwiękowej). Gateway obsługuje oba. ### Kanały głosowe Lista kontrolna konfiguracji: 1. Włącz Message Content Intent w Discord Developer Portal. 2. Włącz Server Members Intent, gdy używane są listy dozwolonych ról/użytkowników. 3. Zaproś bota z zakresami `bot` i `applications.commands`. 4. Przyznaj Connect, Speak, Send Messages i Read Message History w docelowym kanale głosowym. 5. Włącz natywne polecenia (`commands.native` lub `channels.discord.commands.native`). 6. Skonfiguruj `channels.discord.voice`. Użyj `/vc join|leave|status`, aby kontrolować sesje. Polecenie używa domyślnego agenta konta i stosuje te same reguły list dozwolonych oraz polityki grupowej co inne polecenia Discord. ```bash /vc join channel: /vc status /vc leave ``` Aby sprawdzić efektywne uprawnienia bota przed dołączeniem, uruchom: ```bash openclaw channels capabilities --channel discord --target channel: ``` Przykład automatycznego dołączania: ```json5 { channels: { discord: { voice: { enabled: true, model: "openai/gpt-5.5", autoJoin: [ { guildId: "123456789012345678", channelId: "234567890123456789", }, ], allowedChannels: [ { guildId: "123456789012345678", channelId: "234567890123456789", }, ], daveEncryption: true, decryptionFailureTolerance: 24, connectTimeoutMs: 30000, reconnectGraceMs: 15000, realtime: { provider: "openai", model: "gpt-realtime-2", speakerVoice: "cedar", }, }, }, }, } ``` Uwagi: - `voice.tts` zastępuje `messages.tts` tylko dla odtwarzania głosu `stt-tts`. Tryby czasu rzeczywistego używają `voice.realtime.speakerVoice`. - `voice.mode` steruje ścieżką rozmowy. Domyślnie jest to `agent-proxy`: głosowy interfejs czasu rzeczywistego obsługuje czas tur, przerywanie i odtwarzanie, deleguje merytoryczną pracę do kierowanego agenta OpenClaw przez `openclaw_agent_consult` i traktuje wynik jak wpisane zapytanie Discord od tego mówcy. `stt-tts` zachowuje starszy przepływ wsadowego STT plus TTS. `bidi` pozwala modelowi czasu rzeczywistego rozmawiać bezpośrednio, jednocześnie udostępniając `openclaw_agent_consult` dla mózgu OpenClaw. - `voice.agentSession` steruje tym, która rozmowa OpenClaw otrzymuje tury głosowe. Pozostaw tę wartość nieustawioną dla własnej sesji kanału głosowego albo ustaw `{ mode: "target", target: "channel:" }`, aby kanał głosowy działał jako rozszerzenie mikrofonu/głośnika istniejącej sesji kanału tekstowego Discord, takiej jak `#maintainers`. - `voice.model` zastępuje mózg agenta OpenClaw dla głosowych odpowiedzi Discord i konsultacji czasu rzeczywistego. Pozostaw tę wartość nieustawioną, aby dziedziczyć kierowany model agenta. Jest to ustawienie oddzielne od `voice.realtime.model`. - `voice.followUsers` pozwala botowi dołączać, przenosić się i opuszczać głos Discord z wybranymi użytkownikami. Zobacz [Śledzenie użytkowników w głosie](#follow-users-in-voice), aby poznać reguły zachowania i przykłady. - `agent-proxy` kieruje mowę przez `discord-voice`, co zachowuje normalną autoryzację właściciela/narzędzi dla mówcy i sesji docelowej, ale ukrywa narzędzie agenta `tts`, ponieważ głos Discord odpowiada za odtwarzanie. Domyślnie `agent-proxy` daje konsultacji pełny dostęp do narzędzi równoważny właścicielowi dla mówców-właścicieli (`voice.realtime.toolPolicy: "owner"`) i zdecydowanie preferuje konsultację z agentem OpenClaw przed merytorycznymi odpowiedziami (`voice.realtime.consultPolicy: "always"`). W tym domyślnym trybie `always` warstwa czasu rzeczywistego nie wypowiada automatycznie wypełniaczy przed odpowiedzią konsultacji; przechwytuje i transkrybuje mowę, a następnie wypowiada kierowaną odpowiedź OpenClaw. Jeśli wiele wymuszonych odpowiedzi konsultacji zakończy się, gdy Discord nadal odtwarza pierwszą odpowiedź, późniejsze odpowiedzi z dokładną mową są kolejkowane do czasu bezczynności odtwarzania, zamiast zastępować mowę w połowie zdania. - W trybie `stt-tts` STT używa `tools.media.audio`; `voice.model` nie wpływa na transkrypcję. - W trybach czasu rzeczywistego `voice.realtime.provider`, `voice.realtime.model` i `voice.realtime.speakerVoice` konfigurują sesję audio czasu rzeczywistego. Dla OpenAI Realtime 2 plus mózgu Codex użyj `voice.realtime.model: "gpt-realtime-2"` i `voice.model: "openai/gpt-5.5"`. - Tryby głosu czasu rzeczywistego domyślnie dołączają małe pliki profilu `IDENTITY.md`, `USER.md` i `SOUL.md` do instrukcji dostawcy czasu rzeczywistego, aby szybkie bezpośrednie tury zachowały tę samą tożsamość, osadzenie użytkownika i personę co kierowany agent OpenClaw. Ustaw `voice.realtime.bootstrapContextFiles` na podzbiór, aby to dostosować, albo `[]`, aby to wyłączyć. Obsługiwane pliki inicjalizacyjne czasu rzeczywistego są ograniczone do tych plików profilu; `AGENTS.md` pozostaje w normalnym kontekście agenta. Wstrzyknięty kontekst profilu nie zastępuje `openclaw_agent_consult` dla pracy w obszarze roboczym, bieżących faktów, wyszukiwania pamięci ani działań wspieranych narzędziami. - W trybie czasu rzeczywistego OpenAI `agent-proxy` ustaw `voice.realtime.requireWakeName: true`, aby głos czasu rzeczywistego Discord pozostawał cichy, dopóki transkrypcja nie zacznie się lub nie zakończy nazwą wybudzającą. Skonfigurowane nazwy wybudzające muszą mieć jedno albo dwa słowa. Jeśli `voice.realtime.wakeNames` nie jest ustawione, OpenClaw używa kierowanej nazwy agenta `name` plus `OpenClaw`, a w razie potrzeby identyfikatora agenta plus `OpenClaw`. Bramkowanie nazwą wybudzającą wyłącza automatyczną odpowiedź dostawcy czasu rzeczywistego, kieruje zaakceptowane tury przez ścieżkę konsultacji agenta OpenClaw i daje krótkie wypowiedziane potwierdzenie, gdy początkowa nazwa wybudzająca zostanie rozpoznana z częściowej transkrypcji przed nadejściem końcowej transkrypcji. - Dostawca OpenAI czasu rzeczywistego akceptuje bieżące nazwy zdarzeń Realtime 2 oraz starsze aliasy zgodne z Codex dla zdarzeń audio wyjściowego i transkrypcji, dzięki czemu zgodne migawki dostawcy mogą się zmieniać bez utraty audio asystenta. - `voice.realtime.bargeIn` steruje tym, czy zdarzenia rozpoczęcia mówienia w Discord przerywają aktywne odtwarzanie czasu rzeczywistego. Jeśli nie jest ustawione, podąża za ustawieniem przerwania audio wejściowego dostawcy czasu rzeczywistego. - `voice.realtime.minBargeInAudioEndMs` steruje minimalnym czasem odtwarzania asystenta przed tym, jak wtrącenie OpenAI czasu rzeczywistego przytnie audio. Domyślnie: `250`. Ustaw `0` dla natychmiastowego przerwania w pomieszczeniach z niskim echem albo zwiększ tę wartość dla konfiguracji głośników z dużym echem. - Dla głosu OpenAI w odtwarzaniu Discord ustaw `voice.tts.provider: "openai"` i wybierz głos Text-to-speech w `voice.tts.providers.openai.speakerVoice`. `cedar` to dobry męsko brzmiący wybór w bieżącym modelu TTS OpenAI. - Nadpisania `systemPrompt` Discord dla poszczególnych kanałów mają zastosowanie do tur transkrypcji głosu dla tego kanału głosowego. - Tury transkrypcji głosu wyprowadzają status właściciela z Discord `allowFrom` (albo `dm.allowFrom`) dla poleceń bramkowanych właścicielem i działań kanału. Widoczność narzędzi agenta podąża za skonfigurowaną polityką narzędzi dla kierowanej sesji. - Głos Discord jest opcjonalny dla konfiguracji tylko tekstowych; ustaw `channels.discord.voice.enabled=true` (albo zachowaj istniejący blok `channels.discord.voice`), aby włączyć polecenia `/vc`, środowisko wykonawcze głosu i intencję Gateway `GuildVoiceStates`. - `channels.discord.intents.voiceStates` może jawnie zastąpić subskrypcję intencji stanu głosu. Pozostaw tę wartość nieustawioną, aby intencja podążała za efektywnym włączeniem głosu. - Jeśli `voice.autoJoin` ma wiele wpisów dla tej samej gildii, OpenClaw dołącza do ostatniego skonfigurowanego kanału dla tej gildii. - `voice.allowedChannels` to opcjonalna lista dozwolonych miejsc pobytu. Pozostaw ją nieustawioną, aby zezwolić `/vc join` na dołączanie do dowolnego autoryzowanego kanału głosowego Discord. Gdy jest ustawiona, `/vc join`, automatyczne dołączenie przy starcie i przenoszenia stanu głosu bota są ograniczone do wymienionych wpisów `{ guildId, channelId }`. Ustaw ją na pustą tablicę, aby odmówić wszystkich dołączeń do głosu Discord. Jeśli Discord przeniesie bota poza listę dozwolonych, OpenClaw opuści ten kanał i ponownie dołączy do skonfigurowanego celu automatycznego dołączenia, gdy taki jest dostępny. - `voice.daveEncryption` i `voice.decryptionFailureTolerance` są przekazywane do opcji dołączenia `@discordjs/voice`. - Domyślne wartości `@discordjs/voice` to `daveEncryption=true` i `decryptionFailureTolerance=24`, jeśli nie są ustawione. - OpenClaw używa dołączonego kodeka `libopus-wasm` do odbierania głosu Discord i odtwarzania surowego PCM w czasie rzeczywistym. Dostarcza przypiętą kompilację WebAssembly libopus i nie wymaga natywnych dodatków opus. - `voice.connectTimeoutMs` steruje początkowym oczekiwaniem `@discordjs/voice` Ready dla prób `/vc join` i automatycznego dołączania. Domyślnie: `30000`. - `voice.reconnectGraceMs` steruje tym, jak długo OpenClaw czeka, aż rozłączona sesja głosowa zacznie ponownie się łączyć, zanim ją zniszczy. Domyślnie: `15000`. - W trybie `stt-tts` odtwarzanie głosu nie zatrzymuje się tylko dlatego, że inny użytkownik zaczyna mówić. Aby uniknąć pętli sprzężenia zwrotnego, OpenClaw ignoruje nowe przechwytywanie głosu podczas odtwarzania TTS; mów po zakończeniu odtwarzania, aby rozpocząć następną turę. Tryby czasu rzeczywistego przekazują rozpoczęcia mówienia jako sygnały wtrącenia do dostawcy czasu rzeczywistego. - W trybach czasu rzeczywistego echo z głośników do otwartego mikrofonu może wyglądać jak wtrącenie i przerwać odtwarzanie. Dla pokojów Discord z dużym echem ustaw `voice.realtime.providers.openai.interruptResponseOnInputAudio: false`, aby uniemożliwić OpenAI automatyczne przerywanie przy audio wejściowym. Dodaj `voice.realtime.bargeIn: true`, jeśli nadal chcesz, aby zdarzenia rozpoczęcia mówienia Discord przerywały aktywne odtwarzanie. Most czasu rzeczywistego OpenAI ignoruje przycięcia odtwarzania krótsze niż `voice.realtime.minBargeInAudioEndMs` jako prawdopodobne echo/szum i zapisuje je jako pominięte zamiast czyścić odtwarzanie Discord. - `voice.captureSilenceGraceMs` steruje tym, jak długo OpenClaw czeka po zgłoszeniu przez Discord, że mówca przestał mówić, zanim sfinalizuje ten segment audio dla STT. Domyślnie: `2000`; zwiększ tę wartość, jeśli Discord dzieli normalne pauzy na poszarpane częściowe transkrypcje. - Gdy ElevenLabs jest wybranym dostawcą TTS, odtwarzanie głosu Discord używa strumieniowego TTS i zaczyna od strumienia odpowiedzi dostawcy. Dostawcy bez obsługi strumieniowania wracają do ścieżki zsyntetyzowanego pliku tymczasowego. - OpenClaw obserwuje także błędy odszyfrowywania odbioru i automatycznie odzyskuje działanie przez opuszczenie/ponowne dołączenie do kanału głosowego po powtarzających się błędach w krótkim oknie. - Jeśli logi odbioru wielokrotnie pokazują `DecryptionFailed(UnencryptedWhenPassthroughDisabled)` po aktualizacji, zbierz raport zależności i logi. Dołączona linia `@discordjs/voice` obejmuje poprawkę upstream padding z PR discord.js #11449, która zamknęła issue discord.js #11419. - Zdarzenia odbioru `The operation was aborted` są oczekiwane, gdy OpenClaw finalizuje przechwycony segment mówcy; są to szczegółowe diagnostyki, a nie ostrzeżenia. - Szczegółowe logi głosu Discord zawierają ograniczony jednoliniowy podgląd transkrypcji STT dla każdego zaakceptowanego segmentu mówcy, dzięki czemu debugowanie pokazuje zarówno stronę użytkownika, jak i stronę odpowiedzi agenta bez zrzucania nieograniczonego tekstu transkrypcji. - W trybie `agent-proxy` wymuszona rezerwowa konsultacja pomija prawdopodobnie niekompletne fragmenty transkrypcji, takie jak tekst kończący się na `...` albo końcowy łącznik typu `and`, a także oczywiste nieoperacyjne zakończenia, takie jak „zaraz wracam” albo „pa”. Logi pokazują `forced agent consult skipped reason=...`, gdy zapobiega to nieaktualnej zakolejkowanej odpowiedzi. ### Śledzenie użytkowników w głosie Użyj `voice.followUsers`, gdy chcesz, aby bot głosowy Discord pozostawał z jednym lub większą liczbą znanych użytkowników Discord, zamiast dołączać do stałego kanału przy starcie albo czekać na `/vc join`. ```json5 { channels: { discord: { voice: { enabled: true, followUsersEnabled: true, followUsers: ["discord:123456789012345678"], allowedChannels: [ { guildId: "123456789012345678", channelId: "234567890123456789", }, ], }, }, }, } ``` Zachowanie: - `followUsers` akceptuje surowe identyfikatory użytkowników Discord oraz wartości `discord:`. OpenClaw normalizuje obie formy przed dopasowaniem zdarzeń stanu głosu. - `followUsersEnabled` domyślnie ma wartość `true`, gdy `followUsers` jest skonfigurowane. Ustaw ją na `false`, aby zachować zapisaną listę, ale zatrzymać automatyczne śledzenie głosowe. - Gdy śledzony użytkownik dołączy do dozwolonego kanału głosowego, OpenClaw dołącza do tego kanału. Gdy użytkownik się przenosi, OpenClaw przenosi się z nim. Gdy aktywny śledzony użytkownik się rozłączy, OpenClaw wychodzi. - Jeśli wielu śledzonych użytkowników jest w tej samej gildii i aktywny śledzony użytkownik odejdzie, OpenClaw przenosi się do kanału innego śledzonego użytkownika przed opuszczeniem gildii. Jeśli kilku śledzonych użytkowników przenosi się jednocześnie, wygrywa ostatnio zaobserwowane zdarzenie stanu głosu. - `allowedChannels` nadal ma zastosowanie. Śledzony użytkownik w niedozwolonym kanale jest ignorowany, a sesja należąca do śledzenia przenosi się do innego śledzonego użytkownika albo wychodzi. - OpenClaw uzgadnia pominięte zdarzenia stanu głosu przy starcie i w ograniczonym interwale. Uzgadnianie próbuje skonfigurowane gildie i ogranicza wyszukiwania REST na uruchomienie, więc bardzo duże listy `followUsers` mogą potrzebować więcej niż jednego interwału, aby się zbiec. - Jeśli Discord albo administrator przeniesie bota, gdy ten śledzi użytkownika, OpenClaw odbudowuje sesję głosową i zachowuje własność śledzenia, gdy miejsce docelowe jest dozwolone. Jeśli bot zostanie przeniesiony poza `allowedChannels`, OpenClaw wychodzi i ponownie dołącza do skonfigurowanego celu, gdy taki istnieje. - Odzyskiwanie odbioru DAVE może opuścić i ponownie dołączyć do tego samego kanału po powtarzających się błędach odszyfrowywania. Sesje należące do śledzenia zachowują swoją własność śledzenia przez tę ścieżkę odzyskiwania, więc późniejsze rozłączenie śledzonego użytkownika nadal opuszcza kanał. Wybierz między trybami dołączania: - Użyj `followUsers` dla konfiguracji osobistych lub operatorskich, w których bot powinien automatycznie być w głosie, gdy ty tam jesteś. - Użyj `autoJoin` dla botów stałych pokojów, które powinny być obecne nawet wtedy, gdy żaden śledzony użytkownik nie jest w głosie. - Użyj `/vc join` dla jednorazowych dołączeń albo pokojów, w których automatyczna obecność głosowa byłaby zaskakująca. Kodek głosu Discord: - Logi odbierania głosu pokazują `discord voice: opus decoder: libopus-wasm`. - Odtwarzanie Realtime koduje surowe stereo PCM 48 kHz do Opus za pomocą tego samego dołączonego pakietu `libopus-wasm`, zanim przekaże pakiety do `@discordjs/voice`. - Odtwarzanie plików i strumieni od dostawców transkoduje do surowego stereo PCM 48 kHz za pomocą ffmpeg, a następnie używa `libopus-wasm` do strumienia pakietów Opus wysyłanego do Discord. Potok STT plus TTS: - Przechwytywanie PCM z Discord jest konwertowane na tymczasowy plik WAV. - `tools.media.audio` obsługuje STT, na przykład `openai/gpt-4o-mini-transcribe`. - Transkrypcja jest wysyłana przez wejście i routing Discord, podczas gdy odpowiedziowy LLM działa z zasadą wyjścia głosowego, która ukrywa narzędzie agenta `tts` i prosi o zwrócony tekst, ponieważ głos Discord odpowiada za końcowe odtwarzanie TTS. - `voice.model`, jeśli ustawione, nadpisuje tylko odpowiedziowy LLM dla tej tury kanału głosowego. - `voice.tts` jest scalane na wierzchu `messages.tts`; dostawcy obsługujący strumieniowanie zasilają odtwarzacz bezpośrednio, w przeciwnym razie wynikowy plik audio jest odtwarzany na dołączonym kanale. Przykład domyślnej sesji kanału głosowego agent-proxy: ```json5 { channels: { discord: { voice: { enabled: true, model: "openai/gpt-5.5", followUsersEnabled: true, followUsers: ["123456789012345678"], realtime: { provider: "openai", model: "gpt-realtime-2", speakerVoice: "cedar", }, }, }, }, } ``` Bez bloku `voice.agentSession` każdy kanał głosowy otrzymuje własną routowaną sesję OpenClaw. Na przykład `/vc join channel:234567890123456789` rozmawia z sesją dla tego kanału głosowego Discord. Model realtime jest tylko głosowym interfejsem; istotne żądania są przekazywane do skonfigurowanego agenta OpenClaw. Jeśli model realtime wygeneruje końcową transkrypcję bez wywołania narzędzia konsultacji, OpenClaw wymusza konsultację jako fallback, aby domyślne zachowanie nadal przypominało rozmowę z agentem. Przykład starszego STT plus TTS: ```json5 { channels: { discord: { voice: { enabled: true, mode: "stt-tts", model: "openai/gpt-5.4-mini", tts: { provider: "openai", providers: { openai: { model: "gpt-4o-mini-tts", speakerVoice: "cedar", }, }, }, }, }, }, } ``` Przykład dwukierunkowego realtime: ```json5 { channels: { discord: { voice: { enabled: true, mode: "bidi", model: "openai/gpt-5.5", realtime: { provider: "openai", model: "gpt-realtime-2", speakerVoice: "cedar", toolPolicy: "safe-read-only", consultPolicy: "always", }, }, }, }, } ``` Głos jako rozszerzenie istniejącej sesji kanału Discord: ```json5 { channels: { discord: { voice: { enabled: true, mode: "agent-proxy", model: "openai/gpt-5.5", agentSession: { mode: "target", target: "channel:123456789012345678", }, realtime: { provider: "openai", model: "gpt-realtime-2", speakerVoice: "cedar", }, }, }, }, } ``` W trybie `agent-proxy` bot dołącza do skonfigurowanego kanału głosowego, ale tury agenta OpenClaw używają normalnej routowanej sesji i agenta kanału docelowego. Głosowa sesja realtime wypowiada zwrócony wynik z powrotem na kanale głosowym. Agent nadzorujący nadal może używać normalnych narzędzi wiadomości zgodnie ze swoją zasadą narzędzi, w tym wysłać osobną wiadomość Discord, jeśli jest to właściwe działanie. Gdy delegowane uruchomienie OpenClaw jest aktywne, nowe transkrypcje głosowe Discord są traktowane jako sterowanie uruchomieniem na żywo przed rozpoczęciem kolejnej tury agenta. Frazy takie jak „status”, „cancel that”, „use the smaller fix” lub „when you're done also check tests” są klasyfikowane jako status, anulowanie, sterowanie lub dane wejściowe follow-up dla aktywnej sesji. Wyniki statusu, anulowania, zaakceptowanego sterowania i follow-up są wypowiadane z powrotem na kanale głosowym, aby rozmówca wiedział, czy OpenClaw obsłużył żądanie. Przydatne formy celu: - `target: "channel:123456789012345678"` routuje przez sesję kanału tekstowego Discord. - `target: "123456789012345678"` jest traktowane jako cel kanału. - `target: "dm:123456789012345678"` lub `target: "user:123456789012345678"` routuje przez tę sesję wiadomości bezpośrednich. Przykład OpenAI Realtime z dużym echem: ```json5 { channels: { discord: { voice: { enabled: true, mode: "bidi", model: "openai/gpt-5.5", realtime: { provider: "openai", model: "gpt-realtime-2", speakerVoice: "cedar", bargeIn: true, minBargeInAudioEndMs: 500, consultPolicy: "always", providers: { openai: { interruptResponseOnInputAudio: false, }, }, }, }, }, }, } ``` Użyj tego, gdy model słyszy własne odtwarzanie Discord przez otwarty mikrofon, ale nadal chcesz mu przerwać, mówiąc. OpenClaw powstrzymuje OpenAI przed automatycznym przerywaniem na podstawie surowego wejścia audio, a jednocześnie `bargeIn: true` pozwala zdarzeniom rozpoczęcia mówienia w Discord i już aktywnemu dźwiękowi mówcy anulować aktywne odpowiedzi realtime, zanim następna przechwycona tura dotrze do OpenAI. Bardzo wczesne sygnały wtrącenia z `audioEndMs` poniżej `minBargeInAudioEndMs` są traktowane jako prawdopodobne echo/szum i ignorowane, aby model nie urywał odpowiedzi przy pierwszej klatce odtwarzania. Oczekiwane logi głosowe: - Przy dołączeniu: `discord voice: joining ... voiceSession=... supervisorSession=... agentSessionMode=... voiceModel=... realtimeModel=...` - Przy starcie realtime: `discord voice: realtime bridge starting ... autoRespond=false interruptResponse=false bargeIn=false minBargeInAudioEndMs=...` - Przy dźwięku mówcy: `discord voice: realtime speaker turn opened ...`, `discord voice: realtime input audio started ... outputAudioMs=... outputActive=...` oraz `discord voice: realtime speaker turn closed ... chunks=... discordBytes=... realtimeBytes=... interruptedPlayback=...` - Przy pominiętej nieaktualnej mowie: `discord voice: realtime forced agent consult skipped reason=incomplete-transcript ...` lub `reason=non-actionable-closing ...` - Przy zakończeniu odpowiedzi realtime: `discord voice: realtime audio playback finishing reason=response.done ... audioMs=... chunks=...` - Przy zatrzymaniu/resecie odtwarzania: `discord voice: realtime audio playback stopped reason=... audioMs=... elapsedMs=... chunks=...` - Przy konsultacji realtime: `discord voice: realtime consult requested ... voiceSession=... supervisorSession=... question=...` - Przy odpowiedzi agenta: `discord voice: agent turn answer ...` - Przy zakolejkowanej dokładnej wypowiedzi: `discord voice: realtime exact speech queued ... queued=... outputAudioMs=... outputActive=...`, po czym następuje `discord voice: realtime exact speech dequeued reason=player-idle ...` - Przy wykryciu wtrącenia: `discord voice: realtime barge-in detected source=speaker-start ...` lub `discord voice: realtime barge-in detected source=active-speaker-audio ...`, po czym następuje `discord voice: realtime barge-in requested reason=... outputAudioMs=... outputActive=...` - Przy przerwaniu realtime: `discord voice: realtime model interrupt requested client:response.cancel reason=barge-in`, po czym następuje albo `discord voice: realtime model audio truncated client:conversation.item.truncate reason=barge-in audioEndMs=...`, albo `discord voice: realtime model interrupt confirmed server:response.done status=cancelled ...` - Przy zignorowanym echu/szumie: `discord voice: realtime model interrupt ignored client:conversation.item.truncate.skipped reason=barge-in audioEndMs=0 minAudioEndMs=250` - Przy wyłączonym wtrąceniu: `discord voice: realtime capture ignored during playback (barge-in disabled) ...` - Przy bezczynnym odtwarzaniu: `discord voice: realtime barge-in ignored reason=... outputActive=false ... playbackChunks=0` Aby debugować ucięty dźwięk, czytaj logi głosu realtime jako oś czasu: 1. `realtime audio playback started` oznacza, że Discord rozpoczął odtwarzanie dźwięku asystenta. Od tego momentu most zaczyna zliczać fragmenty wyjścia asystenta, bajty PCM Discord, bajty realtime dostawcy i czas trwania syntetyzowanego audio. 2. `realtime speaker turn opened` oznacza, że mówca Discord stał się aktywny. Jeśli odtwarzanie jest już aktywne i `bargeIn` jest włączone, po tym może nastąpić `barge-in detected source=speaker-start`. 3. `realtime input audio started` oznacza pierwszą rzeczywistą klatkę audio odebraną dla tej tury mówcy. `outputActive=true` lub niezerowe `outputAudioMs` w tym miejscu oznacza, że mikrofon wysyła wejście, gdy odtwarzanie asystenta nadal jest aktywne. 4. `barge-in detected source=active-speaker-audio` oznacza, że OpenClaw zobaczył dźwięk mówcy na żywo, gdy odtwarzanie asystenta było aktywne. Jest to przydatne do odróżnienia rzeczywistego przerwania od zdarzenia rozpoczęcia mówienia w Discord bez użytecznego audio. 5. `barge-in requested reason=...` oznacza, że OpenClaw poprosił dostawcę realtime o anulowanie lub przycięcie aktywnej odpowiedzi. Zawiera `outputAudioMs`, `outputActive` i `playbackChunks`, aby można było zobaczyć, ile dźwięku asystenta faktycznie odtworzono przed przerwaniem. 6. `realtime audio playback stopped reason=...` to lokalny punkt resetu odtwarzania Discord. Powód mówi, kto zatrzymał odtwarzanie: `barge-in`, `player-idle`, `provider-clear-audio`, `forced-agent-consult`, `stream-close` lub `session-close`. 7. `realtime speaker turn closed` podsumowuje przechwyconą turę wejściową. `chunks=0` lub `hasAudio=false` oznacza, że tura mówcy została otwarta, ale żadne użyteczne audio nie dotarło do mostu realtime. `interruptedPlayback=true` oznacza, że ta tura wejściowa nakładała się na wyjście asystenta i uruchomiła logikę wtrącenia. Przydatne pola: - `outputAudioMs`: czas trwania dźwięku asystenta wygenerowanego przez dostawcę realtime przed wierszem logu. - `audioMs`: czas trwania dźwięku asystenta, który OpenClaw zliczył przed zatrzymaniem odtwarzania. - `elapsedMs`: czas zegarowy między otwarciem a zamknięciem strumienia odtwarzania lub tury mówcy. - `discordBytes`: bajty stereo PCM 48 kHz wysłane do lub odebrane z głosu Discord. - `realtimeBytes`: bajty PCM w formacie dostawcy wysłane do lub odebrane od dostawcy realtime. - `playbackChunks`: fragmenty dźwięku asystenta przekazane do Discord dla aktywnej odpowiedzi. - `sinceLastAudioMs`: odstęp między ostatnią przechwyconą klatką audio mówcy a zamknięciem tury mówcy. Typowe wzorce: - Natychmiastowe ucięcie z `source=active-speaker-audio`, małym `outputAudioMs` i tym samym użytkownikiem w pobliżu zwykle wskazuje na echo głośnika trafiające do mikrofonu. Zwiększ `voice.realtime.minBargeInAudioEndMs`, zmniejsz głośność głośnika, użyj słuchawek albo ustaw `voice.realtime.providers.openai.interruptResponseOnInputAudio: false`. - `source=speaker-start`, po którym następuje `speaker turn closed ... hasAudio=false`, oznacza, że Discord zgłosił rozpoczęcie mówienia, ale żadne audio nie dotarło do OpenClaw. Może to być przejściowe zdarzenie głosowe Discord, zachowanie bramki szumów lub krótkie aktywowanie mikrofonu przez klienta. - `audio playback stopped reason=stream-close` bez pobliskiego wtrącenia lub `provider-clear-audio` oznacza, że lokalny strumień odtwarzania Discord zakończył się nieoczekiwanie. Sprawdź poprzedzające logi dostawcy i odtwarzacza Discord. - `capture ignored during playback (barge-in disabled)` oznacza, że OpenClaw celowo odrzucił wejście, gdy dźwięk asystenta był aktywny. Włącz `voice.realtime.bargeIn`, jeśli chcesz, aby mowa przerywała odtwarzanie. - `barge-in ignored ... outputActive=false` oznacza, że Discord lub VAD dostawcy zgłosił mowę, ale OpenClaw nie miał aktywnego odtwarzania do przerwania. Nie powinno to ucinać dźwięku. Poświadczenia są rozwiązywane osobno dla każdego komponentu: uwierzytelnianie trasy LLM dla `voice.model`, uwierzytelnianie STT dla `tools.media.audio`, uwierzytelnianie TTS dla `messages.tts`/`voice.tts` oraz uwierzytelnianie dostawcy realtime dla `voice.realtime.providers` lub normalnej konfiguracji uwierzytelniania dostawcy. ### Wiadomości głosowe Wiadomości głosowe Discord pokazują podgląd fali dźwiękowej i wymagają dźwięku OGG/Opus. OpenClaw generuje falę automatycznie, ale potrzebuje `ffmpeg` i `ffprobe` na hoście Gateway, aby sprawdzać i konwertować. - Podaj **lokalną ścieżkę pliku** (adresy URL są odrzucane). - Pomiń treść tekstową (Discord odrzuca tekst + wiadomość głosową w tym samym ładunku). - Akceptowany jest dowolny format audio; OpenClaw konwertuje go na OGG/Opus w razie potrzeby. ```bash message(action="send", channel="discord", target="channel:123", path="/path/to/audio.mp3", asVoice=true) ``` ## Rozwiązywanie problemów - włącz Message Content Intent - włącz Server Members Intent, gdy zależysz od rozpoznawania użytkownika/członka - zrestartuj gateway po zmianie intentów - sprawdź `groupPolicy` - sprawdź listę dozwolonych guild w `channels.discord.guilds` - jeśli istnieje mapa `channels` dla guild, dozwolone są tylko wymienione kanały - sprawdź zachowanie `requireMention` i wzorce wzmianek Przydatne sprawdzenia: ```bash openclaw doctor openclaw channels status --probe openclaw logs --follow ``` Typowe przyczyny: - `groupPolicy="allowlist"` bez pasującej listy dozwolonych guild/kanałów - `requireMention` skonfigurowane w niewłaściwym miejscu (musi być pod `channels.discord.guilds` albo we wpisie kanału) - nadawca zablokowany przez listę dozwolonych `users` guild/kanału Typowe logi: - `Slow listener detected ...` - `stuck session: sessionKey=agent:...:discord:... state=processing ...` Ustawienia kolejki Discord gateway: - jedno konto: `channels.discord.eventQueue.listenerTimeout` - wiele kont: `channels.discord.accounts..eventQueue.listenerTimeout` - kontroluje to tylko pracę listenera Discord gateway, a nie czas trwania tury agenta Discord nie stosuje limitu czasu należącego do kanału do kolejkowanych tur agenta. Listenery wiadomości przekazują pracę natychmiast, a kolejkowane uruchomienia Discord zachowują kolejność w obrębie sesji, dopóki cykl życia sesji/narzędzia/runtime nie zakończy albo nie przerwie pracy. ```json5 { channels: { discord: { accounts: { default: { eventQueue: { listenerTimeout: 120000, }, }, }, }, }, } ``` OpenClaw pobiera metadane Discord `/gateway/bot` przed połączeniem. Przejściowe błędy wracają do domyślnego adresu URL gateway Discord i są limitowane w logach. Ustawienia limitu czasu metadanych: - jedno konto: `channels.discord.gatewayInfoTimeoutMs` - wiele kont: `channels.discord.accounts..gatewayInfoTimeoutMs` - rezerwowa zmienna środowiskowa, gdy konfiguracja nie jest ustawiona: `OPENCLAW_DISCORD_GATEWAY_INFO_TIMEOUT_MS` - domyślnie: `30000` (30 sekund), maks.: `120000` OpenClaw czeka na zdarzenie `READY` Discord gateway podczas uruchamiania i po ponownych połączeniach runtime. Konfiguracje z wieloma kontami i rozłożonym uruchamianiem mogą wymagać dłuższego okna READY przy starcie niż domyślne. Ustawienia limitu czasu READY: - start, jedno konto: `channels.discord.gatewayReadyTimeoutMs` - start, wiele kont: `channels.discord.accounts..gatewayReadyTimeoutMs` - rezerwowa zmienna środowiskowa dla startu, gdy konfiguracja nie jest ustawiona: `OPENCLAW_DISCORD_READY_TIMEOUT_MS` - domyślnie dla startu: `15000` (15 sekund), maks.: `120000` - runtime, jedno konto: `channels.discord.gatewayRuntimeReadyTimeoutMs` - runtime, wiele kont: `channels.discord.accounts..gatewayRuntimeReadyTimeoutMs` - rezerwowa zmienna środowiskowa dla runtime, gdy konfiguracja nie jest ustawiona: `OPENCLAW_DISCORD_RUNTIME_READY_TIMEOUT_MS` - domyślnie dla runtime: `30000` (30 sekund), maks.: `120000` Sprawdzanie uprawnień przez `channels status --probe` działa tylko dla numerycznych identyfikatorów kanałów. Jeśli używasz kluczy typu slug, dopasowanie w czasie działania nadal może działać, ale probe nie może w pełni zweryfikować uprawnień. - DM wyłączone: `channels.discord.dm.enabled=false` - zasady DM wyłączone: `channels.discord.dmPolicy="disabled"` (starsze: `channels.discord.dm.policy`) - oczekiwanie na zatwierdzenie parowania w trybie `pairing` Domyślnie wiadomości tworzone przez boty są ignorowane. Jeśli ustawisz `channels.discord.allowBots=true`, użyj ścisłych reguł wzmianek i listy dozwolonych, aby uniknąć pętli. Preferuj `channels.discord.allowBots="mentions"`, aby akceptować tylko wiadomości botów, które wspominają bota. OpenClaw dostarcza także współdzieloną [ochronę przed pętlami botów](/pl/channels/bot-loop-protection). Gdy `allowBots` pozwala wiadomościom tworzonym przez boty trafić do dispatch, Discord mapuje zdarzenie przychodzące na fakty `(account, channel, bot pair)`, a generyczna osłona pary tłumi tę parę po przekroczeniu skonfigurowanego budżetu zdarzeń. Osłona zapobiega niekontrolowanym pętlom dwóch botów, które wcześniej musiały być zatrzymywane przez limity szybkości Discord; nie wpływa na wdrożenia z jednym botem ani jednorazowe odpowiedzi botów mieszczące się w budżecie. Ustawienia domyślne (aktywne, gdy ustawiono `allowBots`): - `maxEventsPerWindow: 20` -- para botów może wymienić 20 wiadomości w oknie kroczącym - `windowSeconds: 60` -- długość okna kroczącego - `cooldownSeconds: 60` -- po przekroczeniu budżetu każda dodatkowa wiadomość bot-bot w dowolnym kierunku jest odrzucana przez jedną minutę Skonfiguruj współdzieloną wartość domyślną raz w `channels.defaults.botLoopProtection`, a następnie nadpisz Discord, gdy prawidłowy przepływ pracy potrzebuje większego marginesu. Pierwszeństwo jest następujące: - `channels.discord.accounts..botLoopProtection` - `channels.discord.botLoopProtection` - `channels.defaults.botLoopProtection` - wbudowane wartości domyślne Discord używa generycznych kluczy `maxEventsPerWindow`, `windowSeconds` i `cooldownSeconds`. ```json5 { channels: { defaults: { botLoopProtection: { maxEventsPerWindow: 20, windowSeconds: 60, cooldownSeconds: 60, }, }, discord: { // Optional Discord-wide override. Account blocks override individual // fields and inherit omitted fields from here. botLoopProtection: { maxEventsPerWindow: 4, }, accounts: { mantis: { // Mantis listens to other bots only when they mention her. allowBots: "mentions", }, molty: { // Molty listens to all bot-authored Discord messages. allowBots: true, mentionAliases: { // Lets Molty write a Mantis Discord mention with the configured user id. Mantis: "MANTIS_DISCORD_USER_ID", }, botLoopProtection: { // Allow up to five messages per minute before suppressing the pair. maxEventsPerWindow: 5, windowSeconds: 60, cooldownSeconds: 90, }, }, }, }, }, } ``` - utrzymuj OpenClaw w aktualnej wersji (`openclaw update`), aby była dostępna logika odzyskiwania odbioru głosu Discord - potwierdź `channels.discord.voice.daveEncryption=true` (domyślnie) - zacznij od `channels.discord.voice.decryptionFailureTolerance=24` (domyślna wartość upstream) i dostrajaj tylko w razie potrzeby - obserwuj logi pod kątem: - `discord voice: DAVE decrypt failures detected` - `discord voice: repeated decrypt failures; attempting rejoin` - jeśli błędy nadal występują po automatycznym ponownym dołączeniu, zbierz logi i porównaj je z historią odbioru DAVE upstream w [discord.js #11419](https://github.com/discordjs/discord.js/issues/11419) oraz [discord.js #11449](https://github.com/discordjs/discord.js/pull/11449) ## Dokumentacja konfiguracji Główne odniesienie: [Dokumentacja konfiguracji - Discord](/pl/gateway/config-channels#discord). - uruchamianie/uwierzytelnianie: `enabled`, `token`, `accounts.*`, `allowBots` - zasady: `groupPolicy`, `dm.*`, `guilds.*`, `guilds.*.channels.*` - polecenia: `commands.native`, `commands.useAccessGroups`, `configWrites`, `slashCommand.*` - kolejka zdarzeń: `eventQueue.listenerTimeout` (budżet listenera), `eventQueue.maxQueueSize`, `eventQueue.maxConcurrency` - gateway: `gatewayInfoTimeoutMs`, `gatewayReadyTimeoutMs`, `gatewayRuntimeReadyTimeoutMs` - odpowiedzi/historia: `replyToMode`, `historyLimit`, `dmHistoryLimit`, `dms.*.historyLimit` - dostarczanie: `textChunkLimit`, `chunkMode`, `maxLinesPerMessage` - strumieniowanie: `streaming` (starszy alias: `streamMode`), `streaming.preview.toolProgress`, `draftChunk`, `blockStreaming`, `blockStreamingCoalesce` - media/ponawianie: `mediaMaxMb` (ogranicza wychodzące przesyłanie plików Discord, domyślnie `100MB`), `retry` - akcje: `actions.*` - obecność: `activity`, `status`, `activityType`, `activityUrl` - UI: `ui.components.accentColor` - funkcje: `threadBindings`, najwyższego poziomu `bindings[]` (`type: "acp"`), `pluralkit`, `execApprovals`, `intents`, `agentComponents.enabled`, `agentComponents.ttlMs`, `heartbeat`, `responsePrefix` ## Bezpieczeństwo i operacje - Traktuj tokeny botów jako sekrety (`DISCORD_BOT_TOKEN` preferowane w nadzorowanych środowiskach). - Przyznawaj uprawnienia Discord zgodnie z zasadą najmniejszych uprawnień. - Jeśli wdrożenie poleceń lub stan są nieaktualne, uruchom ponownie gateway i sprawdź ponownie za pomocą `openclaw channels status --probe`. ## Powiązane Sparuj użytkownika Discord z bramą. Czat grupowy i działanie listy dozwolonych. Kieruj wiadomości przychodzące do agentów. Model zagrożeń i utwardzanie. Mapuj serwery i kanały na agentów. Zachowanie natywnych poleceń.