Slack

Gotowe do produkcyjnego użycia w wiadomościach prywatnych i kanałach przez integracje aplikacji Slack. Domyślny tryb to Socket Mode; obsługiwane są też adresy URL żądań HTTP.

# Wybór Socket Mode albo adresów URL żądań HTTP

Oba transporty są gotowe do produkcyjnego użycia i osiągają parytet funkcji dla wiadomości, poleceń slash, App Home oraz interaktywności. Wybierz na podstawie kształtu wdrożenia, nie funkcji.

# Szybka konfiguracja

{
"display_information": {
"name": "OpenClaw",
"description": "Slack connector for OpenClaw"
},
"features": {
"bot_user": { "display_name": "OpenClaw", "always_online": true },
"app_home": {
"home_tab_enabled": true,
"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",
"usergroups:read",
"users:read"
]
}
},
"settings": {
"socket_mode_enabled": true,
"event_subscriptions": {
"bot_events": [
"app_home_opened",
"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"
]
}
}
}

{
"display_information": {
"name": "OpenClaw",
"description": "Slack connector for OpenClaw"
},
"features": {
"bot_user": { "display_name": "OpenClaw", "always_online": true },
"app_home": {
"home_tab_enabled": true,
"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",
"groups:history",
"groups:read",
"im:history",
"im:read",
"im:write",
"users:read"
]
}
},
"settings": {
"socket_mode_enabled": true,
"event_subscriptions": {
"bot_events": [
"app_home_opened",
"app_mention",
"message.channels",
"message.groups",
"message.im"
]
}
}
}

export SLACK_APP_TOKEN=xapp-...
export SLACK_BOT_TOKEN=xoxb-...
cat > slack.socket.patch.json5 <<'JSON5'
{
channels: {
slack: {
enabled: true,
mode: "socket",
appToken: { source: "env", provider: "default", id: "SLACK_APP_TOKEN" },
botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },
},
},
}
JSON5
openclaw config patch --file ./slack.socket.patch.json5 --dry-run
openclaw config patch --file ./slack.socket.patch.json5

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

openclaw gateway

{
"display_information": {
"name": "OpenClaw",
"description": "Slack connector for OpenClaw"
},
"features": {
"bot_user": { "display_name": "OpenClaw", "always_online": true },
"app_home": {
"home_tab_enabled": true,
"messages_tab_enabled": true,
"messages_tab_read_only_enabled": false
},
"slash_commands": [
{
"command": "/openclaw",
"description": "Send a message to OpenClaw",
"should_escape": false,
"url": "https://gateway-host.example.com/slack/events"
}
]
},
"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",
"usergroups:read",
"users:read"
]
}
},
"settings": {
"event_subscriptions": {
"request_url": "https://gateway-host.example.com/slack/events",
"bot_events": [
"app_home_opened",
"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"
]
},
"interactivity": {
"is_enabled": true,
"request_url": "https://gateway-host.example.com/slack/events",
"message_menu_options_url": "https://gateway-host.example.com/slack/events"
}
}
}

{
"display_information": {
"name": "OpenClaw",
"description": "Slack connector for OpenClaw"
},
"features": {
"bot_user": { "display_name": "OpenClaw", "always_online": true },
"app_home": {
"home_tab_enabled": true,
"messages_tab_enabled": true,
"messages_tab_read_only_enabled": false
},
"slash_commands": [
{
"command": "/openclaw",
"description": "Send a message to OpenClaw",
"should_escape": false,
"url": "https://gateway-host.example.com/slack/events"
}
]
},
"oauth_config": {
"scopes": {
"bot": [
"app_mentions:read",
"assistant:write",
"channels:history",
"channels:read",
"chat:write",
"commands",
"groups:history",
"groups:read",
"im:history",
"im:read",
"im:write",
"users:read"
]
}
},
"settings": {
"event_subscriptions": {
"request_url": "https://gateway-host.example.com/slack/events",
"bot_events": [
"app_home_opened",
"app_mention",
"message.channels",
"message.groups",
"message.im"
]
},
"interactivity": {
"is_enabled": true,
"request_url": "https://gateway-host.example.com/slack/events",
"message_menu_options_url": "https://gateway-host.example.com/slack/events"
}
}
}

