Slack

Slack 支援透過 Slack 應用程式整合來處理私訊與頻道。預設傳輸方式為 Socket Mode；也支援 HTTP Request URLs。轉送模式適用於由受信任路由器負責 Slack 輸入流量的受管理部署。

選擇傳輸方式

Socket Mode 與 HTTP Request URLs 在訊息、斜線命令、App Home 和互動功能方面具有相同的功能。請依部署架構選擇，而非依功能選擇。

轉送模式

轉送模式會將 Slack 輸入流量與 OpenClaw 閘道分離。受信任路由器負責唯一的 Slack Socket Mode 連線、選擇目的地閘道，並透過經驗證的 WebSocket 轉送具型別的事件。閘道仍會使用自己的 Bot 權杖進行對外 Slack Web API 呼叫。

{  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",      },    },  },}

除非轉送 URL 指向 localhost，否則必須使用 wss://。請將持有人權杖與路由器路由表視為 Slack 授權邊界的一部分：路由事件會以已授權啟用事件的身分進入一般 Slack 訊息處理常式。路由器在 WebSocket hello 框架中提供的 slack_identity 可設定預設的對外使用者名稱與圖示；呼叫端明確提供的身分仍具有優先權。轉送連線會使用與 Socket Mode 相同的有上限退避重試時序重新連線，並在每次中斷連線時清除路由器提供的身分。

Enterprise Grid 全組織安裝

一個 Slack 帳號可以接收 Enterprise Grid 全組織安裝所涵蓋之每個工作區的訊息。請選擇直接 Socket Mode 或 HTTP Request URLs；企業帳號不支援轉送模式。下方兩份最小權限資訊清單都只啟用 V1 message 與 app_mention 事件路徑、即時回覆，以及由接聽器擁有的狀態反應。

Socket Mode

{  "display_information": {    "name": "OpenClaw",    "description": "OpenClaw 的 Slack 連接器"  },  "features": {    "bot_user": { "display_name": "OpenClaw", "always_online": true }  },  "oauth_config": {    "scopes": {      "bot": [        "app_mentions:read",        "channels:history",        "channels:read",        "chat:write",        "files:read",        "files:write",        "groups:history",        "groups:read",        "im:history",        "im:read",        "mpim:history",        "mpim:read",        "reactions:write",        "users:read"      ]    }  },  "settings": {    "org_deploy_enabled": true,    "socket_mode_enabled": true,    "event_subscriptions": {      "bot_events": [        "app_mention",        "message.channels",        "message.groups",        "message.im",        "message.mpim"      ]    }  }}

請由 Enterprise Grid Org Admin 或 Org Owner 核准應用程式、在組織層級安裝，並選擇此安裝涵蓋的工作區。啟動 OpenClaw 前，請確認此應用程式在每個預定工作區中皆可使用。為 Socket Mode 產生具有 connections:write 的應用程式層級權杖，然後從組織安裝複製 Bot 權杖。設定使用組織安裝 Bot 權杖的帳號：

{  channels: {    slack: {      enabled: true,      mode: "socket",      enterpriseOrgInstall: true,      appToken: { source: "env", provider: "default", id: "SLACK_APP_TOKEN" },      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },      dmPolicy: "open",      allowFrom: ["*"],      groupPolicy: "allowlist",      channels: {        C0123456789: { requireMention: true },      },    },  },}

HTTP Request URLs

當閘道具有公開 HTTPS 端點且不開啟 Socket Mode 連線時，請使用 HTTP 模式。將範例 URL 替換為閘道的公開 webhookPath URL（預設為 /slack/events）：

{  "display_information": {    "name": "OpenClaw",    "description": "OpenClaw 的 Slack 連接器"  },  "features": {    "bot_user": { "display_name": "OpenClaw", "always_online": true }  },  "oauth_config": {    "scopes": {      "bot": [        "app_mentions:read",        "channels:history",        "channels:read",        "chat:write",        "files:read",        "files:write",        "groups:history",        "groups:read",        "im:history",        "im:read",        "mpim:history",        "mpim:read",        "reactions:write",        "users:read"      ]    }  },  "settings": {    "org_deploy_enabled": true,    "event_subscriptions": {      "request_url": "https://gateway-host.example.com/slack/events",      "bot_events": [        "app_mention",        "message.channels",        "message.groups",        "message.im",        "message.mpim"      ]    }  }}

請由 Enterprise Grid Org Admin 或 Org Owner 核准應用程式、在組織層級安裝，並選擇此安裝涵蓋的工作區。Slack 驗證 Request URL 後，請複製組織安裝的 Bot 權杖，以及應用程式的 Basic Information -> App Credentials -> Signing Secret。使用相同的 Request URL 路徑設定企業帳號：

{  channels: {    slack: {      enabled: true,      mode: "http",      enterpriseOrgInstall: true,      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },      signingSecret: {        source: "env",        provider: "default",        id: "SLACK_SIGNING_SECRET",      },      webhookPath: "/slack/events",      dmPolicy: "open",      allowFrom: ["*"],      groupPolicy: "allowlist",      channels: {        C0123456789: { requireMention: true },      },    },  },}

