Discord

OpenClaw łączy się z Discordem jako bot za pośrednictwem oficjalnego Gateway Discorda. Obsługiwane są wiadomości prywatne i kanały serwerów.

Szybka konfiguracja

Utwórz aplikację Discorda z botem, dodaj bota do swojego serwera i sparuj go z OpenClaw. Jeśli możesz, użyj prywatnego serwera; w razie potrzeby najpierw utwórz serwer (Create My Own > For me and my friends).

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" },},},}JSON5openclaw config patch --file ./discord.patch.json5 --dry-runopenclaw config patch --file ./discord.patch.json5openclaw gateway

{channels: {discord: {enabled: true,token: {source: "env",provider: "default",id: "DISCORD_BOT_TOKEN",},},},}

DISCORD_BOT_TOKEN=...

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

openclaw pairing list discordopenclaw pairing approve discord <CODE>

Zalecane: skonfiguruj przestrzeń roboczą serwera

Gdy wiadomości prywatne już działają, możesz przekształcić serwer w pełną przestrzeń roboczą, w której każdy kanał otrzymuje własną sesję agenta z własnym kontekstem. Jest to zalecane w przypadku prywatnych serwerów, na których znajdujesz się tylko Ty i Twój bot.

{channels: {discord: {groupPolicy: "allowlist",guilds: {YOUR_SERVER_ID: {  requireMention: true,  users: ["YOUR_USER_ID"],},},},},}

{channels: {discord: {guilds: {YOUR_SERVER_ID: {  requireMention: false,},},},},}

Teraz utwórz kanały i zacznij rozmawiać. Agent widzi nazwę kanału, a każdy kanał jest odizolowaną sesją — skonfiguruj #coding, #home, #research lub dowolne inne kanały pasujące do Twojego sposobu pracy.

Model środowiska wykonawczego

• Gateway zarządza połączeniem z Discordem.
• Kierowanie odpowiedzi jest deterministyczne: odpowiedzi na wiadomości przychodzące z Discorda wracają do Discorda.
• Metadane serwera i kanału Discorda są dodawane do monitu modelu jako niezaufany kontekst, a nie jako widoczny dla użytkownika prefiks odpowiedzi. Jeśli model skopiuje tę otoczkę do odpowiedzi, OpenClaw usunie skopiowane metadane z odpowiedzi wychodzących i z kontekstu przyszłych powtórzeń.
• Domyślnie (session.dmScope=main) bezpośrednie rozmowy współdzielą główną sesję agenta (agent:main:main).
• Kanały serwera mają odizolowane klucze sesji (agent:<agentId>:discord:channel:<channelId>).
• Grupowe wiadomości prywatne są domyślnie ignorowane (channels.discord.dm.groupEnabled=false).
• Natywne polecenia z ukośnikiem działają w odizolowanych sesjach poleceń (agent:<agentId>:discord:slash:<userId>), zachowując jednocześnie CommandTargetSessionKey prowadzący do sesji docelowej rozmowy.
• Dostarczanie do Discorda tekstowych ogłoszeń Cron/Heartbeat jest sprowadzane do końcowej odpowiedzi asystenta widocznej dla użytkownika i wysyłane jednokrotnie. Ładunki multimedialne i ładunki komponentów strukturalnych pozostają wielowiadomościowe, gdy agent generuje wiele ładunków przeznaczonych do dostarczenia.

Kanały forum

Kanały forum i kanały multimedialne Discorda akceptują wyłącznie posty w wątkach. OpenClaw obsługuje dwa sposoby ich tworzenia:

• Wyślij wiadomość do kanału nadrzędnego forum (channel:<forumId>), aby automatycznie utworzyć wątek. Tytułem wątku będzie pierwszy niepusty wiersz wiadomości (skrócony do obowiązującego w Discord limitu 100 znaków dla nazwy wątku).
• Użyj openclaw message thread create, aby utworzyć wątek bezpośrednio. W przypadku kanałów forum nie przekazuj --message-id.

Wyślij wiadomość do kanału nadrzędnego forum, aby utworzyć wątek:

openclaw message send --channel discord --target channel:<forumId> \  --message "Topic title\nBody of the post"

Utwórz wątek forum jawnie:

openclaw message thread create --channel discord --target channel:<forumId> \  --thread-name "Topic title" --message "Body of the post"

Kanały nadrzędne forum nie obsługują komponentów Discord. Jeśli potrzebujesz komponentów, wyślij wiadomość do samego wątku (channel:<threadId>).

Komponenty interaktywne

OpenClaw obsługuje kontenery komponentów Discord v2 w wiadomościach agenta. Użyj narzędzia do wiadomości z ładunkiem components. Wyniki interakcji są przekazywane z powrotem do agenta jako zwykłe wiadomości przychodzące i podlegają istniejącym ustawieniom Discord replyToMode.

Obsługiwane bloki:

• text, section, separator, actions, media-gallery, file
• Wiersze akcji mogą zawierać maksymalnie 5 przycisków albo jedno menu wyboru
• Typy wyboru: string, user, role, mentionable, channel

Domyślnie komponentów można użyć tylko raz. Ustaw components.reusable=true, aby umożliwić wielokrotne używanie przycisków, pól wyboru i formularzy aż do ich wygaśnięcia.

Aby ograniczyć grono osób, które mogą kliknąć przycisk, ustaw dla niego allowedUsers (identyfikatory użytkowników Discord, znaczniki lub *). Niedopasowani użytkownicy otrzymają tymczasową odmowę widoczną tylko dla nich.

Wywołania zwrotne komponentów domyślnie wygasają po 30 minutach. Ustaw channels.discord.agentComponents.ttlMs, aby zmienić czas przechowywania rejestru wywołań zwrotnych dla konta domyślnego, albo channels.discord.accounts.<accountId>.agentComponents.ttlMs dla poszczególnych kont. Wartość jest podawana w milisekundach, musi być dodatnią liczbą całkowitą i nie może przekraczać 86400000 (24 godzin). Dłuższy czas TTL sprawdza się w przepływach przeglądu i zatwierdzania, w których przyciski muszą pozostawać aktywne, ale wydłuża okres, w którym stara wiadomość Discord może nadal wywołać akcję. Wybierz najkrótszy odpowiedni czas TTL i zachowaj wartość domyślną, jeśli nieaktualne wywołania zwrotne mogłyby być zaskakujące.

