OpenClaw + Slack — AI w Twoim workspace

Slack to standard komunikacji w firmach i zespolach technicznych. Podlaczenie OpenClaw do workspace'a Slack oznacza, ze każdy pracownik ma dostęp 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 wiadomości, czytania kanalow i wykonywania akcji. Przejdz do OAuth & Permissions, aby skonfigurowac zakresy i zainstalować 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 wiadomości 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 — wiadomości w publicznych kanalach
• message.groups — wiadomości w prywatnych kanalach
• message.im — wiadomości prywatne (DM)
• message.mpim — wiadomości grupowe
• reaction_added, reaction_removed — reakcje emoji
• member_joined_channel, member_left_channel — ruchy czlonkow
• pin_added, pin_removed — przypinanie wiadomości

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

4. Socket Mode vs HTTP Events API

OpenClaw obsługuje 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 wiadomości 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 umiejętności (skills) dla każdego 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 — każdy 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 obsługuje. Każdy watek ma osobna sesję 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 wiadomości ladowac
    replyToMode: first           # odpowiadaj w watku

Opcje replyToMode:

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

Watki sa szczególnie przydatne, gdy wielu uzytkownikow jednocześnie rozmawia z botem na tym samym kanale — kazda rozmowa jest izolowaną.

8. Slash commands i interaktywne odpowiedzi

OpenClaw obsługuje 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 obsługuje 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 wiadomość w czasie rzeczywistym, wyswietlajac treść w miare generowania.

9. Przypadki uzycia w firmie

OpenClaw w Slacku to nie tylko chatbot — to pełny 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 działa na Twojej infrastrukturze, dane nie opuszczaja firmy
• Zasada najmniejszych uprawnien — bot wymaga tylko tych zakresow OAuth, które sa niezbedne do działania
• Pełen 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 wiadomości wyslane po jego dodaniu do kanalu (chyba ze ma dostęp do historii)

Przygotuj dokumentacje dla IT

1. Lista wszystkich zakresow OAuth z uzasadnieniem każdego
2. Architektura — gdzie działa OpenClaw (on-prem, VPS, cloud) i gdzie trafiają 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 działa — włącz "Agents and AI Apps" w ustawieniach Slacka i dodaj zakres assistant:write

Powiazane poradniki