啟動時，OpenClaw 會使用 Slack auth.test 驗證 enterpriseOrgInstall。若組織安裝的權杖未設定此旗標，或工作區權杖設定了此旗標，啟動都會失敗。哪些工作區已授予此安裝仍以 Slack 為真實資料來源；接著 OpenClaw 會將設定的頻道、使用者、私訊與提及政策套用至每個傳送的事件。無論 allowBots 為何，Enterprise V1 都會在分派前拒絕所有由 Bot 撰寫的 message 與 app_mention 事件，因為組織安裝不提供穩定且含工作區限定資訊的 Bot 身分來防止迴圈。

企業支援刻意限制為直接 Socket Mode 或 HTTP 的 message 與 app_mention 事件及其即時回覆。企業帳號無法使用轉送模式、斜線命令、互動功能、App Home、反應事件接聽器、釘選、Slack 動作工具、Slack 原生核准、繫結、佇列或排程傳送，以及主動傳送。透過接聽器擁有的 Slack 用戶端支援對外確認、輸入中與狀態反應，且需要 reactions:write；連入反應通知與反應動作工具仍無法使用。

即時回覆會沿用標準 Slack 傳送行為來處理分段、媒體、中繼資料、身分備援、連結展開與收據，但僅限經驗證且由接聽器擁有的用戶端仍處於作用中事件輪次時。記憶體內傳送佇列與討論串參與記錄會依該事件的工作區分割；用戶端本身絕不會序列化或持久保存。

頻道政策鍵與 dm.groupChannels 項目必須使用原始且穩定的 Slack 頻道 ID，或 channel:<id> 格式。OpenClaw 會將任一格式正規化為原始頻道 ID， 以供執行階段比對；使用 slack:、group: 和 mpim: 前綴會導致啟動失敗。 使用者政策項目必須使用穩定的 Slack 使用者 ID；名稱、slug、顯示名稱 和電子郵件地址都會導致啟動失敗。ID 必須使用 Slack 的標準大寫 前綴與主體（例如 C0123456789 或 U0123456789）；小寫形式與 較短的相似 ID 會導致啟動失敗。企業帳號無法啟用 dangerouslyAllowNameMatching。企業帳號可以設定全域 mentionPatterns.mode，但設定 mentionPatterns.allowIn 和 mentionPatterns.denyIn 會導致啟動失敗，因為單獨的 Slack 頻道 ID 並未 限定工作區，且可能在不同工作區中重複使用。工作區安裝 會保留現有的限定範圍提及模式行為。每個接受的工作區 都會取得各自獨立的路由、工作階段、逐字稿、去重、歷史記錄和快取身分， 即使 Slack ID 重疊也一樣。在 message 串流中，支援一般使用者訊息 以及由使用者建立的 file_share 事件；其他訊息子類型會在 授權或系統事件處理前遭到拒絕。

企業私訊必須停用（dm.enabled=false 或 dmPolicy="disabled"），或使用 dmPolicy="open" 明確開放，且 有效帳號的 allowFrom 必須包含常值 "*"。空白 允許清單或未包含 "*" 的特定使用者 ID 會導致啟動失敗。配對與 個別使用者的私訊允許清單會遭到拒絕，因為這些授權儲存區中的 Slack 使用者 ID 並未限定工作區。頻道與傳送者政策 仍會套用至頻道訊息。

安裝

openclaw plugins install @openclaw/slack

plugins install 會註冊並啟用此外掛。在你設定下方的 Slack 應用程式與頻道設定之前，它不會執行任何操作。一般外掛安裝規則請參閱外掛。

快速設定

本節中的資訊清單會建立工作區範圍的安裝。若要進行 Enterprise Grid 組織安裝，請改用專用的 全組織資訊清單與工作流程。

{"display_information": {"name": "OpenClaw","description": "適用於 OpenClaw 的 Slack 連接器"},"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 會將 Slack 助理對話串連接至 OpenClaw 代理程式。","suggested_prompts": [{ "title": "你能做什麼？", "message": "你能協助我處理什麼？" },{"title": "摘要此頻道","message": "摘要此頻道近期的活動。"},{ "title": "起草回覆", "message": "協助我起草回覆。" }]},"slash_commands": [{"command": "/openclaw","description": "傳送訊息給 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"]}}}

{"display_information": {"name": "OpenClaw","description": "適用於 OpenClaw 的 Slack 連接器"},"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 會將 Slack 助理對話串連接至 OpenClaw 代理程式。","suggested_prompts": [{ "title": "你能做什麼？", "message": "你能協助我處理什麼？" },{"title": "摘要此頻道","message": "摘要此頻道近期的活動。"},{ "title": "起草回覆", "message": "協助我起草回覆。" }]},"slash_commands": [{"command": "/openclaw","description": "傳送訊息給 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"]}}}

export SLACK_APP_TOKEN=slack-app-token-exampleexport SLACK_BOT_TOKEN=slack-bot-token-examplecat > 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=slack-app-token-exampleSLACK_BOT_TOKEN=slack-bot-token-example

openclaw gateway

{"display_information": {"name": "OpenClaw","description": "適用於 OpenClaw 的 Slack 連接器"},"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 會將 Slack 助理對話串連接至 OpenClaw 代理程式。","suggested_prompts": [{ "title": "你能做什麼？", "message": "你能協助我處理什麼？" },{"title": "摘要此頻道","message": "摘要此頻道近期的活動。"},{ "title": "起草回覆", "message": "協助我起草回覆。" }]},"slash_commands": [{"command": "/openclaw","description": "傳送訊息給 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"}}}