Polecenia ukośnikowe /model i /models otwierają interaktywny selektor modelu z listami rozwijanymi dostawcy, modelu i zgodnego środowiska wykonawczego oraz etapem Submit. Polecenie /models add jest przestarzałe i zamiast rejestrować modele z poziomu czatu zwraca komunikat o wycofaniu. Odpowiedź selektora jest tymczasowa, widoczna tylko dla użytkownika, który go wywołał, i tylko on może z niej korzystać. Menu wyboru Discord są ograniczone do 25 opcji, dlatego dodaj wpisy provider/* do agents.defaults.models, jeśli selektor ma wyświetlać dynamicznie wykryte modele tylko dla wybranych dostawców, takich jak openai lub vllm.

Załączniki:

• Bloki file muszą wskazywać odwołanie do załącznika (attachment://<filename>)
• Przekaż załącznik przez media/path/filePath (pojedynczy plik); w przypadku wielu plików użyj media-gallery
• Użyj filename, aby zastąpić nazwę przesyłanego pliku, gdy powinna odpowiadać odwołaniu do załącznika

Formularze modalne:

• Dodaj components.modal zawierający maksymalnie 5 pól
• Typy pól: text, checkbox, radio, select, role-select, user-select
• OpenClaw automatycznie dodaje przycisk wyzwalający

Przykład:

{  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 trasowanie

{accessGroups: {operators: {  type: "message.senders",  members: {    "*": ["global-owner-id"],    discord: ["discord:123456789012345678"],    telegram: ["987654321"],  },},},channels: {discord: {  dmPolicy: "allowlist",  allowFrom: ["accessGroup:operators"],},},}

{accessGroups: {maintainers: {  type: "discord.channelAudience",  guildId: "1456350064065904867",  channelId: "1456744319972282449",  membership: "canViewChannel",},},channels: {discord: {  dmPolicy: "allowlist",  allowFrom: ["accessGroup:maintainers"],},},}

{accessGroups: {maintainers: {  type: "discord.channelAudience",  guildId: "1456350064065904867",  channelId: "1456744319972282449",},},channels: {discord: {  dmPolicy: "allowlist",  allowFrom: ["accessGroup:maintainers", "discord:123456789012345678"],},},}

{channels: {discord: {  groupPolicy: "allowlist",  guilds: {    "123456789012345678": {      requireMention: true,      ignoreOtherMentions: true,      users: ["987654321098765432"],      roles: ["123456789012345678"],      channels: {        general: { enabled: true },        help: { enabled: true, requireMention: true },      },    },  },},},}

Trasowanie agentów na podstawie ról

Użyj bindings[].match.roles, aby trasować członków serwera Discord do różnych agentów na podstawie identyfikatora roli. Powiązania oparte na rolach przyjmują wyłącznie identyfikatory ról i są oceniane po powiązaniach uczestnika lub uczestnika nadrzędnego, a przed powiązaniami dotyczącymi wyłącznie serwera. Jeśli powiązanie ustawia również inne pola dopasowania (na przykład peer + guildId + roles), wszystkie skonfigurowane pola muszą być zgodne.

{  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 poszczególnych kanałów: channels.discord.commands.native.
• commands.native=false pomija rejestrowanie poleceń ukośnikowych Discord oraz ich czyszczenie podczas uruchamiania. Wcześniej zarejestrowane polecenia mogą pozostać widoczne w Discord, dopóki nie usuniesz ich z aplikacji Discord.
• Uwierzytelnianie poleceń natywnych korzysta z tych samych list dozwolonych i zasad Discord co zwykła obsługa wiadomości.
• Polecenia mogą nadal być widoczne w interfejsie Discord dla nieuprawnionych użytkowników; podczas wykonywania OpenClaw wymusza uwierzytelnienie i odpowiada „brak autoryzacji”.
• Domyślne ustawienia poleceń ukośnikowych: ephemeral: true (channels.discord.slashCommand.ephemeral).

Katalog poleceń i opis ich działania zawiera strona Polecenia ukośnikowe.

Szczegóły funkcji

{channels: {discord: {  suppressEmbeds: false,},},}

{channels: {discord: {  streaming: {    mode: "progress",    progress: {      label: "auto",      maxLines: 8,      maxLineChars: 120,      toolProgress: true,      commentary: false,    },  },},},}

{  "channels": {    "discord": {      "streaming": {        "mode": "progress",        "progress": {          "toolProgress": true,          "commandText": "status"        }      }    }  }}

{session: {threadBindings: {  enabled: true,  idleHours: 24,  maxAgeHours: 0,},},channels: {discord: {  threadBindings: {    enabled: true,    idleHours: 24,    maxAgeHours: 0,    spawnSessions: true,    defaultSpawnContext: "fork",  },},},}

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

{channels: {discord: {  configWrites: false,},},}

{channels: {discord: {  proxy: "http://proxy.example:8080",},},}

{channels: {discord: {  accounts: {    primary: {      proxy: "http://proxy.example:8080",    },  },},},}

{channels: {discord: {  pluralkit: {    enabled: true,    token: "pk_live_...", // opcjonalne; wymagane w systemach prywatnych  },},},}

{channels: {discord: {  mentionAliases: {    SupportLead: "123456789012345678",  },  accounts: {    ops: {      mentionAliases: {        OpsLead: "234567890123456789",      },    },  },},},}

{channels: {discord: {  status: "idle",},},}

{channels: {discord: {  activity: "Czas na skupienie",  activityType: 4,},},}

{channels: {discord: {  activity: "Programowanie na żywo",  activityType: 1,  activityUrl: "https://twitch.tv/openclaw",},},}

{channels: {discord: {  autoPresence: {    enabled: true,    intervalMs: 30000,    minUpdateIntervalMs: 15000,    exhaustedText: "token wyczerpany",  },},},}

Narzędzia i blokady działań

Działania na wiadomościach Discorda obejmują obsługę wiadomości, administrację kanałami, moderację, obecność i metadane.

Podstawowe przykłady:

• obsługa wiadomości: sendMessage, readMessages, editMessage, deleteMessage, threadReply
• reakcje: react, reactions, emojiList
• moderacja: timeout, kick, ban
• obecność: setPresence

Działanie event-create przyjmuje opcjonalny parametr image (adres URL lub ścieżkę do pliku lokalnego), służący do ustawienia obrazu okładki zaplanowanego wydarzenia.

Blokady działań znajdują się w channels.discord.actions.*.

Domyślne działanie blokad:

Interfejs komponentów v2

OpenClaw używa komponentów Discorda v2 do zatwierdzania wykonania i znaczników międzykontekstowych. Działania na wiadomościach Discorda mogą również przyjmować components do tworzenia niestandardowego interfejsu (funkcja zaawansowana; wymaga skonstruowania ładunku komponentu za pomocą narzędzia Discorda), natomiast starsze embeds pozostają dostępne, ale nie są zalecane.

• channels.discord.ui.components.accentColor ustawia kolor akcentu używany przez kontenery komponentów Discorda (wartość szesnastkowa). Dla poszczególnych kont: channels.discord.accounts.<id>.ui.components.accentColor.
• channels.discord.agentComponents.ttlMs określa, jak długo wywołania zwrotne wysłanych komponentów Discorda pozostają zarejestrowane (domyślnie 1800000, maksymalnie 86400000). Dla poszczególnych kont: channels.discord.accounts.<id>.agentComponents.ttlMs.
• embeds są ignorowane, gdy obecne są komponenty v2.
• Podglądy zwykłych adresów URL są domyślnie wyłączone. Ustaw suppressEmbeds: false w działaniu na wiadomości, jeśli pojedynczy link wychodzący ma zostać rozwinięty.

Przykład:

{  channels: {    discord: {      ui: {        components: {          accentColor: "#5865F2",        },      },    },  },}

Głos

Discord udostępnia dwa odrębne mechanizmy głosowe: działające w czasie rzeczywistym kanały głosowe (ciągłe rozmowy) oraz załączniki wiadomości głosowych (format podglądu przebiegu fali). 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 lub użytkowników.
3. Zaproś bota z zakresami bot i applications.commands.
4. Przyznaj uprawnienia Connect, Speak, Send Messages i Read Message History w docelowym kanale głosowym.
5. Włącz polecenia natywne (commands.native lub channels.discord.commands.native).
6. Skonfiguruj channels.discord.voice.

Do sterowania sesjami używaj /vc join|leave|status. Polecenie używa domyślnego agenta konta i podlega tym samym regułom list dozwolonych elementów oraz zasadom grupowym co inne polecenia Discorda.

/vc join channel:<voice-channel-id>/vc status/vc leave

Aby przed dołączeniem sprawdzić efektywne uprawnienia bota:

openclaw channels capabilities --channel discord --target channel:<voice-channel-id>

Przykład automatycznego dołączania:

{  channels: {    discord: {      voice: {        enabled: true,        model: "openai/gpt-5.6-sol",        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.1",          speakerVoice: "cedar",        },      },    },  },}

Uwagi:

• Obsługa głosu w Discordzie jest opcjonalna w konfiguracjach obejmujących wyłącznie tekst; ustaw channels.discord.voice.enabled=true (lub zachowaj istniejący blok channels.discord.voice), aby włączyć polecenia /vc, środowisko wykonawcze głosu oraz intencję Gateway GuildVoiceStates. channels.discord.intents.voiceStates może jawnie nadpisać subskrypcję intencji; pozostaw tę opcję nieustawioną, aby była zgodna z faktycznym stanem włączenia obsługi głosu.
• voice.mode steruje przebiegiem konwersacji. Domyślną wartością jest agent-proxy: interfejs głosowy działający w czasie rzeczywistym obsługuje synchronizację tur, przerywanie i odtwarzanie, przekazuje merytoryczne zadania do wyznaczonego agenta OpenClaw za pośrednictwem openclaw_agent_consult i traktuje wynik jak tekstowy monit Discorda od danego mówcy. stt-tts zachowuje starszy przepływ wsadowego STT i TTS. bidi pozwala modelowi czasu rzeczywistego prowadzić rozmowę bezpośrednio, udostępniając jednocześnie openclaw_agent_consult jako mechanizm dostępu do głównej logiki OpenClaw.
• voice.agentSession określa, która konwersacja OpenClaw otrzymuje tury głosowe. Pozostaw tę opcję nieustawioną, aby używać własnej sesji kanału głosowego, albo ustaw { mode: "target", target: "channel:<text-channel-id>" }, aby kanał głosowy działał jako rozszerzenie mikrofonu i głośnika istniejącej sesji kanału tekstowego Discorda, takiego jak #maintainers.
• voice.model nadpisuje model głównej logiki agenta OpenClaw używany do odpowiedzi głosowych w Discordzie i konsultacji w czasie rzeczywistym. Pozostaw tę opcję nieustawioną, aby dziedziczyć model wyznaczonego agenta. Jest ona niezależna od voice.realtime.model.
• voice.followUsers umożliwia botowi dołączanie do kanału głosowego Discorda, przenoszenie się między kanałami i opuszczanie ich wraz z wybranymi użytkownikami. Zobacz Podążanie za użytkownikami na kanałach głosowych.
• agent-proxy kieruje mowę przez discord-voice, który zachowuje standardową autoryzację właściciela i narzędzi dla mówcy oraz sesji docelowej, ale ukrywa narzędzie agenta tts, ponieważ odtwarzaniem zarządza obsługa głosu Discorda. Domyślnie agent-proxy zapewnia konsultacji pełny dostęp do narzędzi równoważny właścicielowi w przypadku mówców będących właścicielami (voice.realtime.toolPolicy: "owner") i zdecydowanie preferuje konsultację z agentem OpenClaw przed udzieleniem merytorycznych odpowiedzi (voice.realtime.consultPolicy: "always"). W domyślnym trybie always warstwa czasu rzeczywistego nie wypowiada automatycznie wypełniaczy przed odpowiedzią z konsultacji; przechwytuje i transkrybuje mowę, a następnie wypowiada odpowiedź wyznaczonego agenta OpenClaw. Jeśli kilka wymuszonych odpowiedzi z konsultacji zostanie ukończonych, gdy Discord nadal odtwarza pierwszą odpowiedź, kolejne odpowiedzi przeznaczone do dokładnego wypowiedzenia są umieszczane w kolejce do czasu zakończenia odtwarzania zamiast zastępować wypowiedź w połowie zdania.
• W trybie stt-tts funkcja STT używa tools.media.audio; voice.model nie wpływa na transkrypcję.
• W trybach czasu rzeczywistego ustawienia voice.realtime.provider, voice.realtime.model i voice.realtime.speakerVoice konfigurują sesję audio czasu rzeczywistego. Aby użyć OpenAI Realtime 2.1 wraz z główną logiką Codex, ustaw voice.realtime.model: "gpt-realtime-2.1" i voice.model: "openai/gpt-5.6-sol".
• Tryby głosowe czasu rzeczywistego domyślnie dołączają małe pliki profilu IDENTITY.md, USER.md i SOUL.md do instrukcji dostawcy czasu rzeczywistego, dzięki czemu szybkie bezpośrednie tury zachowują tę samą tożsamość, kontekst użytkownika i osobowość co wyznaczony agent OpenClaw. Ustaw voice.realtime.bootstrapContextFiles na podzbiór, aby to dostosować, albo na [], aby wyłączyć tę funkcję. Obsługiwane są wyłącznie te pliki profilu; AGENTS.md pozostaje w standardowym kontekście agenta. Wstrzyknięty kontekst profilu nie zastępuje openclaw_agent_consult w przypadku pracy w obszarze roboczym, aktualnych informacji, wyszukiwania w pamięci ani działań wspieranych przez narzędzia.
• W trybie czasu rzeczywistego OpenAI agent-proxy ustaw voice.realtime.requireWakeName: true, aby obsługa głosu Discorda w czasie rzeczywistym pozostawała wyciszona, dopóki transkrypcja nie rozpocznie się lub nie zakończy nazwą wybudzającą. Skonfigurowane nazwy wybudzające muszą składać się z jednego lub dwóch słów. Jeśli voice.realtime.wakeNames nie jest ustawione, OpenClaw używa name wyznaczonego agenta oraz OpenClaw, a w razie braku tej wartości — identyfikatora agenta oraz OpenClaw. Bramkowanie nazwą wybudzającą wyłącza automatyczne odpowiedzi dostawcy czasu rzeczywistego, kieruje zaakceptowane tury przez ścieżkę konsultacji z agentem OpenClaw i odtwarza krótkie potwierdzenie głosowe, gdy początkowa nazwa wybudzająca zostanie rozpoznana na podstawie częściowej transkrypcji przed nadejściem transkrypcji końcowej.
• Dostawca czasu rzeczywistego OpenAI akceptuje aktualne nazwy zdarzeń Realtime 2 oraz starsze aliasy zgodne z Codex dla zdarzeń dźwięku wyjściowego i transkrypcji, dzięki czemu zgodne migawki dostawcy mogą się zmieniać bez utraty dźwięku asystenta.
• voice.realtime.bargeIn określa, czy zdarzenia rozpoczęcia mówienia w Discordzie przerywają aktywne odtwarzanie w czasie rzeczywistym. Jeśli ta opcja nie jest ustawiona, podąża za ustawieniem dostawcy czasu rzeczywistego dotyczącym przerywania przez dźwięk wejściowy.
• voice.realtime.minBargeInAudioEndMs określa minimalny czas odtwarzania odpowiedzi asystenta, zanim przerwanie w czasie rzeczywistym OpenAI skróci dźwięk. Wartość domyślna: 250. Ustaw 0, aby umożliwić natychmiastowe przerwanie w pomieszczeniach o niewielkim pogłosie, albo zwiększ tę wartość w konfiguracjach głośnikowych z dużym pogłosem.
• voice.tts nadpisuje messages.tts wyłącznie dla odtwarzania głosowego w trybie stt-tts; tryby czasu rzeczywistego używają zamiast tego voice.realtime.speakerVoice. Aby używać głosu OpenAI podczas odtwarzania w Discordzie, ustaw voice.tts.provider: "openai" i wybierz głos zamiany tekstu na mowę w voice.tts.providers.openai.speakerVoice. cedar jest dobrym wyborem o męskim brzmieniu w aktualnym modelu TTS OpenAI.
• Nadpisania systemPrompt dla poszczególnych kanałów Discorda mają zastosowanie do tur transkrypcji głosowej na danym kanale głosowym.
• Tury transkrypcji głosowej ustalają status właściciela na podstawie allowFrom Discorda (lub dm.allowFrom) na potrzeby poleceń i działań kanału ograniczonych do właściciela. Widoczność narzędzi agenta jest zgodna ze skonfigurowaną polityką narzędzi dla wyznaczonej sesji.
• Jeśli voice.autoJoin zawiera wiele wpisów dla tej samej gildii, OpenClaw dołącza do ostatniego skonfigurowanego kanału tej gildii.
• voice.allowedChannels jest opcjonalną listą dozwolonych kanałów przebywania. Pozostaw tę opcję nieustawioną, aby zezwolić poleceniu /vc join na dołączanie do dowolnego autoryzowanego kanału głosowego Discorda. Gdy jest ustawiona, /vc join, automatyczne dołączanie przy uruchomieniu i przeniesienia wynikające ze stanu głosowego bota są ograniczone do wymienionych wpisów { guildId, channelId }. Ustaw pustą tablicę, aby zabronić dołączania do wszystkich kanałów głosowych Discorda. Jeśli Discord przeniesie bota poza listę dozwolonych kanałów, OpenClaw opuści ten kanał i ponownie dołączy do skonfigurowanego docelowego kanału automatycznego dołączania, jeśli taki jest dostępny.
• voice.daveEncryption i voice.decryptionFailureTolerance są przekazywane do opcji dołączania @discordjs/voice; domyślne wartości biblioteki nadrzędnej to daveEncryption=true i decryptionFailureTolerance=24.
• OpenClaw używa dołączonego kodeka libopus-wasm do odbierania głosu z Discorda i odtwarzania surowego PCM w czasie rzeczywistym. Pakiet zawiera przypiętą wersję libopus w WebAssembly i nie wymaga natywnych dodatków opus.
• voice.connectTimeoutMs określa początkowy czas oczekiwania na stan Ready z @discordjs/voice dla polecenia /vc join i prób automatycznego dołączenia. Wartość domyślna: 30000.
• voice.reconnectGraceMs określa, jak długo OpenClaw czeka, aż rozłączona sesja głosowa rozpocznie ponowne łączenie, zanim ją zniszczy. Wartość domyślna: 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; zacznij mówić po zakończeniu odtwarzania, aby rozpocząć następną turę. Tryby czasu rzeczywistego przekazują rozpoczęcie mówienia jako sygnał przerwania do dostawcy czasu rzeczywistego.
• W trybach czasu rzeczywistego echo z głośników trafiające do otwartego mikrofonu może wyglądać jak przerwanie i zatrzymywać odtwarzanie. W pomieszczeniach Discorda z dużym pogłosem ustaw voice.realtime.providers.openai.interruptResponseOnInputAudio: false, aby OpenAI nie przerywało automatycznie odpowiedzi po wykryciu dźwięku wejściowego. Dodaj voice.realtime.bargeIn: true, jeśli nadal chcesz, aby zdarzenia rozpoczęcia mówienia w Discordzie przerywały aktywne odtwarzanie. Most czasu rzeczywistego OpenAI ignoruje skrócenia odtwarzania krótsze niż voice.realtime.minBargeInAudioEndMs, uznając je za prawdopodobne echo lub szum, i rejestruje je jako pominięte zamiast czyścić odtwarzanie Discorda.
• voice.captureSilenceGraceMs określa, jak długo OpenClaw czeka po zgłoszeniu przez Discorda, że mówca przestał mówić, zanim sfinalizuje ten segment dźwięku na potrzeby STT. Wartość domyślna: 2000; zwiększ ją, jeśli Discord dzieli zwykłe pauzy na poszarpane częściowe transkrypcje.
• Gdy wybranym dostawcą TTS jest ElevenLabs, odtwarzanie głosu w Discordzie używa strumieniowego TTS i rozpoczyna się od strumienia odpowiedzi dostawcy. W przypadku dostawców bez obsługi przesyłania strumieniowego stosowana jest ścieżka z tymczasowym plikiem zsyntetyzowanego dźwięku.
• OpenClaw monitoruje błędy odszyfrowywania odbieranego dźwięku i automatycznie przywraca działanie, opuszczając kanał głosowy i ponownie do niego dołączając po wielokrotnych błędach występujących w krótkim czasie.
• Jeśli po aktualizacji dzienniki odbierania wielokrotnie zawierają DecryptionFailed(UnencryptedWhenPassthroughDisabled), zbierz raport zależności i dzienniki. Dołączona wersja @discordjs/voice zawiera poprawkę dopełniania z PR discord.js nr 11449, która rozwiązała zgłoszenie discord.js nr 11419.
• Zdarzenia odbierania The operation was aborted są oczekiwane, gdy OpenClaw finalizuje przechwycony segment wypowiedzi mówcy; są to szczegółowe informacje diagnostyczne, a nie ostrzeżenia.
• Szczegółowe dzienniki obsługi głosu Discorda zawierają ograniczony, jednowierszowy podgląd transkrypcji STT dla każdego zaakceptowanego segmentu mówcy, dzięki czemu podczas debugowania widoczna jest zarówno strona użytkownika, jak i odpowiedź agenta, bez zapisywania nieograniczonego tekstu transkrypcji.
• W trybie agent-proxy mechanizm awaryjny wymuszonej konsultacji pomija prawdopodobnie niepełne fragmenty transkrypcji, takie jak tekst kończący się na ... lub końcowy spójnik, np. „i”, a także oczywiste zakończenia niewymagające działania, takie jak „zaraz wracam” lub „do widzenia”. Gdy zapobiega to udzieleniu nieaktualnej odpowiedzi oczekującej w kolejce, dzienniki zawierają forced agent consult skipped reason=....

Podążanie za użytkownikami na kanałach głosowych

Użyj voice.followUsers, jeśli chcesz, aby bot głosowy Discorda pozostawał z co najmniej jednym znanym użytkownikiem Discorda, zamiast dołączać podczas uruchamiania do stałego kanału lub czekać na /vc join.

{  channels: {    discord: {      voice: {        enabled: true,        followUsersEnabled: true,        followUsers: ["discord:123456789012345678"],        allowedChannels: [          {            guildId: "123456789012345678",            channelId: "234567890123456789",          },        ],      },    },  },}

Działanie:

• followUsers akceptuje nieprzetworzone identyfikatory użytkowników Discorda oraz wartości discord:<id>. OpenClaw normalizuje obie postacie przed dopasowaniem zdarzeń stanu głosowego.
• followUsersEnabled ma domyślnie wartość true, gdy skonfigurowano followUsers. Ustaw false, aby zachować zapisaną listę, ale zatrzymać automatyczne podążanie głosowe.
• Gdy obserwowany 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ę razem z nim. Gdy aktywny obserwowany użytkownik się rozłączy, OpenClaw opuszcza kanał.
• Jeśli wielu obserwowanych użytkowników znajduje się w tej samej gildii, a aktywny obserwowany użytkownik ją opuści, OpenClaw przeniesie się na kanał innego śledzonego użytkownika, zanim opuści gildię. Jeśli kilku obserwowanych użytkowników przeniesie się jednocześnie, decyduje ostatnie zaobserwowane zdarzenie stanu głosowego.
• allowedChannels nadal obowiązuje. Obserwowany użytkownik na niedozwolonym kanale jest ignorowany, a sesja zarządzana przez funkcję podążania przenosi się do innego obserwowanego użytkownika lub opuszcza kanał.
• OpenClaw uzgadnia pominięte zdarzenia stanu głosowego podczas uruchamiania oraz w ograniczonych odstępach czasu. Uzgadnianie sprawdza próbkę skonfigurowanych gildii i ogranicza liczbę zapytań REST na każde uruchomienie, dlatego bardzo duże listy followUsers mogą potrzebować więcej niż jednego interwału, aby osiągnąć zgodność.
• Jeśli Discord lub administrator przeniesie bota podczas podążania za użytkownikiem, OpenClaw odbudowuje sesję głosową i zachowuje własność funkcji podążania, jeśli kanał docelowy jest dozwolony. Jeśli bot zostanie przeniesiony poza allowedChannels, OpenClaw opuści kanał i ponownie dołączy do skonfigurowanego kanału docelowego, jeśli taki istnieje.
• Mechanizm odzyskiwania odbierania DAVE może opuścić ten sam kanał i ponownie do niego dołączyć po wielokrotnych błędach odszyfrowywania. Sesje zarządzane przez funkcję podążania zachowują tę własność podczas odzyskiwania, dlatego późniejsze rozłączenie obserwowanego użytkownika nadal powoduje opuszczenie kanału.

Wybierz jeden z trybów dołączania:

• Używaj followUsers w konfiguracjach osobistych lub operatorskich, w których bot powinien automatycznie przebywać na kanale głosowym razem z Tobą.
• Używaj autoJoin w przypadku botów przypisanych do stałych kanałów, które powinny być obecne nawet wtedy, gdy żaden śledzony użytkownik nie korzysta z kanału głosowego.
• Używaj /vc join do jednorazowego dołączania lub w pomieszczeniach, w których automatyczna obecność głosowa byłaby zaskakująca.

Kodek głosowy Discorda:

• Dzienniki odbierania głosu zawierają discord voice: opus decoder: libopus-wasm.
• Odtwarzanie w czasie rzeczywistym koduje surowy, stereofoniczny dźwięk PCM 48 kHz do formatu Opus przy użyciu tego samego dołączonego pakietu libopus-wasm, zanim przekaże pakiety do @discordjs/voice.
• Odtwarzanie plików i strumieni dostawcy transkoduje dźwięk za pomocą ffmpeg do surowego, stereofonicznego PCM 48 kHz, a następnie używa libopus-wasm do utworzenia strumienia pakietów Opus wysyłanego do Discorda.

Potok STT i TTS:

• Przechwycony przez Discord dźwięk PCM jest konwertowany do tymczasowego pliku WAV.
• tools.media.audio obsługuje STT, na przykład openai/gpt-4o-mini-transcribe.
• Transkrypcja jest przesyłana przez wejście i routing Discord, podczas gdy odpowiedziowy LLM działa z zasadami wyjścia głosowego, które ukrywają przed agentem narzędzie tts i wymagają zwrócenia tekstu, ponieważ odtwarzaniem końcowego TTS zarządza kanał głosowy Discord.
• Jeśli ustawiono voice.model, zastępuje on tylko odpowiedziowy LLM dla tej interakcji na kanale głosowym.
• voice.tts jest scalane ponad messages.tts; dostawcy obsługujący strumieniowanie przekazują dane bezpośrednio do odtwarzacza, a w przeciwnym razie wynikowy plik dźwiękowy jest odtwarzany na kanale, do którego dołączono.

Przykład domyślnej sesji kanału głosowego z agentem pośredniczącym:

{  channels: {    discord: {      voice: {        enabled: true,        model: "openai/gpt-5.6-sol",        followUsersEnabled: true,        followUsers: ["123456789012345678"],        realtime: {          provider: "openai",          model: "gpt-realtime-2.1",          speakerVoice: "cedar",        },      },    },  },}

Bez bloku voice.agentSession każdy kanał głosowy otrzymuje własną routowaną sesję OpenClaw. Na przykład /vc join channel:234567890123456789 komunikuje się z sesją tego kanału głosowego Discord. Model czasu rzeczywistego jest tylko głosowym interfejsem wejściowym; merytoryczne żądania są przekazywane skonfigurowanemu agentowi OpenClaw. Jeśli model czasu rzeczywistego utworzy końcową transkrypcję bez wywołania narzędzia konsultacji, OpenClaw wymusza konsultację jako mechanizm awaryjny, aby domyślne działanie nadal przypominało rozmowę z agentem.

Przykład starszego trybu STT oraz TTS:

{  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 dwukierunkowej komunikacji czasu rzeczywistego:

{  channels: {    discord: {      voice: {        enabled: true,        mode: "bidi",        model: "openai/gpt-5.6-sol",        realtime: {          provider: "openai",          model: "gpt-realtime-2.1",          speakerVoice: "cedar",          toolPolicy: "safe-read-only",          consultPolicy: "always",        },      },    },  },}

Obsługa głosu jako rozszerzenie istniejącej sesji kanału Discord:

{  channels: {    discord: {      voice: {        enabled: true,        mode: "agent-proxy",        model: "openai/gpt-5.6-sol",        agentSession: {          mode: "target",          target: "channel:123456789012345678",        },        realtime: {          provider: "openai",          model: "gpt-realtime-2.1",          speakerVoice: "cedar",        },      },    },  },}

W trybie agent-proxy bot dołącza do skonfigurowanego kanału głosowego, ale interakcje agenta OpenClaw korzystają ze standardowo routowanej sesji i agenta kanału docelowego. Głosowa sesja czasu rzeczywistego odczytuje zwrócony wynik na kanale głosowym. Agent nadzorujący może nadal używać zwykłych narzędzi wiadomości zgodnie ze swoimi zasadami 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 interakcji agenta. Wyrażenia takie jak „stan”, „anuluj to”, „zastosuj mniejszą poprawkę” lub „gdy skończysz, sprawdź również testy” są klasyfikowane jako żądanie stanu, anulowanie, instrukcja sterująca lub dane uzupełniające dla aktywnej sesji. Stan, anulowanie, zaakceptowane instrukcje sterujące i wyniki działań uzupełniających są odczytywane na kanale głosowym, aby rozmówca wiedział, czy OpenClaw obsłużył żądanie.

Przydatne postacie celu:

• target: "channel:123456789012345678" kieruje przez sesję kanału tekstowego Discord.
• target: "123456789012345678" jest traktowane jako cel będący kanałem.
• target: "dm:123456789012345678" lub target: "user:123456789012345678" kieruje przez sesję wiadomości bezpośrednich danego użytkownika.

Przykład OpenAI Realtime w środowisku z silnym echem:

{  channels: {    discord: {      voice: {        enabled: true,        mode: "bidi",        model: "openai/gpt-5.6-sol",        realtime: {          provider: "openai",          model: "gpt-realtime-2.1",          speakerVoice: "cedar",          bargeIn: true,          minBargeInAudioEndMs: 500,          consultPolicy: "always",          providers: {            openai: {              interruptResponseOnInputAudio: false,            },          },        },      },    },  },}

Użyj tego ustawienia, gdy model słyszy własny dźwięk odtwarzany przez Discord za pośrednictwem otwartego mikrofonu, ale nadal chcesz móc przerwać jego wypowiedź głosem. OpenClaw zapobiega automatycznemu przerywaniu przez OpenAI w reakcji na nieprzetworzone wejście dźwiękowe, natomiast bargeIn: true pozwala zdarzeniom rozpoczęcia mówienia w Discord oraz dźwiękowi już aktywnego rozmówcy anulować aktywne odpowiedzi czasu rzeczywistego, zanim kolejna przechwycona wypowiedź dotrze do OpenAI. Bardzo wczesne sygnały przerwania z wartością audioEndMs mniejszą niż minBargeInAudioEndMs są uznawane za prawdopodobne echo lub szum i ignorowane, aby model nie urywał wypowiedzi przy pierwszej ramce odtwarzanego dźwięku.

Oczekiwane dzienniki obsługi głosu:

• Przy dołączeniu: discord voice: joining ... voiceSession=... supervisorSession=... agentSessionMode=... voiceModel=... realtimeModel=...
• Przy uruchomieniu trybu czasu rzeczywistego: discord voice: realtime bridge starting ... autoRespond=false interruptResponse=false bargeIn=false minBargeInAudioEndMs=...
• Dla dźwięku rozmó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ęciu nieaktualnej wypowiedzi: discord voice: realtime forced agent consult skipped reason=incomplete-transcript ... lub reason=non-actionable-closing ...
• Po zakończeniu odpowiedzi czasu rzeczywistego: discord voice: realtime audio playback finishing reason=response.done ... audioMs=... chunks=...
• Przy zatrzymaniu lub zresetowaniu odtwarzania: discord voice: realtime audio playback stopped reason=... audioMs=... elapsedMs=... chunks=...
• Przy konsultacji czasu rzeczywistego: discord voice: realtime consult requested ... voiceSession=... supervisorSession=... question=...
• Przy odpowiedzi agenta: discord voice: agent turn answer ...
• Przy umieszczeniu dokładnej wypowiedzi w kolejce: discord voice: realtime exact speech queued ... queued=... outputAudioMs=... outputActive=..., a następnie discord voice: realtime exact speech dequeued reason=player-idle ...
• Przy wykryciu przerwania wypowiedzi: discord voice: realtime barge-in detected source=speaker-start ... lub discord voice: realtime barge-in detected source=active-speaker-audio ..., a następnie discord voice: realtime barge-in requested reason=... outputAudioMs=... outputActive=...
• Przy przerwaniu trybu czasu rzeczywistego: discord voice: realtime model interrupt requested client:response.cancel reason=barge-in, a następnie 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 zignorowaniu echa lub szumu: discord voice: realtime model interrupt ignored client:conversation.item.truncate.skipped reason=barge-in audioEndMs=0 minAudioEndMs=250
• Przy wyłączonym przerywaniu wypowiedzi: 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 zdiagnozować urywany dźwięk, odczytuj dzienniki głosu czasu rzeczywistego jako oś czasu:

1. realtime audio playback started oznacza, że Discord rozpoczął odtwarzanie dźwięku asystenta. Od tego momentu most zlicza fragmenty wyjścia dźwiękowego asystenta, bajty PCM Discord, bajty czasu rzeczywistego dostawcy oraz czas trwania wygenerowanego dźwięku.
2. realtime speaker turn opened oznacza, że rozmówca w Discord stał się aktywny. Jeśli odtwarzanie jest już aktywne i włączono bargeIn, może po tym wystąpić barge-in detected source=speaker-start.
3. realtime input audio started oznacza pierwszą rzeczywistą ramkę dźwięku odebraną w ramach danej wypowiedzi rozmówcy. outputActive=true lub niezerowa wartość outputAudioMs w tym miejscu oznacza, że mikrofon wysyła dane wejściowe, gdy odtwarzanie dźwięku asystenta jest nadal aktywne.
4. barge-in detected source=active-speaker-audio oznacza, że OpenClaw wykrył dźwięk aktywnego rozmówcy podczas odtwarzania dźwięku asystenta. Pomaga to odróżnić rzeczywiste przerwanie od zdarzenia rozpoczęcia mówienia w Discord, któremu nie towarzyszy użyteczny dźwięk.
5. barge-in requested reason=... oznacza, że OpenClaw poprosił dostawcę czasu rzeczywistego o anulowanie lub skrócenie aktywnej odpowiedzi. Wpis zawiera outputAudioMs, outputActive i playbackChunks, dzięki czemu można sprawdzić, ile dźwięku asystenta rzeczywiście odtworzono przed przerwaniem.
6. realtime audio playback stopped reason=... jest lokalnym punktem zresetowania odtwarzania w Discord. Przyczyna wskazuje, co zatrzymało odtwarzanie: barge-in, player-idle, provider-clear-audio, forced-agent-consult, stream-close lub session-close.
7. realtime speaker turn closed podsumowuje przechwyconą wypowiedź wejściową. chunks=0 lub hasAudio=false oznacza, że wypowiedź rozmówcy została rozpoczęta, ale do mostu czasu rzeczywistego nie dotarł żaden użyteczny dźwięk. interruptedPlayback=true oznacza, że ta wypowiedź wejściowa nałożyła się na wyjście asystenta i uruchomiła logikę przerywania.

Przydatne pola:

• outputAudioMs: czas trwania dźwięku asystenta wygenerowanego przez dostawcę czasu rzeczywistego przed danym wpisem dziennika.
• audioMs: czas trwania dźwięku asystenta zliczony przez OpenClaw przed zatrzymaniem odtwarzania.
• elapsedMs: czas zegarowy między otwarciem i zamknięciem strumienia odtwarzania lub wypowiedzi rozmówcy.
• discordBytes: bajty stereofonicznego dźwięku PCM 48 kHz wysłane do kanału głosowego Discord lub z niego odebrane.
• realtimeBytes: bajty PCM w formacie dostawcy wysłane do dostawcy czasu rzeczywistego lub od niego odebrane.
• playbackChunks: fragmenty dźwięku asystenta przekazane do Discord dla aktywnej odpowiedzi.
• sinceLastAudioMs: odstęp między ostatnią przechwyconą ramką dźwięku rozmówcy a zamknięciem jego wypowiedzi.

Typowe wzorce:

• Natychmiastowe urwanie z source=active-speaker-audio, małą wartością outputAudioMs i tym samym użytkownikiem w pobliżu zwykle wskazuje, że echo z głośnika trafia do mikrofonu. Zwiększ voice.realtime.minBargeInAudioEndMs, zmniejsz głośność głośnika, użyj słuchawek lub ustaw voice.realtime.providers.openai.interruptResponseOnInputAudio: false.
• source=speaker-start, po którym występuje speaker turn closed ... hasAudio=false, oznacza, że Discord zgłosił rozpoczęcie mówienia, ale żaden dźwięk nie dotarł do OpenClaw. Przyczyną może być przejściowe zdarzenie głosowe Discord, działanie bramki szumów lub krótkotrwałe włączenie mikrofonu przez klienta.
• audio playback stopped reason=stream-close bez występującego w pobliżu przerwania lub provider-clear-audio oznacza, że lokalny strumień odtwarzania Discord zakończył się nieoczekiwanie. Sprawdź wcześniejsze dzienniki 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 mechanizm VAD dostawcy wykrył mowę, ale OpenClaw nie miał aktywnego odtwarzania do przerwania. Nie powinno to powodować urywania 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 czasu rzeczywistego dla voice.realtime.providers lub standardowej konfiguracji uwierzytelniania dostawcy.

Wiadomości głosowe

Wiadomości głosowe Discord wyświetlają podgląd przebiegu fali i wymagają dźwięku OGG/Opus. OpenClaw automatycznie generuje przebieg fali, ale do analizy i konwersji potrzebuje programów ffmpeg i ffprobe na hoście Gateway.

• Podaj lokalną ścieżkę pliku (adresy URL są odrzucane).
• Pomiń treść tekstową (Discord odrzuca połączenie tekstu i wiadomości głosowej w tym samym ładunku).
• Akceptowany jest dowolny format dźwięku; OpenClaw w razie potrzeby konwertuje go do OGG/Opus.

message(action="send", channel="discord", target="channel:123", path="/path/to/audio.mp3", asVoice=true)

Rozwiązywanie problemów

openclaw doctoropenclaw channels status --probeopenclaw logs --follow

{channels: {discord: {  accounts: {    default: {      eventQueue: {        listenerTimeout: 120000,      },    },  },},},}

{channels: {defaults: {  botLoopProtection: {    maxEventsPerWindow: 20,    windowSeconds: 60,    cooldownSeconds: 60,  },},discord: {  // Opcjonalne nadpisanie dla całego Discord. Bloki kont nadpisują poszczególne  // pola i dziedziczą stąd pominięte pola.  botLoopProtection: {    maxEventsPerWindow: 4,  },  accounts: {    alpha: {      // Alpha nasłuchuje innych botów tylko wtedy, gdy o nim wspominają.      allowBots: "mentions",    },    bravo: {      // Bravo nasłuchuje wszystkich wiadomości Discord utworzonych przez boty.      allowBots: true,      mentionAliases: {        // Pozwala Bravo utworzyć wzmiankę Discord o Alpha przy użyciu skonfigurowanego identyfikatora użytkownika.        Alpha: "ALPHA_DISCORD_USER_ID",      },      botLoopProtection: {        // Zezwól na maksymalnie pięć wiadomości na minutę przed zablokowaniem pary.        maxEventsPerWindow: 5,        windowSeconds: 60,        cooldownSeconds: 90,      },    },  },},},}

Dokumentacja konfiguracji

Główna dokumentacja: Dokumentacja konfiguracji — Discord.

Bezpieczeństwo i eksploatacja

• Traktuj tokeny botów jako dane poufne (w nadzorowanych środowiskach preferowana jest zmienna DISCORD_BOT_TOKEN).
• Przyznawaj minimalne niezbędne uprawnienia Discord.
• Jeśli stan wdrożenia poleceń jest nieaktualny, uruchom ponownie Gateway i sprawdź go ponownie za pomocą openclaw channels status --probe.

Powiązane materiały