export SLACK_BOT_TOKEN=xoxb-...
export SLACK_SIGNING_SECRET=...
cat > slack.http.patch.json5 <<'JSON5'
{
channels: {
slack: {
enabled: true,
mode: "http",
botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },
signingSecret: { source: "env", provider: "default", id: "SLACK_SIGNING_SECRET" },
webhookPath: "/slack/events",
},
},
}
JSON5
openclaw config patch --file ./slack.http.patch.json5 --dry-run
openclaw config patch --file ./slack.http.patch.json5

openclaw gateway

# Dostrajanie transportu w trybie Socket Mode

OpenClaw domyślnie ustawia limit czasu pong klienta Slack SDK na 15 sekund dla trybu Socket Mode. Nadpisuj ustawienia transportu tylko wtedy, gdy potrzebujesz dostrojenia specyficznego dla obszaru roboczego lub hosta:

{
  channels: {
    slack: {
      mode: "socket",
      socketMode: {
        clientPingTimeout: 20000,
        serverPingTimeout: 30000,
        pingPongLoggingEnabled: false,
      },
    },
  },
}

Używaj tego tylko w obszarach roboczych Socket Mode, które rejestrują limity czasu pong WebSocket Slack lub server-ping, albo działają na hostach ze znanym problemem głodzenia pętli zdarzeń. clientPingTimeout to czas oczekiwania na pong po wysłaniu przez SDK pingu klienta; serverPingTimeout to czas oczekiwania na pingi serwera Slack. Wiadomości i zdarzenia aplikacji pozostają stanem aplikacji, a nie sygnałami żywotności transportu.

# Lista kontrolna manifestu i zakresów

Podstawowy manifest aplikacji Slack jest taki sam dla Socket Mode i adresów URL żądań HTTP. Różni się tylko blok settings (oraz url polecenia ukośnikowego).

Podstawowy manifest (domyślny Socket Mode):

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Slack connector for OpenClaw"
  },
  "features": {
    "bot_user": { "display_name": "OpenClaw", "always_online": true },
    "app_home": {
      "home_tab_enabled": true,
      "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",
        "usergroups:read",
        "users:read"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_home_opened",
        "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"
      ]
    }
  }
}

Dla trybu adresów URL żądań HTTP zastąp settings wariantem HTTP i dodaj url do każdego polecenia ukośnikowego. Wymagany jest publiczny URL:

{
  "features": {
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Send a message to OpenClaw",
        "should_escape": false,
        "url": "https://gateway-host.example.com/slack/events"
      }
    ]
  },
  "settings": {
    "event_subscriptions": {
      "request_url": "https://gateway-host.example.com/slack/events",
      "bot_events": [
        "app_home_opened",
        "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"
      ]
    },
    "interactivity": {
      "is_enabled": true,
      "request_url": "https://gateway-host.example.com/slack/events",
      "message_menu_options_url": "https://gateway-host.example.com/slack/events"
    }
  }
}

# Dodatkowe ustawienia manifestu

Udostępniaj różne funkcje rozszerzające powyższe wartości domyślne.

Domyślny manifest włącza kartę Home w Slack App Home i subskrybuje app_home_opened. Gdy członek obszaru roboczego otworzy kartę Home, OpenClaw publikuje bezpieczny domyślny widok Home za pomocą views.publish; ładunek konwersacji ani prywatna konfiguracja nie są dołączane. Karta Messages pozostaje włączona dla wiadomości DM Slack.

