OpenClaw + Discord — asystent AI na Twoim serwerze

Discord to naturalne środowisko dla spolecznosci graczy, deweloperow i zespołów projektowych. Podlaczenie OpenClaw do Twojego serwera oznacza, ze kazdy czlonek ma dostep do asystenta AI bezposrednio w kanale tekstowym, w wiadomosciach prywatnych, a nawet na kanale glosowym. W tym poradniku przeprowadzimy Cie przez caly proces — od utworzenia bota po zaawansowana konfiguracje.

1. Utworzenie aplikacji w Discord Developer Portal

Pierwszym krokiem jest utworzenie aplikacji Discord, która będzie "pojemnikiem" dla Twojego bota AI. Caly proces zajmuje kilka minut.

1. Przejdz do Discord Developer Portal pod adresem discord.com/developers/applications
2. Kliknij New Application i nadaj jej nazwe, np. "OpenClaw AI" lub "Asystent Serwera"
3. W menu bocznym kliknij Bot
4. Kliknij Add Bot (jeśli bot nie zostal dodany automatycznie)
5. Opcjonalnie: ustaw avatar i opis bota — to będzie widoczne na Twoim serwerze

2. Token bota i konfiguracja intencji

Token bota to klucz, który pozwala OpenClaw uwierzytelnic się jako Twój bot Discord. Intencje (Privileged Gateway Intents) okreslaja, do jakich danych bot ma dostep.

Generowanie tokena

W sekcji Bot kliknij Reset Token, skopiuj wygenerowany token i zapisz go w bezpiecznym miejscu. Tokena nie można wyswietlic ponownie — jeśli go utracisz, będziesz musial wygenerowac nowy.

Ustaw token jako zmienna srodowiskowa:

export DISCORD_BOT_TOKEN="Twój_token_bota"

Włączenie intencji

W sekcji Bot, przewin do Privileged Gateway Intents i włącz:

• Message Content Intent — wymagany, aby bot mogl czytac treść wiadomosci
• Server Members Intent — zalecany, umozliwia wyszukiwanie uzytkownikow po ID
• Presence Intent — opcjonalny, pozwala na monitoring statusu uzytkownikow

3. Uprawnienia i link OAuth2

Aby bot mogl dzialac na Twoim serwerze, musisz wygenerowac link zaproszenia z odpowiednimi uprawnieniami. Przejdz do sekcji OAuth2 > URL Generator.

Wymagane zakresy (scopes)

• bot — podstawowy zakres bota
• applications.commands — obsulga slash commands

Uprawnienia bota (Bot Permissions)

• View Channels — podglad kanalow
• Send Messages — wysylanie wiadomosci
• Read Message History — odczytywanie historii
• Embed Links — osadzanie linkow w formatowanych wiadomosciach
• Attach Files — dolaczanie plikow
• Add Reactions — reagowanie na wiadomosci (opcjonalne, ale zalecane)
• Connect + Speak — wymagane, jeśli planujesz uzywac kanalow glosowych

Skopiuj wygenerowany URL, wklej go w przegladarke, wybierz swoj serwer i kliknij Continue. Bot pojawi się na liscie czlonkow serwera.

4. Konfiguracja gateway OpenClaw

Po stronie OpenClaw musisz wlaczyc kanal Discord i wskazac token bota. Możesz to zrobić na dwa sposoby — przez zmienna srodowiskowa lub w pliku konfiguracyjnym.

Minimalna konfiguracja

channels:
  discord:
    enabled: true
    token:
      source: env
      provider: default
      id: DISCORD_BOT_TOKEN

Konfiguracja z allowlista serwera

Jeśli chcesz ograniczyc bota do konkretnego serwera i uzytkownikow:

channels:
  discord:
    enabled: true
    groupPolicy: allowlist
    guilds:
      "TWOJE_SERVER_ID":
        requireMention: false
        users:
          - "TWOJE_USER_ID"

Aby uzyskac ID serwera i uzytkownika, włącz Developer Mode w ustawieniach Discorda (User Settings > Advanced > Developer Mode). Następnie kliknij prawym przyciskiem myszy na ikone serwera lub swoj avatar i wybierz Copy ID.

5. Tryb serwera vs wiadomosci prywatne (DM)

OpenClaw na Discordzie dziala w dwoch trybach, które można laczyc. Kazdy z nich ma wlasne polityki dostepu i zarządzanie sesjami.

Tryb serwera (Guild Mode)

W trybie serwerowym bot odpowiada na kanalach tekstowych. Domyslnie wymaga oznaczenia (@mention) — możesz to zmienic ustawiajac requireMention: false. Kazdy kanal ma osobna sesje, co oznacza, ze kontekst rozmowy nie jest wspoldzielony między kanalami.

Kontrola dostepu w trybie serwerowym odbywa się przez:

• groupPolicy — "open", "allowlist" lub "disabled"
• guilds.<id>.users — lista dozwolonych uzytkownikow
• guilds.<id>.roles — lista dozwolonych rol

Wiadomosci prywatne (DM Mode)