{"display_information": {"name": "OpenClaw","description": "OpenClaw 的 Slack 連接器"},"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 會將 Slack 助理討論串連接至 OpenClaw 代理程式。","suggested_prompts": [{ "title": "你能做什麼？", "message": "你能協助我處理什麼？" },{"title": "摘要此頻道","message": "摘要此頻道近期的活動。"},{ "title": "草擬回覆", "message": "協助我草擬回覆。" }]},"slash_commands": [{"command": "/openclaw","description": "傳送訊息給 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"}}}

export SLACK_BOT_TOKEN=slack-bot-token-exampleexport 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

Socket Mode 傳輸調校

OpenClaw 預設會將 Socket Mode 的 Slack SDK 用戶端 pong 逾時設為 15 秒。只有需要針對工作區或主機進行特定調校時，才覆寫傳輸設定：

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

只有在 Socket Mode 工作區記錄到 Slack websocket pong／伺服器 ping 逾時，或執行所在主機已知會發生事件迴圈飢餓時，才使用此設定。clientPingTimeout 是 SDK 傳送用戶端 ping 後等待 pong 的時間；serverPingTimeout 是等待 Slack 伺服器 ping 的時間。應用程式訊息與事件仍屬於應用程式狀態，而不是傳輸存活訊號。

注意事項：

• 在 HTTP Request URL 模式中，socketMode 會被忽略。
• 除非另有覆寫，基礎 channels.slack.socketMode 設定會套用至所有 Slack 帳號。各帳號的覆寫使用 channels.slack.accounts.<accountId>.socketMode；由於這是物件覆寫，因此請納入該帳號所需的每個 socket 調校欄位。
• 只有 clientPingTimeout 具有 OpenClaw 預設值（15000）。只有在設定後，serverPingTimeout 與 pingPongLoggingEnabled 才會傳遞給 Slack SDK。
• Socket Mode 重新啟動的退避時間從約 2 秒開始，上限約為 30 秒。可復原的啟動、等待啟動與中斷連線失敗會持續重試，直到頻道停止。無效驗證、已撤銷權杖或缺少範圍等永久性帳號與認證資訊錯誤會立即失敗，而不會無限重試。

資訊清單與範圍檢查清單

Socket Mode 與 HTTP Request URL 使用相同的基礎 Slack 應用程式資訊清單。只有 settings 區塊（以及斜線命令的 url）不同。

基礎資訊清單（Socket Mode 預設）：

