​

Slack

​

Szybka konfiguracja

{
  channels: {
    slack: {
      enabled: true,
      mode: "socket",
      appToken: "xapp-...",
      botToken: "xoxb-...",
    },
  },
}

SLACK_APP_TOKEN=xapp-...
SLACK_BOT_TOKEN=xoxb-...

openclaw gateway

{
  channels: {
    slack: {
      enabled: true,
      mode: "http",
      botToken: "xoxb-...",
      signingSecret: "your-signing-secret",
      webhookPath: "/slack/events",
    },
  },
}

​

Lista kontrolna manifestu i zakresów

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Slack connector for OpenClaw"
  },
  "features": {
    "bot_user": {
      "display_name": "OpenClaw",
      "always_online": true
    },
    "app_home": {
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Send a message to OpenClaw",
        "should_escape": false
      }
    ]
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "assistant:write",
        "channels:history",
        "channels:read",
        "chat:write",
        "commands",
        "emoji:read",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "pins:read",
        "pins:write",
        "reactions:read",
        "reactions:write",
        "users:read"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_mention",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    }
  }
}

​

Model tokenów

• botToken + appToken są wymagane dla Socket Mode.
• Tryb HTTP wymaga botToken + signingSecret.
• botToken, appToken, signingSecret i userToken akceptują jawne ciągi znaków lub obiekty SecretRef.
• Tokeny z konfiguracji mają pierwszeństwo przed zapasowymi zmiennymi środowiskowymi.
• Zapasowe zmienne środowiskowe SLACK_BOT_TOKEN / SLACK_APP_TOKEN mają zastosowanie tylko do konta domyślnego.
• userToken (xoxp-...) jest dostępny tylko w konfiguracji (bez zapasowej zmiennej środowiskowej) i domyślnie działa w trybie tylko do odczytu (userTokenReadOnly: true).
• Opcjonalnie: dodaj chat:write.customize, jeśli chcesz, aby wiadomości wychodzące używały tożsamości aktywnego agenta (niestandardowa username i ikona). icon_emoji używa składni :nazwa_emoji:.

• Inspekcja konta Slack śledzi pola *Source i *Status dla każdego poświadczenia (botToken, appToken, signingSecret, userToken).
• Status ma wartość available, configured_unavailable lub missing.
• configured_unavailable oznacza, że konto jest skonfigurowane przez SecretRef lub inne niejawne źródło sekretu, ale bieżąca ścieżka polecenia/środowiska uruchomieniowego nie mogła rozwiązać rzeczywistej wartości.
• W trybie HTTP uwzględniany jest signingSecretStatus; w Socket Mode wymaganą parą są botTokenStatus + appTokenStatus.

​

Działania i bramki

​

Kontrola dostępu i routing

​

Wątki, sesje i tagi odpowiedzi

• Wiadomości prywatne są routowane jako direct; kanały jako channel; MPIM jako group.
• Przy domyślnym session.dmScope=main wiadomości prywatne Slacka są scalane do głównej sesji agenta.
• Sesje kanałów: agent:<agentId>:slack:channel:<channelId>.
• Odpowiedzi w wątkach mogą tworzyć sufiksy sesji wątku (:thread:<threadTs>) tam, gdzie ma to zastosowanie.
• Domyślna wartość channels.slack.thread.historyScope to thread; domyślna wartość thread.inheritParent to false.
• channels.slack.thread.initialHistoryLimit kontroluje, ile istniejących wiadomości w wątku jest pobieranych przy rozpoczęciu nowej sesji wątku (domyślnie 20; ustaw 0, aby wyłączyć).

• channels.slack.replyToMode: off|first|all (domyślnie off)
• channels.slack.replyToModeByChatType: dla każdego z direct|group|channel
• starsza wartość zapasowa dla czatów bezpośrednich: channels.slack.dm.replyToMode

• [[reply_to_current]]
• [[reply_to:<id>]]

​

Reakcje potwierdzenia

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• zapasowo emoji tożsamości agenta (agents.list[].identity.emoji, w przeciwnym razie ”👀”)

