OpenClaw + Slack — AI w Twoim workspace

Slack to standard komunikacji w firmach i zespolach technicznych. Podlaczenie OpenClaw do workspace'a Slack oznacza, ze kazdy pracownik ma dostep do asystenta AI bezposrednio w kanalach, watkach i wiadomosciach prywatnych — bez opuszczania narzędzia, w którym już pracuje. Ten poradnik przeprowadzi Cie przez caly proces, od utworzenia aplikacji Slack po zatwierdzenie przez dzial IT.

1. Tworzenie aplikacji Slack

Kazda integracja ze Slackiem zaczyna się od utworzenia aplikacji (Slack App). To aplikacja, która reprezentuje Twojego bota AI w workspace'ie.

1. Przejdz do api.slack.com/apps i kliknij Create New App
2. Wybierz From scratch (lub From manifest, jeśli masz gotowy manifest)
3. Nadaj aplikacji nazwe, np. "OpenClaw AI" i wybierz docelowy workspace
4. W sekcji Settings > Socket Mode włącz Socket Mode (zalecane dla wiekszosci wdrozen)
5. Podczas wlaczania Socket Mode wygeneruj App-Level Token z zakresem connections:write — ten token zaczyna się od xapp-

2. Tokeny i zakresy OAuth

Slack uzywa systemu tokenow i zakresow (scopes) do kontrolowania dostepu aplikacji. OpenClaw wymaga dwoch rodzajow tokenow.

App Token (xapp-...)

Wygenerowany podczas wlaczania Socket Mode. Sluzy do nawiazania połączenia WebSocket ze Slackiem. Wymagany zakres: connections:write.

Bot Token (xoxb-...)

Generowany po zainstalowaniu aplikacji w workspace'ie. Sluzy do wysylania wiadomosci, czytania kanalow i wykonywania akcji. Przejdz do OAuth & Permissions, aby skonfigurowac zakresy i zainstalowac aplikacje.

Wymagane zakresy bota (Bot Token Scopes)

W sekcji OAuth & Permissions > Bot Token Scopes dodaj następujące zakresy:

Po dodaniu zakresow kliknij Install App to Workspace i zatwierdz uprawnienia. Skopiuj wygenerowany Bot User OAuth Token (zaczynajacy się od xoxb-).

Zapisz tokeny jako zmienne srodowiskowe:

export SLACK_APP_TOKEN="xapp-Twój_app_token"
export SLACK_BOT_TOKEN="xoxb-Twój_bot_token"

3. Subskrypcja zdarzen

Aby bot reagowal na wiadomosci i interakcje, musisz zasubskrybowac odpowiednie zdarzenia. Przejdz do Event Subscriptions i włącz je.

Wymagane zdarzenia bota (Subscribe to bot events)

• app_mention — gdy ktos oznaczy bota przez @
• message.channels — wiadomosci w publicznych kanalach
• message.groups — wiadomosci w prywatnych kanalach
• message.im — wiadomosci prywatne (DM)
• message.mpim — wiadomosci grupowe
• reaction_added, reaction_removed — reakcje emoji
• member_joined_channel, member_left_channel — ruchy czlonkow
• pin_added, pin_removed — przypinanie wiadomosci

Dodatkowo przejdz do App Home i włącz Messages Tab — to konieczne, aby bot mogl odbierac wiadomosci prywatne (DM).

4. Socket Mode vs HTTP Events API

OpenClaw obsluguje dwa tryby połączenia ze Slackiem. Wybor zalezy od Twojej infrastruktury i wymagan bezpieczeństwa.

Dla wiekszosci uzytkownikow Socket Mode jest lepszym wyborem. Jest prostszy, bezpieczniejszy (brak publicznego endpointu) i wystarczajacy nawet dla workspace'ow z setkami uzytkownikow.

5. Konfiguracja gateway OpenClaw

Po przygotowaniu aplikacji Slack skonfiguruj OpenClaw, aby polaczyl się z Twoim workspace'em.

Konfiguracja Socket Mode

channels:
  slack:
    enabled: true
    mode: socket
    appToken: xapp-Twój_app_token
    botToken: xoxb-Twój_bot_token

Konfiguracja HTTP Mode

channels:
  slack:
    enabled: true
    mode: http
    botToken: xoxb-Twój_bot_token
    signingSecret: Twój_signing_secret
    webhookPath: /slack/events

Uruchom gateway komenda openclaw gateway i sprawdz status połączenia:

openclaw channels status --probe

6. Integracja z kanalami

Po zainstalowaniu aplikacji dodaj bota do kanalow, w których ma dzialac. W Slacku kliknij na nazwe kanalu > Integrations > Add an App i wybierz swojego bota.

Kontrola dostepu do kanalow

Domyslnie bot reaguje na wiadomosci na kanalach tylko po @oznaczeniu. Możesz to zmienic per kanal:

channels:
  slack:
    groupPolicy: allowlist
    channels:
      "C0123456789":
        requireMention: false
        users:
          - "U0123456789"
        systemPrompt: "Jestes asystentem dzialu marketingu."

Możesz ustawic osobne prompty systemowe, listę dozwolonych narzędzi i umiejetnosci (skills) dla kazdego kanalu osobno. To pozwala na stworzenie wyspecjalizowanych asystentow — np. bot na kanale #dev zna się na programowaniu, a na #marketing pomaga w copywritingu.