{  "display_information": {    "name": "OpenClaw",    "description": "OpenClaw 的 Slack 連接器"  },  "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 會將 Slack 助理討論串連接至 OpenClaw 代理程式。",      "suggested_prompts": [        { "title": "你能做什麼？", "message": "你能協助我處理什麼？" },        {          "title": "摘要此頻道",          "message": "摘要此頻道近期的活動。"        },        { "title": "草擬回覆", "message": "協助我草擬回覆。" }      ]    },    "slash_commands": [      {        "command": "/openclaw",        "description": "傳送訊息給 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：

{  "features": {    "slash_commands": [      {        "command": "/openclaw",        "description": "傳送訊息給 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"    }  }}

其他資訊清單設定

提供不同功能，以擴充上述預設值。

預設資訊清單會啟用 Slack App Home 的 Home 分頁，並訂閱 app_home_opened。當工作區成員開啟 Home 分頁時，OpenClaw 會透過 views.publish 發布安全的預設 Home 檢視；其中不包含任何對話承載資料或私人設定。啟用單一斜線命令模式時，命令提示會使用 channels.slack.slashCommand.name；使用原生命令或未使用斜線命令的安裝則會省略該提示。Messages 分頁會維持啟用，以供 Slack 私訊使用。資訊清單也會透過 features.assistant_view、assistant:write、assistant_thread_started 與 assistant_thread_context_changed 啟用 Slack 助理討論串；助理討論串會路由至各自的 OpenClaw 討論串工作階段，並讓代理程式可以使用 Slack 提供的討論串內容。

{"slash_commands": [{"command": "/new","description": "開始新工作階段","usage_hint": "[model]"},{"command": "/reset","description": "重設目前的工作階段"},{"command": "/compact","description": "壓縮工作階段的情境","usage_hint": "[instructions]"},{"command": "/stop","description": "停止目前的執行"},{"command": "/session","description": "管理討論串繫結的到期時間","usage_hint": "idle <duration|off> or max-age <duration|off>"},{"command": "/think","description": "設定思考層級","usage_hint": "<level>"},{"command": "/verbose","description": "切換詳細輸出","usage_hint": "on|off|full"},{"command": "/fast","description": "顯示或設定快速模式","usage_hint": "[status|on|off]"},{"command": "/reasoning","description": "切換推理內容的可見性","usage_hint": "[on|off|stream]"},{"command": "/elevated","description": "切換提升權限模式","usage_hint": "[on|off|ask|full]"},{"command": "/exec","description": "顯示或設定執行預設值","usage_hint": "host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>"},{"command": "/approve","description": "核准或拒絕待處理的核准要求","usage_hint": "<id> <decision>"},{"command": "/model","description": "顯示或設定模型","usage_hint": "[name|#|status]"},{"command": "/models","description": "列出供應商／模型","usage_hint": "[provider] [page] [limit=<n>|size=<n>|all]"},{"command": "/help","description": "顯示簡短的說明摘要"},{"command": "/commands","description": "顯示產生的命令目錄"},{"command": "/tools","description": "顯示目前代理程式現在可以使用的項目","usage_hint": "[compact|verbose]"},{"command": "/agentstatus","description": "顯示執行階段狀態，包括可用時的供應商用量／配額"},{"command": "/tasks","description": "列出目前工作階段中作用中／最近的背景工作"},{"command": "/context","description": "說明情境的組合方式","usage_hint": "[list|detail|json]"},{"command": "/whoami","description": "顯示你的傳送者身分"},{"command": "/skill","description": "依名稱執行 Skill","usage_hint": "<name> [input]"},{"command": "/btw","description": "提出附帶問題而不變更工作階段情境","usage_hint": "<question>"},{"command": "/side","description": "提出附帶問題而不變更工作階段情境","usage_hint": "<question>"},{"command": "/usage","description": "控制用量頁尾或顯示費用摘要","usage_hint": "off|tokens|full|cost"}]}

{"slash_commands": [{"command": "/new","description": "開始新工作階段","usage_hint": "[model]","url": "https://gateway-host.example.com/slack/events"},{"command": "/help","description": "顯示簡短的說明摘要","url": "https://gateway-host.example.com/slack/events"}]}

權杖模型

• Socket Mode 需要 botToken + appToken。
• HTTP 模式需要 botToken + signingSecret。
• 轉送模式需要 botToken，以及 relay.url、relay.authToken 和 relay.gatewayId；它不使用應用程式權杖或簽署密鑰。
• botToken、appToken、signingSecret、relay.authToken 和 userToken 接受純文字 字串或 SecretRef 物件。
• 設定中的權杖會覆寫環境變數備援值。
• SLACK_BOT_TOKEN、SLACK_APP_TOKEN 和 SLACK_USER_TOKEN 的環境變數備援值都只套用於預設帳號。
• userToken 預設為唯讀行為（userTokenReadOnly: true）。

狀態快照行為：

• Slack 帳號檢查會追蹤各項認證資訊的 *Source 和 *Status 欄位（botToken、appToken、signingSecret、userToken）。
• 狀態為 available、configured_unavailable 或 missing。
• configured_unavailable 表示帳號是透過 SecretRef 或其他非內嵌的密鑰來源設定，但目前的命令／執行階段路徑 無法解析實際值。
• 在 HTTP 模式中會包含 signingSecretStatus；在 Socket Mode 中， 必要的組合是 botTokenStatus + appTokenStatus。

動作與閘門

Slack 動作由 channels.slack.actions.* 控制。

目前 Slack 工具中可用的動作群組：

目前的 Slack 訊息動作包括 send、upload-file、download-file、read、edit、delete、pin、unpin、list-pins、member-info 和 emoji-list。download-file 接受傳入檔案預留位置中顯示的 Slack 檔案 ID，並針對圖片傳回圖片預覽，或針對其他檔案類型傳回本機檔案中繼資料。

存取控制與路由

討論串、工作階段與回覆標籤

• 私訊路由為 direct；頻道路由為 channel；MPIM 路由為 group。
• Slack 路由綁定接受原始對端 ID，以及 channel:C12345678、user:U12345678 和 <@U12345678> 等 Slack 目標格式。
• 使用預設的 session.dmScope=main 時，Slack 私訊會合併至代理程式的主要工作階段。
• 頻道工作階段：agent:<agentId>:slack:channel:<channelId>。
• 一般的頂層頻道訊息會留在各頻道的工作階段中，即使 replyToMode 不是 off 也一樣。
• Slack 討論串回覆會使用父 Slack thread_ts 作為工作階段後綴（:thread:<threadTs>），即使透過 replyToMode="off" 停用傳出回覆的討論串功能也一樣。
• 當符合條件的頂層頻道根訊息預期會開始可見的 Slack 討論串時，OpenClaw 會將該根訊息植入 agent:<agentId>:slack:channel:<channelId>:thread:<rootTs>，讓根訊息與後續討論串回覆共用同一個 OpenClaw 工作階段。這適用於 app_mention 事件、明確提及機器人或符合已設定提及模式的情況，以及 requireMention: false 且 replyToMode 不是 off 的頻道。
• 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.<id>.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:<id>]]

若要從 message 工具明確回覆 Slack 討論串，請搭配 action: "send" 與 threadId 或 replyTo 設定 replyBroadcast: true，要求 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 作為相同的頂層退出設定。

確認反應

ackReaction 會在 OpenClaw 處理傳入訊息時傳送確認表情符號。ackReactionScope 決定該表情符號實際傳送的時機。

預設情況下，確認反應會保持不變，而 Slack 原生助理討論串狀態則會使用輪替的載入訊息顯示進度。設定 messages.statusReactions.enabled: true 可選擇使用排入佇列／思考／工具／完成／錯誤的反應生命週期。

表情符號（ackReaction）

解析順序：

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• 代理程式身分表情符號備援（agents.list[].identity.emoji，否則為 "eyes" / 👀）

注意事項：

• Slack 預期使用短代碼（例如 "eyes"）。
• 使用 "" 可針對 Slack 帳號或全域停用此反應。

範圍（messages.ackReactionScope）

Slack 提供者會從 messages.ackReactionScope 讀取範圍（預設為 "group-mentions"）。目前沒有 Slack 帳號層級或 Slack 頻道層級的覆寫；此值對閘道全域生效。

值：

• "all"：在私訊與群組中加入反應，包括環境房間事件。
• "direct"：僅在私訊中加入反應。
• "group-all"：對每則群組訊息加入反應，但環境房間事件除外（不含私訊）。
• "group-mentions"（預設）：在群組中加入反應，但僅限機器人被提及時（或在已選擇啟用的群組可提及項目中）。不包含私訊。
• "off" / "none"：永不加入反應。

{  messages: {    ackReaction: "eyes",    ackReactionScope: "all", // 在私訊與群組中加入反應  },}

文字串流

channels.slack.streaming 控制即時預覽行為：

• off：停用即時預覽串流。
• partial（預設）：以最新的部分輸出取代預覽文字。
• block：附加分塊的預覽更新。
• progress：生成時顯示進度狀態文字，然後傳送最終文字。
• streaming.preview.toolProgress：草稿預覽啟用時，將工具／進度更新路由至同一則經編輯的預覽訊息（預設為 true）。設為 false 可保留獨立的工具／進度訊息。
• streaming.preview.commandText / streaming.progress.commandText：設為 status 可在隱藏原始命令／執行文字的同時，保留精簡的工具進度行（預設為 raw）。

隱藏原始命令／執行文字，同時保留精簡進度行：

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

當 channels.slack.streaming.mode 為 partial 時，channels.slack.streaming.nativeTransport 控制 Slack 原生文字串流（預設為 true）。

Slack 原生進度工作卡片需在進度模式中選擇啟用。將 channels.slack.streaming.progress.nativeTaskCards 設為 true，並搭配 channels.slack.streaming.mode="progress"，即可在工作執行期間傳送 Slack 原生計畫／工作卡片，並在完成時更新同一張工作卡片。若未設定此旗標，進度模式會保留可攜式草稿預覽行為。

• 必須有可用的回覆討論串，原生文字串流與 Slack 助理討論串狀態才會顯示。討論串選擇仍遵循 replyToMode。
• 當原生串流無法使用或不存在回覆討論串時，頻道、群組聊天及頂層私訊根訊息仍可使用一般草稿預覽。
• 頂層 Slack 私訊預設不使用討論串，因此不會顯示 Slack 討論串樣式的原生串流／狀態預覽；OpenClaw 會改為在私訊中發佈並編輯草稿預覽。
• 媒體與非文字承載內容會退回一般傳遞方式。
• 媒體／錯誤最終結果會取消待處理的預覽編輯；符合條件的文字／區塊最終結果僅在可就地編輯預覽時才會送出。
• 若串流在回覆途中失敗，OpenClaw 會對剩餘承載內容退回一般傳遞方式。

使用草稿預覽，而非 Slack 原生文字串流：

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

選擇啟用 Slack 原生進度工作卡片：

{  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.<accountId>.typingReaction
• channels.slack.typingReaction

注意事項：

• Slack 預期使用短代碼（例如 "hourglass_flowing_sand"）。
• 此反應採盡力而為方式，並會在回覆或失敗路徑完成後自動嘗試清理。

語音輸入

目前若要在 Slack 中對 OpenClaw 說話，請將 Slack 音訊剪輯傳送至 OpenClaw 應用程式。Slackbot 的聽寫麥克風是 Slack 自有的獨立功能，並非應用程式 API。

• Slackbot 語音聽寫 位於使用者私人的 Slackbot 對話中。Slack 會將錄音轉為 Slackbot 提示，但不會透過 Events API 向第三方 Slack 應用程式發出音訊檔案、聽寫事件、提示或輸入來源標記。OpenClaw Slack 外掛無法啟用或接收該功能。
• Slack 音訊剪輯 是儲存於 Slack 的檔案，可發佈至 OpenClaw 私訊、頻道或討論串。OpenClaw 會使用機器人權杖下載可存取的剪輯、正規化 Slack 的剪輯 MIME 中繼資料，並透過共用的音訊轉錄管線傳送。建議的應用程式資訊清單包含必要的 files:read 範圍。

音訊剪輯與 Slackbot 聽寫具有不同的隱私語意：剪輯會遵循 Slack 檔案保留政策，且 OpenClaw 會下載剪輯以進行轉錄；Slack 則表示不會儲存聽寫音訊。

在 requireMention: true 的頻道中，沒有說明文字的音訊剪輯可藉由說出已設定的提及模式（agents.list[].groupChat.mentionPatterns，若無則退回 messages.groupChat.mentionPatterns）來通過閘控。OpenClaw 會在下載或轉錄剪輯前授權傳送者，然後僅在逐字稿相符時才允許其進入。失敗或不相符的推測性逐字稿會與已下載的剪輯一併捨棄；不會保留在頻道歷史記錄中。無法從語音推斷原生 Slack @bot 身分，因此請設定口述名稱模式，或加入輸入的提及。若已啟用逐字稿回顯，回顯只會在允許進入後傳送。

媒體、分塊與傳遞

指令與斜線指令行為

斜線指令在 Slack 中會顯示為單一已設定指令或多個原生指令。設定 channels.slack.slashCommand 可變更指令預設值：

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

/openclaw /help

原生指令需要在你的 Slack 應用程式中設定額外的資訊清單設定，並改用 channels.slack.commands.native: true 啟用，或在全域設定中使用 commands.native: true。

• Slack 的原生指令自動模式為關閉，因此 commands.native: "auto" 不會啟用 Slack 原生指令。

/help

原生引數選單會依下列優先順序呈現為其中一種形式：

• 3–5 個長度足夠短的選項：溢位（「...」）選單
• 超過 100 個選項，且可使用非同步選項篩選：外部選取器
• 1–2 個選項，或任一選項的編碼值過長而無法放入選取器：按鈕區塊
• 其他情況（6–100 個選項，或超過 100 個但沒有非同步篩選）：靜態選取選單，每個選單分成最多 100 個選項

/think

斜線指令工作階段使用類似 agent:<agentId>:slack:slash:<userId> 的隔離鍵，並仍透過 CommandTargetSessionKey 將指令執行路由至目標對話工作階段。

原生圖表

Slack 的公開 data_visualization Block Kit 區塊 可在訊息中呈現折線圖、長條圖、面積圖與圓餅圖。OpenClaw 會將可攜式 presentation chart 區塊對應至該原生格式；除了正常的 chat:write 訊息存取權限外，不需要額外的 OAuth 範圍、 檔案上傳、影像算繪器或 Slack 設定。

{  "blocks": [    {      "type": "chart",      "chartType": "bar",      "title": "季度營收",      "categories": ["Q1", "Q2"],      "series": [{ "name": "營收", "values": [120, 145] }],      "xLabel": "季度"    }  ]}

原生呈現前會強制套用 Slack 的限制：

• 標題與選用的座標軸標籤：50 個字元
• 圓餅圖：1–12 個正值區段
• 折線圖／長條圖／面積圖：1–12 個名稱不重複的數列，以及 1–20 個共用類別
• 區段、類別與數列標籤：20 個字元
• 每個數列都必須為每個類別包含一個有限數值；非圓餅圖的值 可以是負數

每個原生圖表也會附帶頂層文字表示，供螢幕閱讀器、 通知、工作階段鏡像，以及無法呈現該區塊的用戶端使用。傳送至其他 OpenClaw 頻道的標準簡報會以文字接收相同的確定性圖表資料，除非 該頻道宣告支援原生圖表。如果 Slack 在分階段推出期間以 invalid_blocks 拒絕圖表，OpenClaw 會移除遭拒的原生資料區塊、 保留任何同層控制項，並將完整的圖表表示作為可見文字傳送。

Slack 目前每則訊息最多接受兩個 data_visualization 區塊。當 簡報包含超過兩個有效圖表時，OpenClaw 會保留其順序， 並在後續訊息中繼續原生呈現，每則訊息不超過兩個 圖表。

Slack 的開發者發布公告 將此區塊記載為面向應用程式的 Block Kit 功能，且未公布任何付費 方案限制。Business+/Enterprise 的資格說明適用於 Slackbot 的自動 AI 圖表產生功能，這與應用程式傳送 已具結構的 Block Kit 圖表是不同的功能。圖表僅可用於訊息區塊，不能用於 App Home、互動視窗或 Canvas 內容。

原生表格

Slack 目前的 data_table Block Kit 區塊 可在訊息中呈現結構化的資料列與資料欄。OpenClaw 會將明確的 可攜式 presentation table 區塊對應至 data_table；它不會使用 Slack 的 舊版 table 區塊。 除了正常的 chat:write 訊息存取權限外，不需要額外的 OAuth 範圍或 Slack 設定。

{  "blocks": [    {      "type": "table",      "caption": "進行中的銷售管線",      "headers": ["客戶", "階段", "ARR"],      "rows": [        ["Acme", "成交", 125000],        ["Globex", "審查", 82000]      ],      "rowHeaderColumnIndex": 0    }  ]}

OpenClaw 會將標頭與字串儲存格對應至 Slack raw_text 儲存格。數值儲存格 會對應至 raw_number，並保留有限數值以供原生排序 與篩選。當 rowHeaderColumnIndex 存在時，會將該以零為起始索引的 資料欄標記為 Slack 資料列標頭。

原生呈現前會強制套用 Slack 公布的 data_table 限制：

• 1–20 個資料欄
• 1–100 個資料列，另加標頭列
• 每個資料列的儲存格數量相同
• 單一訊息中所有表格儲存格合計最多 10,000 個字元

只要訊息仍在字元總數限制內，多個有效的表格區塊即可原生 呈現。無法在原生限制範圍內呈現的表格會轉為完整且確定性的文字， 而不會遺失資料列或儲存格。如果該文字超出一則 Slack 訊息的容量， 傳送與斜線指令回應會使用有序的文字區塊。表格編輯若超出大小限制， 會以明確的大小錯誤失敗，而不會在既有訊息中 無聲截斷資料列。

每個由可攜式簡報產生的原生表格也會附帶頂層 文字表示，供螢幕閱讀器、通知、工作階段鏡像，以及 無法呈現該區塊的用戶端使用。原始圖表與表格值在備援表示中會維持原樣， 因此 <@U123> 等儲存格資料不會變成 Slack 提及。 如果 Slack 以 invalid_blocks 拒絕原生圖表或表格區塊，OpenClaw 會在一次有界的復原步驟中移除所有原生資料區塊，保留有效的 同層區塊（例如按鈕與選取器），並在停用 Slack 格式設定的情況下， 傳送完整且可見的圖表與表格文字。斜線指令傳遞會在整個指令執行期間 追蹤 Slack 的五次 response_url 呼叫預算。每批回覆前， 它會選擇可配合剩餘呼叫次數的完整方案，否則在發布 該批回覆前失敗。

只有明確的 presentation 表格區塊會提升為原生表格。 Markdown 管線表格會維持撰寫時的文字格式；OpenClaw 不會猜測表格 結構或儲存格類型。既有且受信任的 Slack 原生產生器仍可繼續 透過 channelData.slack.blocks 傳入原始區塊；OpenClaw 會從有效的原始 data_table 儲存格衍生備援文字，而格式錯誤的自訂區塊可能 降級為其說明文字或一般 Block Kit 備援表示。可攜式代理程式、命令列介面 與外掛輸出應使用 presentation。

互動式回覆

Slack 可以呈現由代理程式撰寫的互動式回覆控制項，但此功能預設停用。 新的代理程式、命令列介面與外掛輸出應優先使用共用的 presentation 按鈕或選取區塊。它們使用相同的 Slack 互動 路徑，也能在其他頻道上降級呈現。

全域啟用：

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

或僅為一個 Slack 帳號啟用：

{  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 專用的逃生機制；新的可攜式控制項請使用共用簡報。

指令編譯器 API 也已不建議用於新的產生器程式碼：

• compileSlackInteractiveReplies(...)
• parseSlackOptionsLine(...)
• isSlackInteractiveRepliesEnabled(...)
• buildSlackInteractiveBlocks(...)

新的 Slack 呈現控制項請使用 presentation 承載資料與 buildSlackPresentationBlocks(...)。

注意：

• 這是 Slack 專用的舊版 UI。其他頻道不會將 Slack Block Kit 指令轉換為其自身的按鈕系統。
• 互動回呼值是由 OpenClaw 產生的不透明權杖，而非代理程式撰寫的原始值。
• 如果產生的互動區塊會超出 Slack Block Kit 限制，OpenClaw 會改用原始文字回覆，而不是傳送無效的區塊承載資料。

外掛擁有的互動視窗提交

註冊互動處理常式的 Slack 外掛也能接收互動視窗 view_submission 與 view_closed 生命週期事件，之後 OpenClaw 才會壓縮 供代理程式查看的系統事件承載資料。開啟 Slack 互動視窗時，請使用下列其中一種路由 模式：

• 將 callback_id 設為 openclaw:<namespace>:<payload>。
• 或保留既有的 callback_id，並在互動視窗的 private_metadata 中放入 pluginInteractiveData: "<namespace>:<payload>"。

處理常式會接收值為 view_submission 或 view_closed 的 ctx.interaction.kind、正規化的 inputs，以及來自 Slack 的完整原始 stateValues 物件。僅使用回呼 ID 路由便足以叫用外掛處理常式；當 互動視窗還應產生供代理程式查看的系統事件時，請包含 既有互動視窗 private_metadata 中的使用者／工作階段路由欄位。代理程式會收到 精簡且經遮蔽的 Slack interaction: ... 系統事件。如果處理常式回傳 systemEvent.summary、systemEvent.reference 或 systemEvent.data，這些 欄位會包含在該精簡事件中，讓代理程式能參照 外掛擁有的儲存空間，而不會看到完整的表單承載資料。

Slack 中的原生核准

Slack 可作為具有互動按鈕與互動功能的原生核准用戶端，而不必改用 Web UI 或終端機。

• 執行與外掛核准可呈現為 Slack 原生 Block Kit 提示。
• channels.slack.execApprovals.* 仍是原生執行核准用戶端的啟用與私人訊息／頻道路由設定。
• 執行核准私人訊息使用 channels.slack.execApprovals.approvers 或 commands.ownerAllowFrom。
• 當 Slack 已針對原始工作階段啟用為原生核准用戶端，或 approvals.plugin 路由至原始 Slack 工作階段或 Slack 目標時，外掛核准會使用 Slack 原生按鈕。
• 外掛核准私人訊息使用來自 channels.slack.allowFrom、具名帳號 allowFrom 或帳號預設路由的 Slack 外掛核准者。
• 仍會強制執行核准者授權：僅有執行核准權限的核准者無法核准外掛要求，除非他們同時也是外掛核准者。

這會使用與其他頻道相同的共用核准按鈕介面。當你在 Slack 應用程式設定中啟用 interactivity 時，核准提示會直接在對話中顯示為 Block Kit 按鈕。 當這些按鈕存在時，它們就是主要的核准使用者體驗；只有在工具結果指出無法使用聊天核准，或手動核准是唯一途徑時，OpenClaw 才應包含手動 /approve 命令。

設定路徑：

• channels.slack.execApprovals.enabled
• channels.slack.execApprovals.approvers（選用；可行時會回退至 commands.ownerAllowFrom）
• channels.slack.execApprovals.target（dm | channel | both，預設：dm）
• agentFilter、sessionFilter

當 enabled 未設定或為 "auto"，且至少可解析出一位 執行核准者時，Slack 會自動啟用原生執行核准。當可解析出 Slack 外掛核准者，且請求符合原生用戶端篩選條件時，Slack 也可以透過這個原生用戶端 路徑處理原生外掛核准。設定 enabled: false 可明確停用 Slack 的原生核准用戶端功能。設定 enabled: true 可在解析出核准者時 強制啟用原生核准。停用 Slack 執行核准不會停用 透過 approvals.plugin 啟用的原生 Slack 外掛核准傳送；外掛核准 傳送改用 Slack 外掛核准者。

未明確設定 Slack 執行核准時的預設行為：

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

只有當你想覆寫核准者、新增篩選條件，或 選擇啟用來源聊天傳送時，才需要明確的 Slack 原生設定：

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

共用 approvals.exec 轉送是獨立的。只有當執行核准提示也必須 路由至其他聊天或明確的頻外目標時才使用它。共用 approvals.plugin 轉送也是 獨立的；只有當 Slack 能以原生方式處理外掛 核准請求時，Slack 原生傳送才會抑制該回退路徑。

同一聊天中的 /approve 也可用於已支援命令的 Slack 頻道和私訊。完整的核准轉送模型請參閱執行核准。

事件與操作行為

• 訊息編輯／刪除會對應為系統事件。
• 討論串廣播（「Also send to channel」討論串回覆）會被當作一般使用者訊息處理。
• 新增／移除回應事件會對應為系統事件。
• 成員加入／離開、頻道建立／重新命名，以及新增／移除釘選事件會對應為系統事件。
• 啟用 configWrites 時，channel_id_changed 可以遷移頻道設定鍵。
• 頻道主題／用途中繼資料會被視為不受信任的情境，並可注入路由情境。
• 適用時，討論串起始訊息和初始討論串歷史情境植入會依據已設定的傳送者允許清單進行篩選。
• 區塊動作、捷徑和互動視窗互動會發出結構化的 Slack interaction: ... 系統事件，並包含豐富的酬載欄位：
  • 區塊動作：已選值、標籤、選擇器值及 workflow_* 中繼資料
  • 全域捷徑：回呼和操作者中繼資料，路由至操作者的直接工作階段
  • 訊息捷徑：回呼、操作者、頻道、討論串和所選訊息情境
  • 互動視窗 view_submission 和 view_closed 事件，包含已路由的頻道中繼資料和表單輸入

在 Slack 應用程式設定中定義全域或訊息捷徑，並使用任意非空白回呼 ID。OpenClaw 會確認相符的捷徑酬載、套用與其他 Slack 互動相同的私訊／頻道傳送者政策，並將經過淨化的事件排入已路由代理程式工作階段的佇列。觸發 ID 和回應 URL 會從代理程式情境中遮蔽。

設定參考

主要參考資料：設定參考資料 - Slack。

疑難排解

{messages: {groupChat: {  visibleReplies: "automatic",},},}

openclaw channels status --probeopenclaw logs --followopenclaw doctor

openclaw pairing list slack

附件媒體參考資料

當 Slack 檔案下載成功且大小限制允許時，Slack 可以將下載的媒體附加至代理程式回合。音訊片段可以轉錄，影像檔案可以透過媒體理解路徑，或直接傳送至支援視覺的回覆模型，而其他檔案仍可作為可下載的檔案情境使用。

支援的媒體類型

輸入管線

當帶有檔案附件的 Slack 訊息送達時：

1. OpenClaw 使用機器人權杖，從 Slack 的私人 URL 下載檔案。
2. 成功後，檔案會寫入媒體儲存區。
3. 下載的媒體路徑和內容類型會新增至傳入內容脈絡。
4. 音訊片段會路由至共用的轉錄管線；支援影像的模型／工具路徑可使用相同內容脈絡中的影像附件。
5. 其他檔案仍會以檔案中繼資料或媒體參照的形式提供給能夠處理它們的工具。

繼承討論串根訊息的附件

當訊息出現在討論串中（具有 thread_ts 父項）：

• 如果回覆本身沒有直接附加的媒體，而納入的根訊息含有檔案，Slack 可載入根訊息的檔案，作為討論串起始內容脈絡。
• 只有在建立新的討論串工作階段或重設討論串工作階段時，才會載入根訊息的檔案。後續純文字回覆會重用現有的工作階段內容脈絡，不會將根訊息的檔案重新附加為新媒體。
• 直接附加至回覆的附件優先於根訊息的附件。
• 如果根訊息只有檔案而沒有文字，系統會以附件預留位置表示，讓後備機制仍可納入其檔案。

多附件處理

當單一 Slack 訊息包含多個檔案附件時：

• 每個附件都會透過媒體管線個別處理。
• 下載的媒體參照會彙整至訊息內容脈絡。
• 處理順序會依照事件承載資料中的 Slack 檔案順序。
• 單一附件下載失敗不會阻擋其他附件。

大小、下載與模型限制

• 大小上限：每個檔案預設為 20 MB。可透過 channels.slack.mediaMaxMb 設定。
• 音訊轉錄上限：將下載的檔案傳送至轉錄提供者或命令列介面時，也會套用 tools.media.audio.maxBytes。
• 下載失敗：Slack 無法提供的檔案、已過期的 URL、無法存取的檔案、超過大小上限的檔案，以及 Slack 驗證／登入 HTML 回應都會略過，而不會回報為不支援的格式。
• 視覺模型：當目前使用的回覆模型支援視覺時，影像分析會使用該模型；否則會使用在 agents.defaults.imageModel 設定的影像模型。

已知限制

相關文件

• 媒體理解管線
• 音訊與語音備忘錄
• PDF 工具

相關內容