• Slack oczekuje shortcode’ów (na przykład "eyes").
• Użyj "", aby wyłączyć reakcję dla konta Slack lub globalnie.

​

Strumieniowanie tekstu

• off: wyłącz strumieniowanie podglądu na żywo.
• partial (domyślnie): zastąp tekst podglądu najnowszym częściowym wynikiem.
• block: dodawaj porcjowane aktualizacje podglądu.
• progress: pokazuj tekst statusu postępu podczas generowania, a następnie wyślij końcowy tekst.

• Aby natywne strumieniowanie tekstu było widoczne, musi być dostępny wątek odpowiedzi. Wybór wątku nadal podlega replyToMode. Bez niego używany jest zwykły roboczy podgląd.
• Media i ładunki inne niż tekst wracają do zwykłego dostarczania.
• Jeśli strumieniowanie nie powiedzie się w trakcie odpowiedzi, OpenClaw wraca do zwykłego dostarczania pozostałych ładunków.

{
  channels: {
    slack: {
      streaming: "partial",
      nativeStreaming: false,
    },
  },
}

• channels.slack.streamMode (replace | status_final | append) jest automatycznie migrowane do channels.slack.streaming.
• logiczne channels.slack.streaming jest automatycznie migrowane do channels.slack.nativeStreaming.

​

Zapasowa reakcja pisania

• channels.slack.accounts.<accountId>.typingReaction
• channels.slack.typingReaction

• Slack oczekuje shortcode’ów (na przykład "hourglass_flowing_sand").
• Reakcja jest podejmowana w trybie best-effort, a próba wyczyszczenia następuje automatycznie po odpowiedzi lub po zakończeniu ścieżki błędu.

​

Media, porcjowanie i dostarczanie

​

Polecenia i zachowanie poleceń slash

• Natywny tryb automatyczny poleceń jest wyłączony dla Slacka (commands.native: "auto" nie włącza natywnych poleceń Slacka).
• Włącz natywne obsługiwacze poleceń Slacka za pomocą channels.slack.commands.native: true (lub globalnego commands.native: true).
• Gdy natywne polecenia są włączone, zarejestruj pasujące polecenia slash w Slacku (nazwy /<command>), z jednym wyjątkiem:
  • zarejestruj /agentstatus dla polecenia statusu (Slack rezerwuje /status)
• Jeśli natywne polecenia nie są włączone, możesz uruchamiać pojedyncze skonfigurowane polecenie slash przez channels.slack.slashCommand.
• Natywne menu argumentów dostosowują teraz strategię renderowania:
  • do 5 opcji: bloki przycisków
  • 6-100 opcji: statyczne menu wyboru
  • ponad 100 opcji: wybór zewnętrzny z asynchronicznym filtrowaniem opcji, gdy dostępne są obsługiwacze opcji interaktywności
  • jeśli zakodowane wartości opcji przekroczą limity Slacka, przepływ wraca do przycisków
• Dla długich ładunków opcji menu argumentów poleceń slash używają okna potwierdzenia przed wysłaniem wybranej wartości.

• enabled: false
• name: "openclaw"
• sessionPrefix: "slack:slash"
• ephemeral: true

• agent:<agentId>:slack:slash:<userId>

​

Odpowiedzi interaktywne

{
  channels: {
    slack: {
      capabilities: {
        interactiveReplies: true,
      },
    },
  },
}

{
  channels: {
    slack: {
      accounts: {
        ops: {
          capabilities: {
            interactiveReplies: true,
          },
        },
      },
    },
  },
}

• [[slack_buttons: Approve:approve, Reject:reject]]
• [[slack_select: Choose a target | Canary:canary, Production:production]]

• Jest to interfejs specyficzny dla Slacka. Inne kanały nie tłumaczą dyrektyw Slack Block Kit na własne systemy przycisków.
• Wartości interaktywnych callbacków to nieprzezroczyste tokeny generowane przez OpenClaw, a nie surowe wartości tworzone przez agenta.
• Jeśli wygenerowane bloki interaktywne przekroczyłyby limity Slack Block Kit, OpenClaw wraca do oryginalnej odpowiedzi tekstowej zamiast wysyłać nieprawidłowy ładunek bloków.