Wiadomosci prywatne (DM)

Polityki dostepu do DM dzialaja tak samo jak w Discordzie:

• pairing (domyslna) — kod parowania do zatwierdzenia
• allowlist — tylko wybrani uzytkownicy
• open — kazdy w workspace może pisac
• disabled — DM wylaczone

7. Obsługa watkow (threads)

Watki to jedna z najwazniejszych funkcji Slacka, i OpenClaw w pelni je obsluguje. Kazdy watek ma osobna sesje konwersacji, co oznacza, ze AI pamięta kontekst rozmowy w watku, nie mieszajac go z innymi rozmowami na kanale.

Konfiguracja watkow

channels:
  slack:
    thread:
      historyScope: thread      # kontekst ograniczony do watku
      inheritParent: false       # nie dziedzicz z kanalu
      initialHistoryLimit: 20    # ile wiadomosci ladowac
    replyToMode: first           # odpowiadaj w watku

Opcje replyToMode:

• off — bot odpowiada bezposrednio na kanale (bez watku)
• first — bot odpowiada w watku do pierwszej wiadomosci
• all — kazda odpowiedź jest reply w watku

Watki sa szczególnie przydatne, gdy wielu uzytkownikow jednoczesnie rozmawia z botem na tym samym kanale — kazda rozmowa jest izolowana.

8. Slash commands i interaktywne odpowiedzi

OpenClaw obsluguje natywne slash commands Slacka. Domyslnie sa wylaczone — włącz je w konfiguracji:

channels:
  slack:
    commands:
      native: true

Zarejestruj odpowiednie slash commands w panelu aplikacji Slack. Uwaga: Slack rezerwuje komende /status, wiec OpenClaw uzywa /agentstatus zamiast niej.

Interaktywne odpowiedzi

Włącz interaktywne komponenty w odpowiedziach bota:

channels:
  slack:
    capabilities:
      interactiveReplies: true

Po wlaczeniu bot może uzywac dyrektyw w odpowiedziach:

• [[slack_buttons: Zatwierdz:approve, Odrzuc:reject]] — przyciski akcji
• [[slack_select: Wybierz środowisko | Staging:staging, Production:prod]] — menu wyboru

Natywny streaming odpowiedzi

Slack obsluguje natywny streaming odpowiedzi AI (wymaga wlaczenia Agents and AI Apps w panelu Slacka i zakresu assistant:write). Domyslnie OpenClaw uzywa trybu partial, który edytuje wiadomosc w czasie rzeczywistym, wyswietlajac treść w miare generowania.

9. Przypadki uzycia w firmie

OpenClaw w Slacku to nie tylko chatbot — to pelny asystent AI zintegrowany z przepylwem pracy Twojego zespołu. Oto najpopularniejsze scenariusze biznesowe:

10. Zatwierdzenie przez dzial IT

W wiekszosci firm instalacja nowej aplikacji Slack wymaga zgody dzialu IT lub administratora workspace'a. Oto argumenty i informacje, które pomoga w uzyskaniu zatwierdzenia.

Kluczowe punkty bezpieczeństwa

• Brak danych na zewnetrznych serwerach — w trybie Socket Mode OpenClaw dziala na Twojej infrastrukturze, dane nie opuszczaja firmy
• Zasada najmniejszych uprawnien — bot wymaga tylko tych zakresow OAuth, które sa niezbedne do dzialania
• Pelen audytowalnosc — wszystkie interakcje sa logowane przez OpenClaw i widoczne w logu aktywnosci Slacka
• Kontrola dostepu — per-channel i per-user allowlisty, dmPolicy, groupPolicy
• Brak dostepu do istniejacych danych — bot widzi tylko wiadomosci wyslane po jego dodaniu do kanalu (chyba ze ma dostep do historii)

Przygotuj dokumentacje dla IT

1. Lista wszystkich zakresow OAuth z uzasadnieniem kazdego
2. Architektura — gdzie dziala OpenClaw (on-prem, VPS, cloud) i gdzie trafiaja dane
3. Polityka retencji danych — jak długo przechowywane sa logi rozmow
4. Plan awaryjny — co się stanie, jeśli bot przestanie dzialac
5. Lista kanalow, na których bot będzie aktywny

11. Rozwiązywanie problemow

Diagnostyka integracji Slack:

openclaw doctor
openclaw channels status --probe
openclaw logs --follow
openclaw pairing list slack

Najczestsze problemy:

• Socket Mode nie łączy się — sprawdz, czy App Token (xapp-) i Bot Token (xoxb-) sa prawidlowe i czy Socket Mode jest włączony w panelu Slacka
• Bot nie odpowiada na kanale — upewnij się, ze bot jest dodany do kanalu, sprawdz groupPolicy i allowliste, zweryfikuj requireMention
• DM ignorowane — sprawdz, czy Messages Tab jest włączony w App Home, zweryfikuj dmPolicy i parowanie
• Brak reakcji emoji — dodaj zakresy reactions:read i reactions:write
• HTTP mode nie odbiera zdarzen — sprawdz Signing Secret, Request URL, ścieżkę webhooka i certyfikat SSL
• Streaming nie dziala — włącz "Agents and AI Apps" w ustawieniach Slacka i dodaj zakres assistant:write

Powiazane poradniki