Slack

Gotowe do produkcyjnego użycia w wiadomościach prywatnych i kanałach dzięki integracjom aplikacji Slack. Domyślnym trybem jest Socket Mode; obsługiwane są także HTTP Request URLs.

Wybór Socket Mode albo HTTP Request URLs

Oba transporty są gotowe do użycia produkcyjnego i osiągają równoważność funkcji dla wiadomości, poleceń slash, App Home oraz interaktywności. Wybierz na podstawie kształtu wdrożenia, a 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" },},},}JSON5openclaw config patch --file ./slack.socket.patch.json5 --dry-runopenclaw 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",},},}JSON5openclaw config patch --file ./slack.http.patch.json5 --dry-runopenclaw config patch --file ./slack.http.patch.json5

openclaw gateway

Dostrajanie transportu Socket Mode

OpenClaw domyślnie ustawia limit czasu odpowiedzi pong klienta Slack SDK na 15 sekund dla 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 logują przekroczenia limitu czasu pong/websocket server-ping Slack albo działają na hostach ze znanym głodzeniem 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 HTTP Request URLs. Różni się tylko blok settings (oraz url polecenia slash).

Podstawowy manifest (domyślnie 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"      ]    }  }}

W trybie HTTP Request URLs zastąp settings wariantem HTTP i dodaj url do każdego polecenia slash. Wymagany 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ępnij różne funkcje, które rozszerzają powyższe wartości domyślne.

Domyślny manifest włącza kartę Home 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; nie zawiera on payloadu konwersacji ani prywatnej konfiguracji. Karta Messages pozostaje włączona dla 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 przyjmują jawny tekst ciągi znaków albo obiekty SecretRef.
• Tokeny z konfiguracji zastępują rezerwowe wartości env.
• Rezerwowe wartości env SLACK_BOT_TOKEN / SLACK_APP_TOKEN dotyczą tylko konta domyślnego.
• userToken (xoxp-...) jest dostępny wyłącznie w konfiguracji (bez rezerwowej wartości env) i domyślnie ma zachowanie tylko do odczytu (userTokenReadOnly: true).

Zachowanie migawki stanu:

• Inspekcja konta Slack śledzi pola *Source i *Status dla poszczególnych poświadczeń (botToken, appToken, signingSecret, userToken).
• Stan to available, configured_unavailable albo 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ę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 przyjmuje identyfikatory plików Slack widoczne w przychodzących placeholderach plików i zwraca podglądy obrazów dla obrazów albo metadane plików lokalnych dla innych typów plików.

Kontrola dostępu i routing

Wątki, sesje i tagi odpowiedzi

• DM są routowane jako direct; kanały jako channel; MPIM jako group.
• Wiązania tras Slack przyjmują surowe identyfikatory peerów oraz formy celów 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ątku (:thread:<threadTs>), gdy ma to zastosowanie.
• W kanałach, w których OpenClaw obsługuje wiadomości najwyższego poziomu bez wymagania jawnej wzmianki, replyToMode inne niż off routuje każdy obsłużony korzeń do agent:<agentId>:slack:channel:<channelId>:thread:<rootTs>, dzięki czemu widoczny wątek Slack mapuje się na jedną sesję OpenClaw od pierwszej tury.
• 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 po rozpoczęciu nowej sesji wątku (domyślnie 20; ustaw 0, aby wyłączyć).
• channels.slack.thread.requireExplicitMention (domyślnie false): gdy true, tłumi niejawne wzmianki w wątku, aby bot odpowiadał tylko na jawne wzmianki @bot w wątkach, nawet jeśli bot już uczestniczył w wątku. Bez tego odpowiedzi w wątku, w którym uczestniczył bot, omijają bramkę requireMention.

Kontrole wątkowania odpowiedzi:

• channels.slack.replyToMode: off|first|all|batched (domyślnie off)
• channels.slack.replyToModeByChatType: dla poszczególnych 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>]]