{
"slash_commands": [
{
"command": "/new",
"description": "Start a new session",
"usage_hint": "[model]"
},
{
"command": "/reset",
"description": "Reset the current session"
},
{
"command": "/compact",
"description": "Compact the session context",
"usage_hint": "[instructions]"
},
{
"command": "/stop",
"description": "Stop the current run"
},
{
"command": "/session",
"description": "Manage thread-binding expiry",
"usage_hint": "idle <duration|off> or max-age <duration|off>"
},
{
"command": "/think",
"description": "Set the thinking level",
"usage_hint": "<level>"
},
{
"command": "/verbose",
"description": "Toggle verbose output",
"usage_hint": "on|off|full"
},
{
"command": "/fast",
"description": "Show or set fast mode",
"usage_hint": "[status|on|off]"
},
{
"command": "/reasoning",
"description": "Toggle reasoning visibility",
"usage_hint": "[on|off|stream]"
},
{
"command": "/elevated",
"description": "Toggle elevated mode",
"usage_hint": "[on|off|ask|full]"
},
{
"command": "/exec",
"description": "Show or set exec defaults",
"usage_hint": "host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>"
},
{
"command": "/model",
"description": "Show or set the model",
"usage_hint": "[name|#|status]"
},
{
"command": "/models",
"description": "List providers/models",
"usage_hint": "[provider] [page] [limit=<n>|size=<n>|all]"
},
{
"command": "/help",
"description": "Show the short help summary"
},
{
"command": "/commands",
"description": "Show the generated command catalog"
},
{
"command": "/tools",
"description": "Show what the current agent can use right now",
"usage_hint": "[compact|verbose]"
},
{
"command": "/agentstatus",
"description": "Show runtime status, including provider usage/quota when available"
},
{
"command": "/tasks",
"description": "List active/recent background tasks for the current session"
},
{
"command": "/context",
"description": "Explain how context is assembled",
"usage_hint": "[list|detail|json]"
},
{
"command": "/whoami",
"description": "Show your sender identity"
},
{
"command": "/skill",
"description": "Run a skill by name",
"usage_hint": "<name> [input]"
},
{
"command": "/btw",
"description": "Ask a side question without changing session context",
"usage_hint": "<question>"
},
{
"command": "/side",
"description": "Ask a side question without changing session context",
"usage_hint": "<question>"
},
{
"command": "/usage",
"description": "Control the usage footer or show cost summary",
"usage_hint": "off|tokens|full|cost"
}
]
}

{
"slash_commands": [
{
"command": "/new",
"description": "Start a new session",
"usage_hint": "[model]",
"url": "https://gateway-host.example.com/slack/events"
},
{
"command": "/help",
"description": "Show the short help summary",
"url": "https://gateway-host.example.com/slack/events"
}
]
}

# 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 albo obiekty SecretRef.
• Tokeny w konfiguracji zastępują rezerwowe wartości ze zmiennych środowiskowych.
• Rezerwowe zmienne środowiskowe SLACK_BOT_TOKEN / SLACK_APP_TOKEN mają zastosowanie tylko do konta domyślnego.
• userToken (xoxp-...) jest dostępny tylko w konfiguracji (bez rezerwowej zmiennej środowiskowej) i domyślnie działa tylko do odczytu (userTokenReadOnly: true).

Zachowanie migawki statusu:

• Inspekcja konta Slack śledzi pola *Source i *Status dla poszczególnych poświadczeń (botToken, appToken, signingSecret, userToken).
• Status to available, configured_unavailable albo missing.
• configured_unavailable oznacza, że konto jest skonfigurowane przez SecretRef albo inne nieosadzone źródło sekretu, ale bieżąca ścieżka polecenia/środowiska uruchomieniowego nie mogła rozwiązać rzeczywistej wartości.
• W trybie HTTP uwzględniane jest signingSecretStatus; w Socket Mode wymagana para to botTokenStatus + appTokenStatus.

# Akcje i bramki

Akcje Slack są kontrolowane przez channels.slack.actions.*.

Dostępne grupy akcji w bieżących narzędziach Slack:

Bieżące akcje wiadomości Slack obejmują send, upload-file, download-file, read, edit, delete, pin, unpin, list-pins, member-info i emoji-list. download-file akceptuje identyfikatory plików Slack widoczne w przychodzących placeholderach plików i zwraca podglądy obrazów dla obrazów albo metadane pliku lokalnego dla innych typów plików.

# Kontrola dostępu i trasowanie

# Wątki, sesje i tagi odpowiedzi

• DM są trasowane jako direct; kanały jako channel; MPIM jako group.
• Powiązania tras Slack akceptują surowe identyfikatory partnerów oraz formy docelowe Slack, takie jak channel:C12345678, user:U12345678 i <@U12345678>.
• Przy domyślnym session.dmScope=main DM Slack są zwijane do głównej sesji agenta.
• Sesje kanałów: agent:<agentId>:slack:channel:<channelId>.
• Odpowiedzi w wątkach mogą tworzyć sufiksy sesji wątków (:thread:<threadTs>), gdy 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ątku jest pobieranych, gdy rozpoczyna się nowa sesja wątku (domyślnie 20; ustaw 0, aby wyłączyć).
• channels.slack.thread.requireExplicitMention (domyślnie false): gdy ma wartość true, tłumi niejawne wzmianki w wątku, więc bot odpowiada tylko na jawne wzmianki @bot wewnątrz wątków, nawet gdy bot już uczestniczył w wątku. Bez tego odpowiedzi w wątku z udziałem bota omijają bramkowanie requireMention.