W trybie DM uzytkownik pisze bezposrednio do bota. Domyslnie dziala polityka pairing — nowy uzytkownik otrzymuje jednorazowy kod parowania (ważny przez 1 godzine), który musisz zatwierdzic:

openclaw pairing approve discord KOD_PAROWANIA

Dostepne polityki DM:

• pairing (domyslna) — wymaga zatwierdzenia kodu
• allowlist — tylko okresleni uzytkownicy
• open — kazdy może pisac do bota
• disabled — DM wylaczone

6. Slash commands — komendy w Discord

OpenClaw obsluguje natywne slash commands Discorda, co daje uzytkownikowi wygodny interfejs z podpowiedziami i autouzupelnianiem. Domyslnie komendy sa wlaczone w trybie auto.

Wbudowane komendy

• /model i /models — interaktywny wybor modelu AI (provider + model w dropdownie)
• /vc join, /vc leave, /vc status — sterowanie kanalami glosowymi
• /focus <target> — przypisanie watku do konkretnego subagenta
• /unfocus — usuniecie przypisania
• /agents — lista aktywnych agentow i ich powiazania
• /session — konfiguracja sesji (idle, max-age)

Odpowiedzi na slash commands sa domyslnie efemeryczne (widoczne tylko dla osoby wpisujacej komende), co nie zasmiecaja kanalu.

Routing na podstawie rol

Możesz przypisac różne modele AI do różnych rol na serwerze. Na przykład moderatorzy moga korzystac z mocniejszego modelu, a zwykli uzytkownicy z szybszego:

bindings:
  - agentId: opus
    match:
      channel: discord
      guildId: "TWOJE_SERVER_ID"
      roles:
        - "ID_ROLI_MODERATORA"

7. Kanaly glosowe — rozmowy z AI

Jedna z najbardziej imponujacych funkcji OpenClaw na Discordzie to możliwość dolaczenia bota do kanalu glosowego. Bot slucha, rozumie mowe (STT) i odpowiada glosem (TTS), tworzac naturalna rozmowe w czasie rzeczywistym.

Włączenie funkcji glosowych

channels:
  discord:
    voice:
      enabled: true
      autoJoin:
        - guildId: "TWOJE_SERVER_ID"
          channelId: "ID_KANALU_GLOSOWEGO"
      tts:
        provider: openai
        openai:
          voice: alloy

Kluczowe cechy kanalow glosowych:

• Voice Activity Detection (VAD) — automatyczne wykrywanie mowy uzytkownika
• Barge-in — bot natychmiast przerywa mowienie, gdy uzytkownik zacznie rozmowe
• Wybor dostawcy STT — Whisper (OpenAI), Deepgram lub lokalny Whisper offline
• Wybor dostawcy TTS — OpenAI TTS, ElevenLabs lub Kokoro (offline)
• Auto-reconnect — automatyczne ponowne połączenie po zerwaniu
• Szyfrowanie DAVE — obsługa szyfrowania glosowego Discorda

Do sterowania sesja glosowa sluza slash commands: /vc join aby dolaczyc, /vc leave aby opuscic kanal i /vc status aby sprawdzic stan połączenia.

8. Interaktywne komponenty

OpenClaw może wysylac wiadomosci z interaktywnymi przyciskami, menu wyboru i formularzami modalnymi. To przydatne do tworzenia przeplyow pracy, systemow zatwierdzen czy ankiet.

• Przyciski — do 5 w jednym rzedzie, z kolorowaniem (success/danger/primary/secondary)
• Menu wyboru — string, user, role, channel select
• Formularze modalne — do 5 pol (text, checkbox, radio, select)
• Reusable components — przyciski wielokrotnego uzytku (domyslnie jednorazowe)
• Ograniczenia dostepu — przyciski widoczne tylko dla okreslonych uzytkownikow

Możesz też konfiguruje streaming odpowiedzi — bot może edytowac wiadomosc w czasie rzeczywistym, wyswietlajac treść w miare generowania. Dostepne tryby to: partial (edycja jednej wiadomosci), block (fragmenty) i progress (pasek postepu).

9. Przypadki uzycia dla spolecznosci Discord

OpenClaw na Discordzie sprawdza się doskonale w wielu scenariuszach. Oto najpopularniejsze zastosowania:

10. Rozwiązywanie problemow

Jeśli bot nie dziala prawidlowo, zacznij od diagnostyki:

openclaw doctor
openclaw channels status --probe
openclaw logs --follow

Najczestsze problemy i ich rozwiązania:

• "Used disallowed intents" — włącz Message Content Intent i Server Members Intent w Developer Portal
• Bot nie odpowiada na kanale — sprawdz groupPolicy, allowliste serwera i ustawienie requireMention
• Bot zapetla się sam ze soba — upewnij się, ze allowBots jest ustawione na false (domyslne)
• DM nie dziala — sprawdz dmPolicy, parowanie i czy uzytkownik ma wlaczone DM od czlonkow serwera
• Problemy z glosem — sprawdz uprawnienia Connect + Speak, potwierdz daveEncryption: true

Powiazane poradniki