> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # Slack Slack 支援透過 Slack 應用程式整合涵蓋私訊與頻道。預設傳輸為 Socket Mode；也支援 HTTP Request URLs。Relay 模式適用於由受信任路由器擁有 Slack 入口的受管部署。 Slack 私訊預設使用配對模式。 原生命令行為與命令目錄。 跨頻道診斷與修復作業手冊。 ## 選擇傳輸方式 Socket Mode 和 HTTP Request URLs 在訊息、斜線命令、App Home 與互動功能上達到功能對等。請依部署型態選擇，而不是依功能選擇。 | 考量 | Socket Mode（預設） | HTTP Request URLs | | -------------- | ---------------------------------------------------------------------------- | -------------------------------------------------------- | | 公開閘道 URL | 不需要 | 需要（DNS、TLS、反向代理或通道） | | 對外網路 | 必須可連線到 `wss-primary.slack.com` 的對外 WSS | 無對外 WS；僅需對內 HTTPS | | 所需權杖 | Bot token + 具有 `connections:write` 的 App-Level Token | Bot token + Signing Secret | | 開發筆電 / 位於防火牆後方 | 可直接運作 | 需要公開通道（ngrok、Cloudflare Tunnel、Tailscale Funnel）或預備環境閘道 | | 水平擴展 | 每個應用程式在每台主機上一個 Socket Mode 工作階段；多個閘道需要獨立的 Slack 應用程式 | 無狀態 POST 處理常式；多個閘道複本可在負載平衡器後方共用一個應用程式 | | 單一閘道上的多帳號 | 支援；每個帳號開啟自己的 WS | 支援；每個帳號都需要唯一的 `webhookPath`（預設 `/slack/events`），避免註冊互相衝突 | | 斜線命令傳輸 | 透過 WS 連線傳送；`slash_commands[].url` 會被忽略 | Slack 會 POST 到 `slash_commands[].url`；必須提供該欄位，命令才會分派 | | 請求簽署 | 不使用（驗證由 App-Level Token 處理） | Slack 會簽署每個請求；OpenClaw 使用 `signingSecret` 驗證 | | 連線中斷復原 | Slack SDK 已啟用自動重新連線；OpenClaw 也會以有界退避重新啟動失敗的 Socket Mode 工作階段。套用 Pong 逾時傳輸調校。 | 沒有可中斷的持續連線；重試由 Slack 逐請求執行 | **選擇 Socket Mode** 用於單一閘道主機、開發筆電，以及可對外連線至 `*.slack.com` 但無法接受對內 HTTPS 的內部部署網路。 **選擇 HTTP Request URLs** 用於在負載平衡器後方執行多個閘道複本、對外 WSS 被封鎖但允許對內 HTTPS，或你已在反向代理終止 Slack 網路鉤子的情況。 Slack 可以為同一個應用程式維持多個 Socket Mode 連線，並可能將每個承載內容傳送到任何連線。因此，共用同一個 Slack 應用程式的不同 OpenClaw 閘道需要等效的路由與授權設定。否則，請為每個閘道使用獨立的 Slack 應用程式、單一 relay 入口，或在負載平衡器後方使用 HTTP Request URLs。請參閱 [使用 Socket Mode](https://docs.slack.dev/apis/events-api/using-socket-mode#using-multiple-connections)。 ### Relay 模式 Relay 模式會將 Slack 入口與 OpenClaw 閘道分離。受信任路由器擁有單一 Slack Socket Mode 連線、選擇目的地閘道，並透過已驗證的 websocket 轉送型別化事件。閘道仍使用自己的 Bot token 進行對外 Slack Web API 呼叫。 ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { channels: { slack: { mode: "relay", botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" }, relay: { url: "wss://router.example.com/gateway/ws", authToken: { source: "env", provider: "default", id: "SLACK_RELAY_AUTH_TOKEN" }, gatewayId: "team-gateway", }, }, }, } ``` Relay URL 必須使用 `wss://`，除非它指向 localhost。請將 bearer token 與路由器路由表視為 Slack 授權邊界的一部分：被路由的事件會作為已授權啟用進入一般 Slack 訊息處理常式。websocket `hello` frame 中由路由器提供的 `slack_identity` 可以設定預設對外使用者名稱與圖示；呼叫端明確提供的身分仍會優先。Relay 連線會使用與 Socket Mode 相同的有界退避時間重新連線，並在中斷連線時清除路由器提供的身分。 ## 安裝 ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw plugins install @openclaw/slack ``` `plugins install` 會註冊並啟用外掛。在你完成下方 Slack 應用程式與頻道設定前，它不會執行任何動作。一般外掛安裝規則請參閱 [外掛](/zh-TW/tools/plugin)。 ## 快速設定 開啟 [api.slack.com/apps](https://api.slack.com/apps/new) → **Create New App** → **From a manifest** → 選取你的工作區 → 貼上下方其中一份 manifest → **Next** → **Create**。 ```json Recommended theme={"theme":{"light":"min-light","dark":"min-dark"}} { "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 }, "assistant_view": { "assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.", "suggested_prompts": [ { "title": "What can you do?", "message": "What can you help me with?" }, { "title": "Summarize this channel", "message": "Summarize the recent activity in this channel." }, { "title": "Draft a reply", "message": "Help me draft a reply." } ] }, "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", "assistant_thread_context_changed", "assistant_thread_started", "channel_rename", "member_joined_channel", "member_left_channel", "message.channels", "message.groups", "message.im", "message.mpim", "pin_added", "pin_removed", "reaction_added", "reaction_removed" ] } } } ``` ```json Minimal theme={"theme":{"light":"min-light","dark":"min-dark"}} { "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 }, "assistant_view": { "assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.", "suggested_prompts": [ { "title": "What can you do?", "message": "What can you help me with?" }, { "title": "Summarize this channel", "message": "Summarize the recent activity in this channel." }, { "title": "Draft a reply", "message": "Help me draft a reply." } ] }, "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", "assistant_thread_context_changed", "assistant_thread_started", "message.channels", "message.groups", "message.im" ] } } } ``` **Recommended** 符合 Slack 外掛的完整功能集：App Home、斜線命令、檔案、回應、釘選、群組私訊，以及 emoji/使用者群組讀取。當工作區政策限制 scopes 時，請選擇 **Minimal**，它涵蓋私訊、頻道/群組歷史、提及與斜線命令，但不包含檔案、回應、釘選、群組私訊（`mpim:*`）、`emoji:read` 與 `usergroups:read`。請參閱 [Manifest 與 scope 檢查清單](#manifest-and-scope-checklist)，了解每個 scope 的理由與額外斜線命令等可加選項。 Slack 建立應用程式後： * **Basic Information -> App-Level Tokens -> Generate Token and Scopes**：新增 `connections:write`，儲存，複製 App-Level Token。 * **Install App -> Install to Workspace**：複製 Bot User OAuth Token。 建議的 SecretRef 設定： ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} export SLACK_APP_TOKEN=slack-app-token-example export SLACK_BOT_TOKEN=slack-bot-token-example 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 ``` Env 後援（僅預設帳號）： ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} SLACK_APP_TOKEN=slack-app-token-example SLACK_BOT_TOKEN=slack-bot-token-example ``` ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw gateway ``` 開啟 [api.slack.com/apps](https://api.slack.com/apps/new) → **建立新應用程式** → **從 manifest** → 選取你的工作區 → 貼上下方其中一個 manifest → 將 `https://gateway-host.example.com/slack/events` 替換為你的公開閘道 URL → **下一步** → **建立**。 ```json Recommended theme={"theme":{"light":"min-light","dark":"min-dark"}} { "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 }, "assistant_view": { "assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.", "suggested_prompts": [ { "title": "What can you do?", "message": "What can you help me with?" }, { "title": "Summarize this channel", "message": "Summarize the recent activity in this channel." }, { "title": "Draft a reply", "message": "Help me draft a reply." } ] }, "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", "assistant_thread_context_changed", "assistant_thread_started", "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" } } } ``` ```json Minimal theme={"theme":{"light":"min-light","dark":"min-dark"}} { "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 }, "assistant_view": { "assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.", "suggested_prompts": [ { "title": "What can you do?", "message": "What can you help me with?" }, { "title": "Summarize this channel", "message": "Summarize the recent activity in this channel." }, { "title": "Draft a reply", "message": "Help me draft a reply." } ] }, "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", "assistant_thread_context_changed", "assistant_thread_started", "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" } } } ``` **建議** 會符合 Slack 外掛的完整功能集；**最小** 會移除檔案、回應、釘選、群組私訊（`mpim:*`）、`emoji:read` 和 `usergroups:read`，適用於限制較嚴格的工作區。請參閱 [Manifest 與 scope 檢查清單](#manifest-and-scope-checklist) 了解每個 scope 的理由。 三個 URL 欄位（`slash_commands[].url`、`event_subscriptions.request_url`，以及 `interactivity.request_url` / `message_menu_options_url`）都指向同一個 OpenClaw 端點。Slack 的 manifest 結構描述要求它們分別命名，但 OpenClaw 會依 payload 類型路由，因此單一 `webhookPath`（預設 `/slack/events`）就足夠。HTTP 模式中沒有 `slash_commands[].url` 的斜線命令會靜默無作用。 Slack 建立應用程式之後： * **基本資訊 → 應用程式憑證**：複製用於請求驗證的 **Signing Secret**。 * **安裝應用程式 -> 安裝到工作區**：複製 Bot User OAuth Token。 建議的 SecretRef 設定： ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} export SLACK_BOT_TOKEN=slack-bot-token-example 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 ``` 多帳號 HTTP 請使用唯一的網路鉤子路徑 為每個帳號指定不同的 `webhookPath`（預設 `/slack/events`），避免註冊互相衝突。 ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw gateway ``` ## Socket Mode 傳輸調校 OpenClaw 預設會將 Socket Mode 的 Slack SDK 用戶端 pong 逾時設為 15 秒。只有在需要針對工作區或主機進行特定調校時，才覆寫傳輸設定： ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { channels: { slack: { mode: "socket", socketMode: { clientPingTimeout: 20000, serverPingTimeout: 30000, pingPongLoggingEnabled: false, }, }, }, } ``` 只有在 Socket Mode 工作區記錄 Slack websocket pong/server-ping 逾時，或在已知有事件迴圈飢餓問題的主機上執行時，才使用此設定。`clientPingTimeout` 是 SDK 傳送用戶端 ping 後等待 pong 的時間；`serverPingTimeout` 是等待 Slack 伺服器 ping 的時間。應用程式訊息與事件仍是應用程式狀態，不是傳輸存活訊號。 注意事項： * `socketMode` 在 HTTP Request URL 模式中會被忽略。 * 基礎 `channels.slack.socketMode` 設定會套用到所有 Slack 帳號，除非被覆寫。個別帳號覆寫使用 `channels.slack.accounts..socketMode`；因為這是物件覆寫，請包含該帳號所需的每個 socket 調校欄位。 * 只有 `clientPingTimeout` 有 OpenClaw 預設值（`15000`）。`serverPingTimeout` 和 `pingPongLoggingEnabled` 只有在已設定時才會傳給 Slack SDK。 * Socket Mode 重新啟動退避大約從 2 秒開始，並在大約 30 秒封頂。可復原的啟動、等待啟動與斷線失敗會持續重試，直到頻道停止。永久性的帳號與憑證錯誤，例如驗證無效、token 已撤銷或缺少 scope，會快速失敗，而不是永遠重試。 ## Manifest 與 scope 檢查清單 基礎 Slack app manifest 對 Socket Mode 和 HTTP Request URL 都相同。只有 `settings` 區塊（以及斜線命令的 `url`）不同。 基礎 manifest（Socket Mode 預設）： ```json theme={"theme":{"light":"min-light","dark":"min-dark"}} { "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 }, "assistant_view": { "assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.", "suggested_prompts": [ { "title": "What can you do?", "message": "What can you help me with?" }, { "title": "Summarize this channel", "message": "Summarize the recent activity in this channel." }, { "title": "Draft a reply", "message": "Help me draft a reply." } ] }, "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", "assistant_thread_context_changed", "assistant_thread_started", "channel_rename", "member_joined_channel", "member_left_channel", "message.channels", "message.groups", "message.im", "message.mpim", "pin_added", "pin_removed", "reaction_added", "reaction_removed" ] } } } ``` 對於 **HTTP Request URL 模式**，請將 `settings` 替換為 HTTP 變體，並將 `url` 加到每個斜線命令。需要公開 URL： ```json theme={"theme":{"light":"min-light","dark":"min-dark"}} { "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", "assistant_thread_context_changed", "assistant_thread_started", "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" } } } ``` ### 其他 manifest 設定 呈現可延伸上述預設值的不同功能。 預設 manifest 會啟用 Slack App Home 的 **首頁** 分頁，並訂閱 `app_home_opened`。當工作區成員開啟「首頁」分頁時，OpenClaw 會透過 `views.publish` 發布安全的預設首頁檢視；不會包含任何對話承載資料或私人設定。**訊息** 分頁仍會為 Slack DM 啟用。manifest 也會透過 `features.assistant_view`、`assistant:write`、`assistant_thread_started` 和 `assistant_thread_context_changed` 啟用 Slack assistant threads；assistant threads 會路由到各自的 OpenClaw thread sessions，並讓 Slack 提供的 thread context 可供代理使用。 可以使用多個[原生斜線命令](#commands-and-slash-behavior)取代單一設定命令，但有幾點細節： * 使用 `/agentstatus` 取代 `/status`，因為 `/status` 命令是保留命令。 * Slack app 一次最多可註冊 25 個斜線命令（Slack 平台限制）。 將現有的 `features.slash_commands` 區段替換為[可用命令](/zh-TW/tools/slash-commands#command-list)的子集： ```json theme={"theme":{"light":"min-light","dark":"min-dark"}} { "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 or max-age " }, { "command": "/think", "description": "Set the thinking level", "usage_hint": "" }, { "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= security= ask= node=" }, { "command": "/approve", "description": "Approve or deny pending approval requests", "usage_hint": " " }, { "command": "/model", "description": "Show or set the model", "usage_hint": "[name|#|status]" }, { "command": "/models", "description": "List providers/models", "usage_hint": "[provider] [page] [limit=|size=|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": " [input]" }, { "command": "/btw", "description": "Ask a side question without changing session context", "usage_hint": "" }, { "command": "/side", "description": "Ask a side question without changing session context", "usage_hint": "" }, { "command": "/usage", "description": "Control the usage footer or show cost summary", "usage_hint": "off|tokens|full|cost" } ] } ``` 使用與上方 Socket Mode 相同的 `slash_commands` 清單，並在每個項目中加入 `"url": "https://gateway-host.example.com/slack/events"`。範例： ```json theme={"theme":{"light":"min-light","dark":"min-dark"}} { "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" } ] } ``` 在清單中的每個命令上重複該 `url` 值。 如果你想讓傳出訊息使用作用中代理身分（自訂使用者名稱與圖示），而不是預設 Slack app 身分，請加入 `chat:write.customize` bot scope。 如果你使用 emoji 圖示，Slack 會預期 `:emoji_name:` 語法。 如果你設定 `channels.slack.userToken`，典型的讀取 scopes 為： * `channels:history`、`groups:history`、`im:history`、`mpim:history` * `channels:read`、`groups:read`、`im:read`、`mpim:read` * `users:read` * `reactions:read` * `pins:read` * `emoji:read` * `search:read`（如果你依賴 Slack 搜尋讀取） ## Token 模型 * Socket Mode 需要 `botToken` + `appToken`。 * HTTP 模式需要 `botToken` + `signingSecret`。 * Relay 模式需要 `botToken` 加上 `relay.url`、`relay.authToken` 和 `relay.gatewayId`；它不使用 app token 或 signing secret。 * `botToken`、`appToken`、`signingSecret`、`relay.authToken` 和 `userToken` 接受純文字 字串或 SecretRef 物件。 * 設定 token 會覆寫 env fallback。 * `SLACK_BOT_TOKEN`、`SLACK_APP_TOKEN` 和 `SLACK_USER_TOKEN` env fallback 各自只套用到預設帳號。 * `userToken` 預設為唯讀行為（`userTokenReadOnly: true`）。 狀態快照行為： * Slack 帳號檢查會追蹤每個憑證的 `*Source` 和 `*Status` 欄位（`botToken`、`appToken`、`signingSecret`、`userToken`）。 * 狀態為 `available`、`configured_unavailable` 或 `missing`。 * `configured_unavailable` 表示帳號是透過 SecretRef 或其他非行內 secret 來源設定，但目前的命令/執行階段路徑 無法解析實際值。 * 在 HTTP 模式中會包含 `signingSecretStatus`；在 Socket Mode 中， 必要組合為 `botTokenStatus` + `appTokenStatus`。 對於 actions/directory 讀取，設定後可以優先使用 user token。對於寫入，bot token 仍為優先；只有在 `userTokenReadOnly: false` 且 bot token 不可用時，才允許 user-token 寫入。 ## Actions 與 gates Slack actions 由 `channels.slack.actions.*` 控制。 目前 Slack 工具中可用的 action groups： | 群組 | 預設 | | ---------- | -- | | messages | 啟用 | | reactions | 啟用 | | pins | 啟用 | | memberInfo | 啟用 | | emojiList | 啟用 | 目前的 Slack message actions 包含 `send`、`upload-file`、`download-file`、`read`、`edit`、`delete`、`pin`、`unpin`、`list-pins`、`member-info` 和 `emoji-list`。`download-file` 接受入站檔案 placeholder 中顯示的 Slack file IDs，並針對圖片回傳圖片預覽，或針對其他檔案類型回傳本機檔案中繼資料。 ## 存取控制與路由 `channels.slack.dmPolicy` 控制 DM 存取。`channels.slack.allowFrom` 是標準 DM allowlist。 * `pairing`（預設） * `allowlist` * `open`（需要 `channels.slack.allowFrom` 包含 `"*"`） * `disabled` DM flags： * `dm.enabled`（預設為 true） * `channels.slack.allowFrom` * `dm.allowFrom`（舊版） * `dm.groupEnabled`（group DMs 預設為 false） * `dm.groupChannels`（選用 MPIM allowlist） 多帳號優先順序： * `channels.slack.accounts.default.allowFrom` 只套用到 `default` 帳號。 * Named accounts 在自身 `allowFrom` 未設定時，會繼承 `channels.slack.allowFrom`。 * Named accounts 不會繼承 `channels.slack.accounts.default.allowFrom`。 舊版 `channels.slack.dm.policy` 和 `channels.slack.dm.allowFrom` 仍會讀取以維持相容性。`openclaw doctor --fix` 會在不變更存取權的情況下，將它們遷移到 `dmPolicy` 和 `allowFrom`。 DM 中的 pairing 使用 `openclaw pairing approve slack `。 `channels.slack.groupPolicy` 控制 channel 處理： * `open` * `allowlist` * `disabled` Channel allowlist 位於 `channels.slack.channels` 下，且設定 keys **必須使用穩定的 Slack channel IDs**（例如 `C12345678`）。 執行階段注意事項：如果完全缺少 `channels.slack`（僅 env 設定），執行階段會 fallback 到 `groupPolicy="allowlist"` 並記錄警告（即使已設定 `channels.defaults.groupPolicy`）。 名稱/ID 解析： * channel allowlist entries 和 DM allowlist entries 會在 token 存取允許時於啟動時解析 * 未解析的 channel-name entries 會照設定保留，但預設會在路由時忽略 * 入站授權與 channel routing 預設以 ID 優先；直接 username/slug matching 需要 `channels.slack.dangerouslyAllowNameMatching: true` 以名稱為基礎的 keys（`#channel-name` 或 `channel-name`）在 `groupPolicy: "allowlist"` 下**不會**匹配。Channel lookup 預設以 ID 優先，因此以名稱為基礎的 key 永遠無法成功路由，該 channel 中的所有訊息都會被靜默封鎖。這不同於 `groupPolicy: "open"`，該情況下 channel key 不是路由所必需，因此以名稱為基礎的 key 看起來會有效。 一律使用 Slack channel ID 作為 key。尋找方式：在 Slack 中以滑鼠右鍵點擊 channel → **Copy link** — ID（`C...`）會出現在 URL 結尾。 正確： ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { channels: { slack: { groupPolicy: "allowlist", channels: { C12345678: { allow: true, requireMention: true }, }, }, }, } ``` 錯誤（在 `groupPolicy: "allowlist"` 下會被靜默封鎖）： ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { channels: { slack: { groupPolicy: "allowlist", channels: { "#eng-my-channel": { allow: true, requireMention: true }, }, }, }, } ``` 頻道訊息預設會以提及作為門檻。 提及來源： * 明確的應用程式提及（`<@botId>`） * Slack 使用者群組提及（``），當機器人使用者是該使用者群組成員時適用；需要 `usergroups:read` * 提及正則表達式模式（`agents.list[].groupChat.mentionPatterns`，後備為 `messages.groupChat.mentionPatterns`） * 隱含的回覆機器人執行緒行為（當 `thread.requireExplicitMention` 為 `true` 時停用） 各頻道控制項（`channels.slack.channels.`；名稱只能透過啟動解析或 `dangerouslyAllowNameMatching` 使用）： * `requireMention` * `ignoreOtherMentions` * `replyToMode`（`off|first|all|batched`；覆寫此頻道的帳號/聊天類型回覆模式） * `users`（允許清單） * `allowBots` * `skills` * `systemPrompt` * `tools`、`toolsBySender` * `toolsBySender` 鍵格式：`channel:`、`id:`、`e164:`、`username:`、`name:`，或 `"*"` 萬用字元 （舊版未加前綴的鍵仍只會對應到 `id:`） `ignoreOtherMentions`（預設 `false`）會丟棄提及其他使用者或使用者群組但未提及此機器人的頻道訊息。DM 與群組 DM（MPIM）不受影響。此篩選器需要來自 `auth.test` 的已解析機器人使用者 ID；如果該身分無法取得（例如只有使用者權杖的身分），門檻會開放失效，訊息會原樣通過。 `allowBots` 對頻道與私人頻道採保守處理：只有當傳送訊息的機器人明確列在該聊天室的 `users` 允許清單中，或 `channels.slack.allowFrom` 中至少一個明確的 Slack 擁有者 ID 目前是聊天室成員時，才會接受由機器人撰寫的聊天室訊息。萬用字元與顯示名稱擁有者項目不符合擁有者存在條件。擁有者存在檢查使用 Slack `conversations.members`；請確認應用程式擁有該聊天室類型對應的讀取範圍（公開頻道為 `channels:read`，私人頻道為 `groups:read`）。如果成員查詢失敗，OpenClaw 會丟棄由機器人撰寫的聊天室訊息。 已接受的機器人撰寫 Slack 訊息會使用共用的[機器人迴圈保護](/zh-TW/channels/bot-loop-protection)。設定 `channels.defaults.botLoopProtection` 作為預設額度，然後在工作區或頻道需要不同限制時，以 `channels.slack.botLoopProtection` 或 `channels.slack.channels..botLoopProtection` 覆寫。 ## 執行緒、工作階段與回覆標籤 * DM 會路由為 `direct`；頻道為 `channel`；MPIM 為 `group`。 * Slack 路由繫結接受原始對等 ID，以及 Slack 目標格式，例如 `channel:C12345678`、`user:U12345678` 和 `<@U12345678>`。 * 使用預設 `session.dmScope=main` 時，Slack DM 會合併到代理主工作階段。 * 頻道工作階段：`agent::slack:channel:`。 * 一般頂層頻道訊息會留在各頻道工作階段上，即使 `replyToMode` 不是 `off`。 * Slack 執行緒回覆會使用父層 Slack `thread_ts` 作為工作階段後綴（`:thread:`），即使已用 `replyToMode="off"` 停用外送回覆執行緒化。 * 當符合資格的頂層頻道根訊息預期會開始可見的 Slack 執行緒時，OpenClaw 會將其植入 `agent::slack:channel::thread:`，讓根訊息與後續執行緒回覆共用同一個 OpenClaw 工作階段。這適用於 `app_mention` 事件、明確的機器人或已設定提及模式相符項，以及具有非 `off` `replyToMode` 的 `requireMention: false` 頻道。 * `channels.slack.thread.historyScope` 預設為 `thread`；`thread.inheritParent` 預設為 `false`。 * `channels.slack.thread.initialHistoryLimit` 控制新執行緒工作階段開始時要擷取多少既有執行緒訊息（預設 `20`；設為 `0` 可停用）。 * `channels.slack.thread.requireExplicitMention`（預設 `false`）：當為 `true` 時，抑制隱含的執行緒提及，使機器人只回應執行緒內明確的 `@bot` 提及，即使機器人已參與該執行緒。若未設定此項，已由機器人參與的執行緒中的回覆會繞過 `requireMention` 門檻。 回覆執行緒控制項： * `channels.slack.channels..replyToMode`：Slack 頻道/私人頻道訊息的各頻道覆寫 * `channels.slack.replyToMode`：`off|first|all|batched`（預設 `off`） * `channels.slack.replyToModeByChatType`：依 `direct|group|channel` 設定 * 直接聊天的舊版後備：`channels.slack.dm.replyToMode` 支援手動回覆標籤： * `[[reply_to_current]]` * `[[reply_to:]]` 若要從 `message` 工具明確回覆 Slack 執行緒，請將 `replyBroadcast: true` 搭配 `action: "send"` 和 `threadId` 或 `replyTo` 設定，以要求 Slack 同時將執行緒回覆廣播到父頻道。這會對應到 Slack 的 `chat.postMessage` `reply_broadcast` 旗標，且只支援文字或 Block Kit 傳送，不支援媒體上傳。 當 `message` 工具呼叫在 Slack 執行緒內執行且目標為同一頻道時，OpenClaw 通常會依有效的帳號、聊天類型或各頻道 `replyToMode` 繼承目前的 Slack 執行緒。自動回覆與同頻道 `send` 或 `upload-file` 呼叫會使用相同的各頻道覆寫。請在 `action: "send"` 或 `action: "upload-file"` 上設定 `topLevel: true`，以強制建立新的父頻道訊息。`threadId: null` 會被接受為相同的頂層退出選項。 `replyToMode="off"` 會停用外送 Slack 回覆執行緒化，包括明確的 `[[reply_to_*]]` 標籤。它不會壓平傳入 Slack 執行緒工作階段：已張貼在 Slack 執行緒內的訊息仍會路由到 `:thread:` 工作階段。這與 Telegram 不同，Telegram 在 `"off"` 模式下仍會遵循明確標籤。Slack 執行緒會將訊息從頻道中隱藏，而 Telegram 回覆會保持行內可見。 ## Ack 反應 `ackReaction` 會在 OpenClaw 處理傳入訊息時傳送確認表情符號。`ackReactionScope` 決定該表情符號實際上會在\_何時\_送出。 預設情況下，當 Slack 原生助理執行緒狀態以輪替載入訊息顯示進度時，確認會保持靜態。設定 `messages.statusReactions.enabled: true` 可改用佇列中/思考中/工具/完成/錯誤的反應生命週期。 ### 表情符號（`ackReaction`） 解析順序： * `channels.slack.accounts..ackReaction` * `channels.slack.ackReaction` * `messages.ackReaction` * 代理身分表情符號後備（`agents.list[].identity.emoji`，否則為 `"eyes"` / 👀） 注意事項： * Slack 預期使用短代碼（例如 `"eyes"`）。 * 使用 `""` 可停用 Slack 帳號或全域的反應。 ### 範圍（`messages.ackReactionScope`） Slack 提供者會從 `messages.ackReactionScope` 讀取範圍（預設 `"group-mentions"`）。目前沒有 Slack 帳號或 Slack 頻道層級的覆寫；此值對閘道是全域的。 值： * `"all"`：在 DM 與群組中反應，包括環境聊天室事件。 * `"direct"`：只在 DM 中反應。 * `"group-all"`：對每則群組訊息反應，但不包括環境聊天室事件（不含 DM）。 * `"group-mentions"`（預設）：在群組中反應，但只有在機器人被提及時（或在選擇加入的群組可提及項中）。**不包括 DM。** * `"off"` / `"none"`：永不反應。 預設範圍（`"group-mentions"`）不會在直接訊息或環境聊天室事件中觸發 ack 反應。若要在傳入 Slack DM 與安靜聊天室事件上看到已設定的 `ackReaction`（例如 `"eyes"`），請將 `messages.ackReactionScope` 設為 `"all"`。`messages.ackReactionScope` 會在 Slack 提供者啟動時讀取，因此需要重新啟動閘道才能讓變更生效。 ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { messages: { ackReaction: "eyes", ackReactionScope: "all", // react in DMs and groups }, } ``` ## 文字串流 `channels.slack.streaming` 控制即時預覽行為： * `off`：停用即時預覽串流。 * `partial`（預設）：用最新的部分輸出取代預覽文字。 * `block`：附加分塊預覽更新。 * `progress`：產生時顯示進度狀態文字，然後傳送最終文字。 * `streaming.preview.toolProgress`：當草稿預覽啟用時，將工具/進度更新路由到同一則已編輯的預覽訊息（預設：`true`）。設為 `false` 可保留獨立的工具/進度訊息。 * `streaming.preview.commandText` / `streaming.progress.commandText`：設為 `status` 可在隱藏原始 command/exec 文字的同時保留精簡的工具進度列（預設：`raw`）。 隱藏原始 command/exec 文字，同時保留精簡進度列： ```json theme={"theme":{"light":"min-light","dark":"min-dark"}} { "channels": { "slack": { "streaming": { "mode": "progress", "progress": { "toolProgress": true, "commandText": "status" } } } } } ``` `channels.slack.streaming.nativeTransport` 會在 `channels.slack.streaming.mode` 為 `partial` 時控制 Slack 原生文字串流（預設：`true`）。 Slack 原生進度任務卡在進度模式中需選擇加入。將 `channels.slack.streaming.progress.nativeTaskCards` 設為 `true`，並搭配 `channels.slack.streaming.mode="progress"`，即可在工作執行時傳送 Slack 原生計畫/任務卡，然後在完成時更新同一張任務卡。若沒有此旗標，進度模式會保留可攜式草稿預覽行為。 * 必須有可用的回覆執行緒，原生文字串流與 Slack 助理執行緒狀態才會顯示。執行緒選擇仍遵循 `replyToMode`。 * 當原生串流不可用或沒有回覆執行緒時，頻道、群組聊天與頂層 DM 根訊息仍可使用一般草稿預覽。 * 頂層 Slack DM 預設保持非執行緒，因此不會顯示 Slack 執行緒樣式的原生串流/狀態預覽；OpenClaw 會改為在 DM 中張貼並編輯草稿預覽。 * 媒體與非文字承載會退回一般傳遞。 * 媒體/錯誤最終訊息會取消待處理的預覽編輯；符合資格的文字/區塊最終訊息只有在可以就地編輯預覽時才會送出。 * 如果串流在回覆中途失敗，OpenClaw 會針對剩餘承載退回一般傳遞。 使用草稿預覽，而不是 Slack 原生文字串流： ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { channels: { slack: { streaming: { mode: "partial", nativeTransport: false, }, }, }, } ``` 選擇加入 Slack 原生進度任務卡： ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { channels: { slack: { streaming: { mode: "progress", progress: { nativeTaskCards: true, render: "rich", }, }, }, }, } ``` 舊版鍵： * `channels.slack.streamMode`（`replace | status_final | append`）是 `channels.slack.streaming.mode` 的舊版執行階段別名。 * 布林值 `channels.slack.streaming` 是 `channels.slack.streaming.mode` 和 `channels.slack.streaming.nativeTransport` 的舊版執行階段別名。 * 頂層 `channels.slack.chunkMode` 和 `channels.slack.nativeStreaming` 是 `channels.slack.streaming.chunkMode` 和 `channels.slack.streaming.nativeTransport` 的舊版執行階段別名。 * 執行 `openclaw doctor --fix`，將已保存的 Slack 串流設定重寫為標準鍵。 ## 輸入中反應後備 `typingReaction` 會在 OpenClaw 處理回覆時，對傳入的 Slack 訊息新增暫時反應，然後在執行完成時移除。這在執行緒回覆之外最有用，因為執行緒回覆會使用預設的「正在輸入...」狀態指示器。 解析順序： * `channels.slack.accounts..typingReaction` * `channels.slack.typingReaction` 注意事項： * Slack 預期使用短代碼（例如 `"hourglass_flowing_sand"`）。 * 反應採盡力而為，並會在回覆或失敗路徑完成後自動嘗試清理。 ## 媒體、分塊與傳遞 Slack 檔案附件會從 Slack 託管的私人 URL 下載（以權杖驗證的請求流程），並在擷取成功且大小限制允許時寫入媒體儲存。檔案佔位符包含 Slack `fileId`，因此代理可以使用 `download-file` 擷取原始檔案。 下載會使用有界限的閒置與總逾時。如果 Slack 檔案擷取停滯或失敗，OpenClaw 會繼續處理訊息，並退回使用檔案佔位符。 執行階段傳入大小上限預設為 `20MB`，除非由 `channels.slack.mediaMaxMb` 覆寫。 * 文字區塊使用 `channels.slack.textChunkLimit`（預設 `8000`，上限為 Slack 自身的訊息長度限制） * `channels.slack.streaming.chunkMode="newline"` 啟用以段落優先的分割 * 檔案傳送使用 Slack 上傳 API，並可包含執行緒回覆（`thread_ts`） * 設定時，傳出媒體上限遵循 `channels.slack.mediaMaxMb`；否則頻道傳送會使用媒體管線中的 MIME 種類預設值 偏好的明確目標： * `user:` 用於 DM * `channel:` 用於頻道 僅文字/區塊的 Slack DM 可以直接發佈到使用者 ID；檔案上傳和執行緒傳送會先透過 Slack 對話 API 開啟 DM，因為這些路徑需要具體的對話 ID。 ## 命令與斜線行為 斜線命令在 Slack 中會顯示為單一已設定命令或多個原生命令。設定 `channels.slack.slashCommand` 以變更命令預設值： * `enabled: false` * `name: "openclaw"` * `sessionPrefix: "slack:slash"` * `ephemeral: true` ```txt theme={"theme":{"light":"min-light","dark":"min-dark"}} /openclaw /help ``` 原生命令需要在你的 Slack 應用程式中使用[額外的 manifest 設定](#additional-manifest-settings)，並改由 `channels.slack.commands.native: true` 或全域設定中的 `commands.native: true` 啟用。 * Slack 的原生命令自動模式為**關閉**，因此 `commands.native: "auto"` 不會啟用 Slack 原生命令。 ```txt theme={"theme":{"light":"min-light","dark":"min-dark"}} /help ``` 原生引數選單會依優先順序呈現為以下其中一種： * 3-5 個足夠短的選項：溢位（"..."）選單 * 超過 100 個選項，且可使用非同步選項篩選：外部選取 * 1-2 個選項，或任何編碼值太長而無法用於選取的選項：按鈕區塊 * 否則（6-100 個選項，或超過 100 個且沒有非同步篩選）：靜態選取選單，每個選單以 100 個選項分塊 ```txt theme={"theme":{"light":"min-light","dark":"min-dark"}} /think ``` 斜線工作階段會使用像 `agent::slack:slash:` 這樣的隔離鍵，並仍會使用 `CommandTargetSessionKey` 將命令執行路由到目標對話工作階段。 ## 互動式回覆 Slack 可以呈現代理撰寫的互動式回覆控制項，但此功能預設停用。 對於新的代理、命令列介面和外掛輸出，偏好使用共用的 `presentation` 按鈕或選取區塊。它們使用相同的 Slack 互動 路徑，同時也能在其他頻道上降級。 全域啟用： ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { channels: { slack: { capabilities: { interactiveReplies: true, }, }, }, } ``` 或只為一個 Slack 帳戶啟用： ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { channels: { slack: { accounts: { ops: { capabilities: { interactiveReplies: true, }, }, }, }, }, } ``` 啟用後，代理仍可發出已棄用的 Slack 專用回覆指令： * `[[slack_buttons: Approve:approve, Reject:reject]]` * `[[slack_select: Choose a target | Canary:canary, Production:production]]` 這些指令會編譯為 Slack Block Kit，並透過現有的 Slack 互動事件路徑 將點擊或選取路由回來。保留它們以支援舊提示和 Slack 專用的逃生口；新的 可攜式控制項請使用共用 presentation。 新的產生器程式碼也已棄用指令編譯器 API： * `compileSlackInteractiveReplies(...)` * `parseSlackOptionsLine(...)` * `isSlackInteractiveRepliesEnabled(...)` * `buildSlackInteractiveBlocks(...)` 新的 Slack 呈現控制項請使用 `presentation` 承載和 `buildSlackPresentationBlocks(...)`。 注意： * 這是 Slack 專用的舊版 UI。其他頻道不會將 Slack Block Kit 指令轉譯為自己的按鈕系統。 * 互動式回呼值是 OpenClaw 產生的不透明權杖，不是代理撰寫的原始值。 * 如果產生的互動式區塊會超過 Slack Block Kit 限制，OpenClaw 會退回使用原始文字回覆，而不是傳送無效的區塊承載。 ### 外掛擁有的互動視窗提交 註冊互動處理器的 Slack 外掛，也可以在 OpenClaw 將承載壓縮為代理可見的系統事件之前，接收互動視窗 `view_submission` 和 `view_closed` 生命週期事件。開啟 Slack 互動視窗時，請使用以下其中一種路由 模式： * 將 `callback_id` 設為 `openclaw::`。 * 或保留現有的 `callback_id`，並將 `pluginInteractiveData: ":"` 放在互動視窗 `private_metadata` 中。 處理器會收到 `ctx.interaction.kind`，值為 `view_submission` 或 `view_closed`、正規化的 `inputs`，以及來自 Slack 的完整原始 `stateValues` 物件。僅使用 callback-id 的路由已足以叫用外掛處理器；當互動視窗也應產生代理可見的系統事件時，請包含現有互動視窗 `private_metadata` 的使用者/工作階段路由欄位。代理會收到精簡、已遮蔽的 `Slack interaction: ...` 系統事件。如果處理器回傳 `systemEvent.summary`、`systemEvent.reference` 或 `systemEvent.data`，這些欄位會包含在該精簡事件中，因此代理可以參照 外掛擁有的儲存，而不會看到完整表單承載。 ## Slack 中的原生核准 Slack 可以充當具有互動式按鈕和互動的原生核准用戶端，而不是退回使用 Web UI 或終端機。 * Exec 和外掛核准可以呈現為 Slack 原生 Block Kit 提示。 * `channels.slack.execApprovals.*` 仍是原生 exec 核准用戶端的啟用與 DM/頻道路由設定。 * Exec 核准 DM 使用 `channels.slack.execApprovals.approvers` 或 `commands.ownerAllowFrom`。 * 當 Slack 已作為原始工作階段的原生核准用戶端啟用，或 `approvals.plugin` 路由到原始 Slack 工作階段或 Slack 目標時，外掛核准會使用 Slack 原生按鈕。 * 外掛核准 DM 使用來自 `channels.slack.allowFrom`、具名帳戶 `allowFrom` 或帳戶預設路由的 Slack 外掛核准者。 * 仍會強制執行核准者授權：僅限 exec 的核准者不能核准外掛請求，除非他們同時也是外掛核准者。 這會使用與其他頻道相同的共用核准按鈕表面。當你的 Slack 應用程式設定中啟用 `interactivity` 時，核准提示會直接在對話中呈現為 Block Kit 按鈕。 當這些按鈕存在時，它們是主要的核准 UX；OpenClaw 只應在工具結果表示聊天 核准不可用或手動核准是唯一路徑時，才包含手動 `/approve` 命令。 設定路徑： * `channels.slack.execApprovals.enabled` * `channels.slack.execApprovals.approvers`（選用；可行時退回使用 `commands.ownerAllowFrom`） * `channels.slack.execApprovals.target`（`dm` | `channel` | `both`，預設：`dm`） * `agentFilter`, `sessionFilter` 當 `enabled` 未設定或為 `"auto"` 且至少能解析出一個 exec 核准者時，Slack 會自動啟用原生 exec 核准。當 Slack 外掛核准者可解析且請求符合原生用戶端篩選器時，Slack 也可以透過此原生用戶端 路徑處理原生外掛核准。設定 `enabled: false` 可明確停用 Slack 作為原生核准用戶端。設定 `enabled: true` 可在核准者解析時強制啟用原生核准。停用 Slack exec 核准不會停用 透過 `approvals.plugin` 啟用的原生 Slack 外掛核准傳遞；外掛核准 傳遞會改用 Slack 外掛核准者。 沒有明確 Slack exec 核准設定時的預設行為： ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { commands: { ownerAllowFrom: ["slack:U12345678"], }, } ``` 只有在你想覆寫核准者、新增篩選器或 選擇加入原始聊天傳遞時，才需要明確的 Slack 原生設定： ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { channels: { slack: { execApprovals: { enabled: true, approvers: ["U12345678"], target: "both", }, }, }, } ``` 共用 `approvals.exec` 轉送是分開的。只有當 exec 核准提示也必須 路由到其他聊天或明確的頻外目標時才使用。共用 `approvals.plugin` 轉送也是 分開的；只有在 Slack 能原生處理外掛 核准請求時，Slack 原生傳遞才會抑制該退回路徑。 同一聊天中的 `/approve` 也可在已支援命令的 Slack 頻道和 DM 中運作。請參閱 [Exec 核准](/zh-TW/tools/exec-approvals) 以了解完整核准轉送模型。 ## 事件與操作行為 * 訊息編輯/刪除會對應為系統事件。 * 執行緒廣播（"Also send to channel" 執行緒回覆）會作為一般使用者訊息處理。 * 表情回應新增/移除事件會對應為系統事件。 * 成員加入/離開、頻道建立/重新命名，以及釘選新增/移除事件會對應為系統事件。 * 啟用 `configWrites` 時，`channel_id_changed` 可以遷移頻道設定鍵。 * 頻道主題/用途中繼資料會被視為不受信任的脈絡，且可注入路由脈絡。 * 適用時，執行緒開頭訊息和初始執行緒歷史脈絡植入會由已設定的寄件者允許清單篩選。 * 區塊動作、捷徑和互動視窗互動會發出結構化的 `Slack interaction: ...` 系統事件，並帶有豐富承載欄位： * 區塊動作：選取值、標籤、選擇器值，以及 `workflow_*` 中繼資料 * 全域捷徑：回呼和執行者中繼資料，路由到執行者的直接工作階段 * 訊息捷徑：回呼、執行者、頻道、執行緒，以及所選訊息脈絡 * 互動視窗 `view_submission` 和 `view_closed` 事件，包含已路由頻道中繼資料和表單輸入 在你的 Slack 應用程式設定中定義全域或訊息捷徑，並使用任何非空的回呼 ID。OpenClaw 會確認符合的捷徑承載、套用與其他 Slack 互動相同的 DM/頻道寄件者政策，並將已清理事件排入已路由代理工作階段。觸發 ID 和回應 URL 會從代理脈絡中遮蔽。 ## 設定參考 主要參考：[設定參考 - Slack](/zh-TW/gateway/config-channels#slack)。 * 模式/驗證：`mode`, `botToken`, `appToken`, `signingSecret`, `webhookPath`, `accounts.*` * DM 存取：`dm.enabled`, `dmPolicy`, `allowFrom`（舊版：`dm.policy`, `dm.allowFrom`）, `dm.groupEnabled`, `dm.groupChannels` * 相容性切換：`dangerouslyAllowNameMatching`（緊急開關；除非需要，否則保持關閉） * 頻道存取：`groupPolicy`, `channels.*`, `channels.*.users`, `channels.*.requireMention` * 執行緒/歷史：`replyToMode`, `replyToModeByChatType`, `thread.*`, `historyLimit`, `dmHistoryLimit`, `dms.*.historyLimit` * 傳遞：`textChunkLimit`, `streaming.chunkMode`, `mediaMaxMb`, `streaming`, `streaming.nativeTransport`, `streaming.preview.toolProgress` * 展開預覽：`unfurlLinks`（預設：`false`）、`unfurlMedia` 用於 `chat.postMessage` 連結/媒體預覽控制；設定 `unfurlLinks: true` 可重新選擇加入連結預覽 * 操作/功能：`configWrites`, `commands.native`, `slashCommand.*`, `actions.*`, `userToken`, `userTokenReadOnly` ## 疑難排解 依序檢查： * `groupPolicy` * 頻道允許清單 (`channels.slack.channels`) — **鍵必須是頻道 ID** (`C12345678`)，不是名稱 (`#channel-name`)。在 `groupPolicy: "allowlist"` 下，使用名稱的鍵會靜默失敗，因為頻道路由預設優先使用 ID。若要尋找 ID：在 Slack 中對頻道按右鍵 → **Copy link** — URL 結尾的 `C...` 值就是頻道 ID。 * `requireMention` * 每個頻道的 `users` 允許清單 * `messages.groupChat.visibleReplies`：一般群組/頻道請求預設為 `"automatic"`。如果你選擇使用 `"message_tool"`，且日誌顯示助理文字但沒有 `message(action=send)` 呼叫，表示模型錯過了可見的訊息工具路徑。在此模式下，最終文字會保持私密；請檢查閘道詳細日誌中的已抑制酬載中繼資料，或如果你希望每個一般助理最終回覆都透過舊路徑發布，請將其設定為 `"automatic"`。 * `messages.groupChat.unmentionedInbound`：如果它是 `"room_event"`，未提及但允許的頻道聊天會作為環境脈絡並保持靜默，除非代理呼叫 `message` 工具。請參閱[環境聊天室事件](/zh-TW/channels/ambient-room-events)。 ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { messages: { groupChat: { visibleReplies: "automatic", }, }, } ``` 實用命令： ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw channels status --probe openclaw logs --follow openclaw doctor ``` 檢查： * `channels.slack.dm.enabled` * `channels.slack.dmPolicy`（或舊版 `channels.slack.dm.policy`） * 配對核准 / 允許清單項目（`dmPolicy: "open"` 仍需要 `channels.slack.allowFrom: ["*"]`） * 群組 DM 使用 MPIM 處理；啟用 `channels.slack.dm.groupEnabled`，如果已設定，請將 MPIM 包含在 `channels.slack.dm.groupChannels` 中 * Slack Assistant DM 事件：提到 `drop message_changed` 的詳細日誌 通常表示 Slack 傳送了已編輯的 Assistant 執行緒事件，但訊息中繼資料中沒有 可復原的人類傳送者 ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw pairing list slack ``` 在 Slack 應用程式設定中驗證機器人 + 應用程式權杖以及 Socket Mode 啟用狀態。 App-Level Token 需要 `connections:write`，而 Bot User OAuth Token 機器人權杖必須與應用程式權杖屬於同一個 Slack 應用程式/工作區。 如果 `openclaw channels status --probe --json` 顯示 `botTokenStatus` 或 `appTokenStatus: "configured_unavailable"`，表示 Slack 帳號已設定， 但目前執行階段無法解析由 SecretRef 支援的值。 像 `slack socket mode failed to start; retry ...` 這樣的日誌是可復原的 啟動失敗。缺少 scope、已撤銷的權杖和無效驗證則會快速失敗。 `slack token mismatch ...` 日誌表示機器人權杖和應用程式權杖 似乎屬於不同的 Slack 應用程式；請修正 Slack 應用程式憑證。 驗證： * 簽署密鑰 * 網路鉤子路徑 * Slack Request URL（Events + Interactivity + Slash Commands） * 每個 HTTP 帳號使用唯一的 `webhookPath` * 公開 URL 終止 TLS，並將請求轉送到閘道路徑 * Slack 應用程式的 `request_url` 路徑與 `channels.slack.webhookPath` 完全相符（預設 `/slack/events`） 如果帳號快照中出現 `signingSecretStatus: "configured_unavailable"`， 表示 HTTP 帳號已設定，但目前執行階段無法解析由 SecretRef 支援的簽署密鑰。 重複的 `slack: webhook path ... already registered` 日誌表示兩個 HTTP 帳號使用相同的 `webhookPath`；請為每個帳號指定不同路徑。 確認你的預期是： * 原生命令模式 (`channels.slack.commands.native: true`)，並在 Slack 中註冊相符的斜線命令 * 或單一斜線命令模式 (`channels.slack.slashCommand.enabled: true`) Slack 不會自動建立或移除斜線命令。`commands.native: "auto"` 不會啟用 Slack 原生命令；請使用 `true`，並在 Slack 應用程式中建立相符的命令。在 HTTP 模式下，每個 Slack 斜線命令都必須包含閘道 URL。在 Socket Mode 中，命令酬載會透過 websocket 到達，Slack 會忽略 `slash_commands[].url`。 也請檢查 `commands.useAccessGroups`、DM 授權、頻道允許清單， 以及每個頻道的 `users` 允許清單。Slack 會針對 被封鎖的斜線命令傳送者回傳短暫錯誤，包括： * `This channel is not allowed.` * `You are not authorized to use this command here.` ## 附件視覺參考 當 Slack 檔案下載成功且大小限制允許時，Slack 可以將下載的媒體附加到代理回合。影像檔案可以透過媒體理解路徑傳遞，或直接傳給具備視覺能力的回覆模型；其他檔案會保留為可下載的檔案脈絡，而不是被視為影像輸入。 ### 支援的媒體類型 | 媒體類型 | 來源 | 目前行為 | 備註 | | -------------------------- | ------------ | -------------------------------------------- | -------------------------------------------- | | JPEG / PNG / GIF / WebP 影像 | Slack 檔案 URL | 已下載並附加到回合，以供具備視覺能力的處理使用 | 每個檔案上限：`channels.slack.mediaMaxMb`（預設 20 MB） | | PDF 檔案 | Slack 檔案 URL | 已下載並公開為檔案脈絡，可供 `download-file` 或 `pdf` 等工具使用 | Slack 入站不會自動將 PDF 轉換為影像視覺輸入 | | 其他檔案 | Slack 檔案 URL | 可行時下載並公開為檔案脈絡 | 二進位檔案不會被視為影像輸入 | | 執行緒回覆 | 執行緒起始檔案 | 當回覆沒有直接媒體時，根訊息檔案可以作為脈絡補齊 | 僅含檔案的起始訊息會使用附件預留位置 | | 多影像訊息 | 多個 Slack 檔案 | 每個檔案都會獨立評估 | Slack 處理限制為每則訊息最多八個檔案 | ### 入站管線 當帶有檔案附件的 Slack 訊息到達時： 1. OpenClaw 使用機器人權杖從 Slack 的私有 URL 下載檔案。 2. 檔案在成功時寫入媒體儲存區。 3. 下載的媒體路徑和內容類型會加入入站脈絡。 4. 具備影像能力的模型/工具路徑可以使用該脈絡中的影像附件。 5. 非影像檔案仍可作為檔案中繼資料或媒體參照，供可處理它們的工具使用。 ### 執行緒根附件繼承 當訊息到達執行緒中（具有 `thread_ts` 父層）： * 如果回覆本身沒有直接媒體，且包含的根訊息有檔案，Slack 可以將根檔案補齊為執行緒起始脈絡。 * 根檔案只會在建立或重設執行緒工作階段時補齊。後續僅文字回覆會重用既有工作階段脈絡，不會將根檔案作為新媒體重新附加。 * 直接回覆附件優先於根訊息附件。 * 只有檔案且沒有文字的根訊息會以附件預留位置表示，讓後備流程仍可包含其檔案。 ### 多附件處理 當單一 Slack 訊息包含多個檔案附件時： * 每個附件都會透過媒體管線獨立處理。 * 已下載的媒體參照會彙整到訊息脈絡中。 * 處理順序遵循事件酬載中的 Slack 檔案順序。 * 一個附件下載失敗不會封鎖其他附件。 ### 大小、下載與模型限制 * **大小上限**：預設每個檔案 20 MB。可透過 `channels.slack.mediaMaxMb` 設定。 * **下載失敗**：Slack 無法提供的檔案、過期 URL、無法存取的檔案、過大的檔案，以及 Slack 驗證/登入 HTML 回應都會被略過，而不是回報為不支援的格式。 * **視覺模型**：當目前作用中的回覆模型支援視覺時，影像分析會使用該模型；否則使用 `agents.defaults.imageModel` 設定的影像模型。 ### 已知限制 | 情境 | 目前行為 | 因應方式 | | ------------------ | ------------------------- | ------------------------------------------------- | | 過期的 Slack 檔案 URL | 略過檔案；不顯示錯誤 | 在 Slack 中重新上傳檔案 | | 未設定視覺模型 | 影像附件會儲存為媒體參照，但不會作為影像分析 | 設定 `agents.defaults.imageModel`，或使用具備視覺能力的回覆模型 | | 非常大的影像（預設 > 20 MB） | 依大小上限略過 | 如果 Slack 允許，增加 `channels.slack.mediaMaxMb` | | 轉寄/共享附件 | 文字和 Slack 託管的影像/檔案媒體採盡力處理 | 直接在 OpenClaw 執行緒中重新分享 | | PDF 附件 | 儲存為檔案/媒體脈絡，不會自動透過影像視覺路由 | 使用 `download-file` 取得檔案中繼資料，或使用 `pdf` 工具進行 PDF 分析 | ### 相關文件 * [媒體理解管線](/zh-TW/nodes/media-understanding) * [PDF 工具](/zh-TW/tools/pdf) ## 相關 將 Slack 使用者配對到閘道。 頻道和群組 DM 行為。 將入站訊息路由到代理。 威脅模型與強化。 設定配置與優先順序。 命令目錄與行為。