Kontrole wątkowania odpowiedzi:

• channels.slack.replyToMode: off|first|all|batched (domyślnie off)
• channels.slack.replyToModeByChatType: per direct|group|channel
• starsza wartość rezerwowa dla czatów bezpośrednich: channels.slack.dm.replyToMode

Obsługiwane są ręczne tagi odpowiedzi:

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

# Reakcje potwierdzenia

ackReaction wysyła emoji potwierdzenia, gdy OpenClaw przetwarza wiadomość przychodzącą.

Kolejność rozwiązywania:

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

Uwagi:

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

# Strumieniowanie tekstu

channels.slack.streaming kontroluje zachowanie podglądu na żywo:

• off: wyłącza strumieniowanie podglądu na żywo.
• partial (domyślnie): zastępuje tekst podglądu najnowszym częściowym wynikiem.
• block: dołącza porcjowane aktualizacje podglądu.
• progress: pokazuje tekst statusu postępu podczas generowania, a następnie wysyła finalny tekst.
• streaming.preview.toolProgress: gdy aktywny jest podgląd wersji roboczej, kieruje aktualizacje narzędzi/postępu do tej samej edytowanej wiadomości podglądu (domyślnie: true). Ustaw false, aby zachować osobne wiadomości narzędzi/postępu.
• streaming.preview.commandText / streaming.progress.commandText: ustaw na status, aby zachować zwarte linie postępu narzędzi, ukrywając surowy tekst polecenia/exec (domyślnie: raw).

Ukryj surowy tekst polecenia/exec, zachowując zwarte linie postępu:

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

channels.slack.streaming.nativeTransport kontroluje natywne strumieniowanie tekstu Slack, gdy channels.slack.streaming.mode to partial (domyślnie: true).

• Aby natywne strumieniowanie tekstu i status wątku asystenta Slack były widoczne, musi być dostępny wątek odpowiedzi. Wybór wątku nadal podąża za replyToMode.
• Kanał, czat grupowy i główne korzenie DM nadal mogą używać zwykłego podglądu wersji roboczej, gdy natywne strumieniowanie jest niedostępne albo nie istnieje wątek odpowiedzi.
• Główne DM Slack domyślnie pozostają poza wątkiem, więc nie pokazują natywnego podglądu strumienia/statusu Slack w stylu wątku; zamiast tego OpenClaw publikuje i edytuje podgląd wersji roboczej w DM.
• Media i ładunki nietekstowe wracają do zwykłego dostarczania.
• Finalne media/błędy anulują oczekujące edycje podglądu; kwalifikujące się finalne teksty/bloki są opróżniane tylko wtedy, gdy mogą edytować podgląd w miejscu.
• Jeśli strumieniowanie nie powiedzie się w trakcie odpowiedzi, OpenClaw wraca do zwykłego dostarczania pozostałych ładunków.

Użyj podglądu wersji roboczej zamiast natywnego strumieniowania tekstu Slack:

{
  channels: {
    slack: {
      streaming: {
        mode: "partial",
        nativeTransport: false,
      },
    },
  },
}

Starsze klucze:

• channels.slack.streamMode (replace | status_final | append) to starszy alias runtime dla channels.slack.streaming.mode.
• wartość logiczna channels.slack.streaming to starszy alias runtime dla channels.slack.streaming.mode i channels.slack.streaming.nativeTransport.
• starsze channels.slack.nativeStreaming to alias runtime dla channels.slack.streaming.nativeTransport.
• Uruchom openclaw doctor --fix, aby przepisać utrwaloną konfigurację strumieniowania Slack do kanonicznych kluczy.

# Awaryjna reakcja pisania

typingReaction dodaje tymczasową reakcję do przychodzącej wiadomości Slack, gdy OpenClaw przetwarza odpowiedź, a następnie usuwa ją po zakończeniu przebiegu. Jest to najbardziej przydatne poza odpowiedziami w wątkach, które używają domyślnego wskaźnika stanu „is typing...”.

Kolejność rozstrzygania:

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

Uwagi:

• Slack oczekuje krótkich kodów (na przykład "hourglass_flowing_sand").
• Reakcja działa w trybie best-effort, a czyszczenie jest automatycznie podejmowane po ukończeniu ścieżki odpowiedzi lub niepowodzenia.

# Media, dzielenie na fragmenty i dostarczanie

# Polecenia i zachowanie slash

Polecenia slash pojawiają się w Slack jako pojedyncze skonfigurowane polecenie albo wiele poleceń natywnych. Skonfiguruj channels.slack.slashCommand, aby zmienić domyślne ustawienia poleceń:

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

/openclaw /help

Polecenia natywne wymagają dodatkowych ustawień manifestu w aplikacji Slack i zamiast tego są włączane przez channels.slack.commands.native: true lub commands.native: true w konfiguracjach globalnych.

• Automatyczny tryb poleceń natywnych jest dla Slack wyłączony, więc commands.native: "auto" nie włącza natywnych poleceń Slack.

/help

Menu argumentów natywnych używają adaptacyjnej strategii renderowania, która pokazuje modal potwierdzenia przed wysłaniem wybranej wartości opcji:

• do 5 opcji: bloki przycisków
• 6-100 opcji: statyczne menu wyboru
• więcej niż 100 opcji: zewnętrzny wybór z asynchronicznym filtrowaniem opcji, gdy dostępne są procedury obsługi opcji interaktywności
• przekroczone limity Slack: zakodowane wartości opcji wracają do przycisków

/think

Sesje slash używają izolowanych kluczy, takich jak agent:<agentId>:slack:slash:<userId>, i nadal kierują wykonania poleceń do docelowej sesji konwersacji za pomocą CommandTargetSessionKey.

# Interaktywne odpowiedzi

Slack może renderować kontrolki interaktywnych odpowiedzi utworzone przez agenta, ale ta funkcja jest domyślnie wyłączona.

Włącz ją globalnie:

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

Albo włącz ją tylko dla jednego konta Slack:

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

Po włączeniu agenci mogą emitować dyrektywy odpowiedzi tylko dla Slack:

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

Te dyrektywy kompilują się do Slack Block Kit i kierują kliknięcia lub wybory z powrotem przez istniejącą ścieżkę zdarzeń interakcji Slack.

Uwagi:

• To interfejs użytkownika specyficzny dla Slack. Inne kanały nie tłumaczą dyrektyw Slack Block Kit na własne systemy przycisków.
• Wartości wywołań zwrotnych interaktywnych 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 Slack

Slack może działać jako natywny klient zatwierdzania z interaktywnymi przyciskami i interakcjami, zamiast wracać do interfejsu WWW lub terminala.

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

Używa to tej samej współdzielonej powierzchni przycisków zatwierdzania co inne kanały. Gdy interactivity jest włączone w ustawieniach aplikacji Slack, monity zatwierdzania renderują się jako przyciski Block Kit bezpośrednio w konwersacji. Gdy te przyciski są obecne, są podstawowym UX zatwierdzania; OpenClaw powinien zawierać ręczne polecenie /approve tylko wtedy, gdy wynik narzędzia mówi, że zatwierdzenia czatu są niedostępne albo ręczne zatwierdzenie jest jedyną ścieżką.

Ścieżka konfiguracji:

• 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

Slack automatycznie włącza natywne zatwierdzenia exec, gdy enabled jest nieustawione lub ma wartość "auto" i uda się rozstrzygnąć co najmniej jednego zatwierdzającego. Ustaw enabled: false, aby jawnie wyłączyć Slack jako natywnego klienta zatwierdzania. Ustaw enabled: true, aby wymusić natywne zatwierdzenia, gdy zatwierdzający zostaną rozstrzygnięci.

Domyślne zachowanie bez jawnej konfiguracji zatwierdzania exec Slack:

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

Jawna konfiguracja natywna Slack jest potrzebna tylko wtedy, gdy chcesz nadpisać zatwierdzających, dodać filtry albo włączyć dostarczanie do czatu źródłowego:

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

Wspólne przekazywanie approvals.exec jest oddzielne. Używaj go tylko wtedy, gdy monity zatwierdzania exec muszą być również kierowane do innych czatów lub jawnych celów poza pasmem. Wspólne przekazywanie approvals.plugin także jest oddzielne; natywne przyciski Slack nadal mogą rozstrzygać zatwierdzenia Plugin, gdy te żądania już trafiają do Slack.