​

Zatwierdzenia exec w Slacku

• Zatwierdzenia exec używają channels.slack.execApprovals.* do natywnego routingu wiadomości prywatnych/kanałów.
• Zatwierdzenia pluginów mogą nadal być rozstrzygane przez tę samą natywną powierzchnię przycisków Slacka, gdy żądanie już trafia do Slacka, a rodzaj identyfikatora zatwierdzenia to plugin:.
• Autoryzacja zatwierdzających nadal jest egzekwowana: tylko użytkownicy zidentyfikowani jako zatwierdzający mogą zatwierdzać lub odrzucać żądania przez Slack.

• channels.slack.execApprovals.enabled
• channels.slack.execApprovals.approvers (opcjonalne; gdy to możliwe, wraca do commands.ownerAllowFrom)
• channels.slack.execApprovals.target (dm | channel | both, domyślnie: dm)
• agentFilter, sessionFilter

{
  commands: {
    ownerAllowFrom: ["slack:U12345678"],
  },
}

{
  channels: {
    slack: {
      execApprovals: {
        enabled: true,
        approvers: ["U12345678"],
        target: "both",
      },
    },
  },
}

​

Zdarzenia i zachowanie operacyjne

• Edycje/usunięcia wiadomości i rozgłoszenia wątków są mapowane na zdarzenia systemowe.
• Zdarzenia dodania/usunięcia reakcji są mapowane na zdarzenia systemowe.
• Zdarzenia dołączenia/opuszczenia członka, utworzenia/zmiany nazwy kanału oraz dodania/usunięcia pinezki są mapowane na zdarzenia systemowe.
• channel_id_changed może migrować klucze konfiguracji kanału, gdy włączone jest configWrites.
• Metadane tematu/celu kanału są traktowane jako niezaufany kontekst i mogą być wstrzykiwane do kontekstu routingu.
• Inicjator wątku i początkowe zasiewanie kontekstu historii wątku są filtrowane według skonfigurowanych list dozwolonych nadawców, gdy ma to zastosowanie.
• Akcje bloków i interakcje modalne emitują ustrukturyzowane zdarzenia systemowe Slack interaction: ... z bogatymi polami ładunku:
  • akcje bloków: wybrane wartości, etykiety, wartości selektorów i metadane workflow_*
  • zdarzenia modalne view_submission i view_closed z kierowanymi metadanymi kanału i danymi wejściowymi formularza

​

Wskaźniki do dokumentacji konfiguracji

• Dokumentacja konfiguracji - Slack Najważniejsze pola Slacka:
  • tryb/uwierzytelnianie: mode, botToken, appToken, signingSecret, webhookPath, accounts.*
  • dostęp do wiadomości prywatnych: dm.enabled, dmPolicy, allowFrom (starsze: dm.policy, dm.allowFrom), dm.groupEnabled, dm.groupChannels
  • przełącznik zgodności: dangerouslyAllowNameMatching (tylko awaryjnie; pozostaw wyłączone, jeśli nie jest potrzebne)
  • dostęp do kanałów: groupPolicy, channels.*, channels.*.users, channels.*.requireMention
  • wątki/historia: replyToMode, replyToModeByChatType, thread.*, historyLimit, dmHistoryLimit, dms.*.historyLimit
  • dostarczanie: textChunkLimit, chunkMode, mediaMaxMb, streaming, nativeStreaming
  • operacje/funkcje: configWrites, commands.native, slashCommand.*, actions.*, userToken, userTokenReadOnly

​

Rozwiązywanie problemów

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

openclaw pairing list slack

​

Powiązane

• Parowanie
• Grupy
• Bezpieczeństwo
• Routing kanałów
• Rozwiązywanie problemów
• Konfiguracja
• Polecenia slash