Dla jawnych odpowiedzi w wątku Slack z narzędzia message ustaw replyBroadcast: true z action: "send" oraz threadId albo replyTo, aby poprosić Slack o dodatkowe nadanie odpowiedzi w wątku do kanału nadrzędnego. Mapuje się to na flagę reply_broadcast Slack chat.postMessage i jest obsługiwane tylko dla wysyłek tekstu albo Block Kit, a nie dla przesyłania mediów.

Gdy wywołanie narzędzia message działa wewnątrz wątku Slack i celuje w ten sam kanał, OpenClaw zwykle dziedziczy bieżący wątek Slack zgodnie z replyToMode. Ustaw topLevel: true przy action: "send" albo action: "upload-file", aby wymusić nową wiadomość w kanale nadrzędnym. threadId: null jest akceptowane jako ten sam wybór najwyższego poziomu.

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 shortcode'ó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łącz strumieniowanie podglądu na żywo.
• partial (domyślnie): zastępuj tekst podglądu najnowszym częściowym wynikiem.
• block: dołączaj porcjowane aktualizacje podglądu.
• progress: pokazuj tekst stanu postępu podczas generowania, a następnie wyślij tekst końcowy.
• streaming.preview.toolProgress: gdy podgląd wersji roboczej jest aktywny, kieruj aktualizacje narzędzi/postępu do tej samej edytowanej wiadomości podglądu (domyślnie: true). Ustaw false, aby zachować oddzielne wiadomości narzędzi/postępu.
• streaming.preview.commandText / streaming.progress.commandText: ustaw na status, aby zachować zwięzłe wiersze postępu narzędzi, ukrywając surowy tekst polecenia/wykonania (domyślnie: raw).

Ukryj surowy tekst polecenia/wykonania, zachowując zwięzłe wiersze 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 ma wartość partial (domyślnie: true).

• Wątek odpowiedzi musi być dostępny, aby pojawiło się natywne strumieniowanie tekstu i status wątku asystenta Slack. Wybór wątku nadal odbywa się zgodnie z replyToMode.
• Korzenie kanałów, czatów grupowych i DM najwyższego poziomu mogą nadal używać normalnego podglądu szkicu, gdy natywne strumieniowanie jest niedostępne albo nie istnieje żaden wątek odpowiedzi.
• DM Slack najwyższego poziomu domyślnie pozostają poza wątkiem, więc nie pokazują natywnego podglądu strumienia/statusu w stylu wątku Slack; zamiast tego OpenClaw publikuje i edytuje podgląd szkicu w DM.
• Media i ładunki nietekstowe wracają do normalnego dostarczania.
• Finalne komunikaty mediów/błędów anulują oczekujące edycje podglądu; kwalifikujące się finalne komunikaty tekstowe/blokowe są opróżniane tylko wtedy, gdy mogą edytować podgląd w miejscu.
• Jeśli strumieniowanie nie powiedzie się w trakcie odpowiedzi, OpenClaw wraca do normalnego dostarczania pozostałych ładunków.

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

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

Starsze klucze:

• channels.slack.streamMode (replace | status_final | append) jest starszym aliasem środowiska uruchomieniowego dla channels.slack.streaming.mode.
• boolean channels.slack.streaming jest starszym aliasem środowiska uruchomieniowego dla channels.slack.streaming.mode i channels.slack.streaming.nativeTransport.
• starszy channels.slack.nativeStreaming jest aliasem środowiska uruchomieniowego dla channels.slack.streaming.nativeTransport.
• Uruchom openclaw doctor --fix, aby przepisać utrwaloną konfigurację strumieniowania Slack na kanoniczne klucze.

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 uruchomienia. Jest to najbardziej przydatne poza odpowiedziami w wątku, które używają domyślnego wskaźnika statusu „pisze...”.

Kolejność rozwiązywania:

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

Uwagi:

• Slack oczekuje shortcodes, na przykład "hourglass_flowing_sand".
• Reakcja działa w trybie best-effort, a czyszczenie jest podejmowane automatycznie po zakończeniu ścieżki odpowiedzi lub niepowodzenia.