Same-chat /approve działa również w kanałach Slack i wiadomościach DM, które już obsługują polecenia. Zobacz Zatwierdzenia exec, aby poznać pełny model przekazywania zatwierdzeń.

# Zdarzenia i zachowanie operacyjne

• Edycje/usunięcia wiadomości są mapowane na zdarzenia systemowe.
• Emisje z wątków („Also send to channel” w odpowiedziach w wątkach) są przetwarzane jako zwykłe wiadomości użytkownika.
• Zdarzenia dodania/usunięcia reakcji są mapowane na zdarzenia systemowe.
• Dołączenie/opuszczenie przez członka, utworzenie/zmiana nazwy kanału oraz zdarzenia dodania/usunięcia przypięcia są mapowane na zdarzenia systemowe.
• channel_id_changed może migrować klucze konfiguracji kanału, gdy configWrites jest włączone.
• 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 metadanymi kierowanego kanału oraz danymi wejściowymi formularzy

# Odniesienie konfiguracji

Główne odniesienie: Odniesienie konfiguracji - Slack.

# Rozwiązywanie problemów

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

openclaw pairing list slack

# Odniesienie wizji załączników

Slack może dołączać pobrane multimedia do tury agenta, gdy pobieranie plików ze Slack powiedzie się i pozwalają na to limity rozmiaru. Pliki obrazów mogą być przekazywane przez ścieżkę rozumienia multimediów lub bezpośrednio do modelu odpowiedzi obsługującego wizję; inne pliki są zachowywane jako kontekst pliku dostępny do pobrania, a nie traktowane jako dane wejściowe obrazu.

# Obsługiwane typy multimediów

# Potok przychodzący

Gdy przychodzi wiadomość Slack z załącznikami plików:

1. OpenClaw pobiera plik z prywatnego URL Slack przy użyciu tokena bota (xoxb-...).
2. Po powodzeniu plik jest zapisywany w magazynie multimediów.
3. Ścieżki pobranych multimediów i typy zawartości są dodawane do kontekstu przychodzącego.
4. Ścieżki modeli/narzędzi obsługujących obrazy mogą używać załączników obrazów z tego kontekstu.
5. Pliki niebędące obrazami pozostają dostępne jako metadane pliku lub odwołania do multimediów dla narzędzi, które potrafią je obsłużyć.

# Dziedziczenie załączników z wiadomości głównej wątku

Gdy wiadomość przychodzi w wątku (ma nadrzędne thread_ts):

• Jeśli sama odpowiedź nie ma bezpośrednich multimediów, a dołączona wiadomość główna ma pliki, Slack może uzupełnić pliki główne jako kontekst wiadomości początkowej wątku.
• Bezpośrednie załączniki odpowiedzi mają pierwszeństwo przed załącznikami wiadomości głównej.
• Wiadomość główna, która ma tylko pliki i nie ma tekstu, jest reprezentowana placeholderem załącznika, aby mechanizm awaryjny nadal mógł uwzględnić jej pliki.

# Obsługa wielu załączników

Gdy jedna wiadomość Slack zawiera wiele załączników plików:

• Każdy załącznik jest przetwarzany niezależnie przez potok multimediów.
• Odwołania do pobranych multimediów są agregowane w kontekście wiadomości.
• Kolejność przetwarzania odpowiada kolejności plików Slack w ładunku zdarzenia.
• Niepowodzenie pobierania jednego załącznika nie blokuje pozostałych.

# Limity rozmiaru, pobierania i modelu

• Limit rozmiaru: Domyślnie 20 MB na plik. Konfigurowalne przez channels.slack.mediaMaxMb.
• Niepowodzenia pobierania: Pliki, których Slack nie może udostępnić, wygasłe adresy URL, niedostępne pliki, zbyt duże pliki oraz odpowiedzi HTML logowania/autoryzacji Slack są pomijane zamiast zgłaszane jako nieobsługiwane formaty.
• Model wizyjny: Analiza obrazu używa aktywnego modelu odpowiedzi, gdy obsługuje on wizję, albo modelu obrazu skonfigurowanego w agents.defaults.imageModel.

# Znane ograniczenia

# Powiązana dokumentacja

• Potok rozumienia multimediów
• Narzędzie PDF
• Epik: #51349 — włączenie wizji dla załączników Slack
• Testy regresji: #51353
• Weryfikacja na żywo: #51354

# Powiązane