Media, dzielenie na fragmenty i dostarczanie

Polecenia i zachowanie slash

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

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

/openclaw /help

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

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

/help

Natywne menu argumentów 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ą handlery 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 sesji konwersacji docelowej przy użyciu CommandTargetSessionKey.

Interaktywne odpowiedzi

Slack może renderować kontrolki interaktywnych odpowiedzi tworzone 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 albo wybory z powrotem przez istniejącą ścieżkę zdarzeń interakcji Slack.

Uwagi:

• To jest 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 interakcji są nieprzezroczystymi tokenami generowanymi przez OpenClaw, a nie surowymi wartościami tworzonymi przez agenta.
• Jeśli wygenerowane interaktywne bloki 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 zatwierdzeń z interaktywnymi przyciskami i interakcjami, zamiast wracać do Web UI albo terminala.

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

Używa to tej samej współdzielonej powierzchni przycisków zatwierdzeń co inne kanały. Gdy interactivity jest włączone w ustawieniach aplikacji Slack, monity zatwierdzeń renderują się jako przyciski Block Kit bezpośrednio w konwersacji. Gdy te przyciski są obecne, stanowią podstawowy UX zatwierdzania; OpenClaw powinien dołączać 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; wraca do commands.ownerAllowFrom, gdy to możliwe)
• channels.slack.execApprovals.target (dm | channel | both, domyślnie: dm)
• agentFilter, sessionFilter

Slack automatycznie włącza natywne zatwierdzenia exec, gdy enabled jest nieustawione albo ma wartość "auto" i co najmniej jeden zatwierdzający zostanie rozwiązany. Ustaw enabled: false, aby jawnie wyłączyć Slack jako natywnego klienta zatwierdzeń. Ustaw enabled: true, aby wymusić natywne zatwierdzenia, gdy zatwierdzający zostaną rozwiązani.

Domyślne zachowanie bez jawnej konfiguracji zatwierdzeń exec Slack:

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

Jawna konfiguracja natywna dla 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ółdzielone przekazywanie approvals.exec jest osobne. Używaj go tylko wtedy, gdy monity zatwierdzeń exec muszą także kierować do innych czatów albo jawnych celów poza pasmem. Współdzielone przekazywanie approvals.plugin również jest osobne; natywne przyciski Slack mogą nadal rozwiązywać zatwierdzenia Plugin, gdy te żądania już trafiają do Slack.

/approve w tym samym czacie działa również w kanałach Slack i 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 wątków („Wyślij także do kanału” dla odpowiedzi w wątku) są przetwarzane jako normalne 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ą zostać wstrzyknięte do kontekstu routingu.
• Kontekst startującego wątku i początkowej historii wątku jest filtrowany 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 pickerów oraz metadane workflow_*
  • zdarzenia modalne view_submission i view_closed z routowanymi metadanymi kanału i danymi wejściowymi formularza

Odniesienie konfiguracji

Główne odniesienie: Odniesienie konfiguracji - Slack.

Rozwiązywanie problemów

openclaw channels status --probeopenclaw logs --followopenclaw doctor

openclaw pairing list slack

Odniesienie do wizji dla załączników

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

Obsługiwane typy multimediów

Potok wejściowy

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

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

Dziedziczenie załączników z korzenia wątku

Gdy wiadomość przychodzi w wątku (ma nadrzędny 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 rozpoczęcia 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 przez placeholder załącznika, aby mechanizm awaryjny nadal mógł uwzględnić jej pliki.

Obsługa wielu załączników

Gdy pojedyncza 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 uwierzytelniania/logowania Slack są pomijane zamiast zgłaszania ich jako nieobsługiwane formaty.
• Model wizji: Analiza obrazów 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
• Epic: #51349 — włączenie wizji dla załączników Slack
• Testy regresji: #51353
• Weryfikacja na żywo: #51354

Powiązane