Slack

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

選擇傳輸方式

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

轉送模式

轉送模式會將 Slack 輸入流量與 OpenClaw 閘道分離。受信任的路由器管理單一 Slack Socket Mode 連線、選擇目的閘道，並透過經驗證的 websocket 轉送具型別的事件。閘道仍會使用自己的機器人權杖進行對外 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",      },    },  },}

除非目標為 localhost，否則轉送 URL 必須使用 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 的應用程式層級權杖，然後從組織安裝複製機器人權杖。設定使用組織安裝機器人權杖的帳號：

{  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 後，請複製組織安裝的機器人權杖，以及應用程式的 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 都會在分派前拒絕所有由機器人建立的 message 與 app_mention 事件，因為組織安裝不會提供穩定且具工作區限定範圍的機器人身分，以防止迴圈。

企業支援刻意限制為直接使用 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）；小寫及 看似相近的短格式會導致啟動失敗。企業帳號無法啟用 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},"agent_view": {"agent_description": "OpenClaw 會將 Slack Agent View 對話連接至 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","app_context_changed","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},"agent_view": {"agent_description": "OpenClaw 會將 Slack Agent View 對話連接至 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","app_context_changed","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},"agent_view": {"agent_description": "OpenClaw 會將 Slack Agent View 對話連接至 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","app_context_changed","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},"agent_view": {"agent_description": "OpenClaw 將 Slack Agent View 對話連接至 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","app_context_changed","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

使用者身分（以真人身分發文）

使用者身分可讓 OpenClaw 以授權 Slack 應用程式的人類使用者身分讀取及發文。userToken 是執行操作的身分；搭配的 Slack 應用程式會透過 Socket Mode 或 HTTP Request URL 承載 Events API 流量。搭配的應用程式不需要機器人使用者或機器人權杖。

請依下列方式設定搭配的應用程式：

1. 在 OAuth & Permissions -> User Token Scopes 下，新增以下使用者範圍權限：

   • 歷史記錄：channels:history、groups:history、im:history、mpim:history
   • 對話查詢：channels:read、groups:read、im:read、mpim:read
   • 人員：users:read
   • 發文：chat:write（訊息會以授權使用者的身分發文）
   • 開啟私訊：im:write、mpim:write

2. 在 Event Subscriptions -> Subscribe to events on behalf of users 下，新增以下使用者事件。請勿只將它們新增至機器人事件清單：

   • message.channels
   • message.groups
   • message.im
   • message.mpim

3. 選擇一種事件傳輸方式：

   • **Socket Mode：**啟用 Socket Mode，並建立具有 connections:write 的應用程式層級權杖。將其設定為 appToken。
   • **HTTP Request URL：**將 Event Subscriptions 指向公開的 OpenClaw Slack 端點，並複製 Basic Information -> App Credentials -> Signing Secret。將其設定為 signingSecret。

4. 安裝或重新安裝應用程式，以預定的人類使用者身分授權，並將產生的使用者 OAuth 權杖複製至 userToken。

Socket Mode 設定：

{  channels: {    slack: {      identity: "user",      userToken: "<xoxp>",      appToken: "<xapp>",    },  },}

HTTP Request URL 設定：

{  channels: {    slack: {      identity: "user",      mode: "http",      userToken: "<xoxp>",      signingSecret: "<signing-secret>",      webhookPath: "/slack/events",    },  },}

OpenClaw 會自動捨棄由已解析人類身分所發出的使用者範圍訊息事件，因此它傳送的訊息不會觸發自我回覆。

Socket Mode 傳輸調校

對於 Socket Mode，OpenClaw 預設將 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 的時間。應用程式訊息和事件仍屬於應用程式狀態，而非傳輸存活訊號。

注意事項：

• socketMode 在 HTTP Request URL 模式中會被忽略。
• 除非遭到覆寫，基礎 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    },    "agent_view": {      "agent_description": "OpenClaw 將 Slack Agent View 對話連接至 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",        "app_context_changed",        "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 模式，請以 HTTP 變體取代 settings，並在每個斜線命令中新增 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",        "app_context_changed",        "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.agent_view、assistant:write 和 app_context_changed 使用 Slack Agent View。每個可見的 Agent View 根節點都會路由至各自的 OpenClaw 討論串工作階段，而 Slack 排序後的使用中檢視實體只會以不受信任的上下文傳遞給代理程式。

已使用 features.assistant_view 的現有應用程式可以保留目前的資訊清單。OpenClaw 會繼續為這些安裝處理 assistant_thread_started 和 assistant_thread_context_changed。Slack 不允許撤銷從 Assistant View 到 Agent View 的遷移，且遷移後需要使用者強制重新整理，因此在你打算遷移整個工作區之前，請勿替換現有應用程式上的 assistant_view。

{"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": "閒置 <duration|off> 或最長存續期 <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": "/login","description": "配對 Codex 登入","usage_hint": "[codex|openai]"},{"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。
• 使用者身分在 Socket Mode 中需要 userToken + appToken，在 HTTP 模式中則需要 userToken + 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，對使用者身分則使用 userTokenStatus + 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，並針對圖片傳回圖片預覽，或針對其他檔案類型傳回本機檔案中繼資料。

存取控制與路由

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

• DM 路由為 direct；頻道路由為 channel；MPIM 路由為 group。
• Slack 路由繫結接受原始對等端 ID，以及 channel:C12345678、user:U12345678 和 <@U12345678> 等 Slack 目標格式。
• 使用預設的 session.dmScope=main 時，一般 Slack DM 會合併至代理程式的主要工作階段。Agent View 根節點與既有的 Assistant View 討論串仍會隔離為 :thread:<threadTs> 工作階段。
• 頻道工作階段：agent:<agentId>:slack:channel:<channelId>。
• 一般的頂層頻道訊息會留在各頻道的工作階段中，即使 replyToMode 不是 off 也一樣。
• Slack 頻道、MPIM、Agent View 和 Assistant View 的討論串回覆會使用上層 Slack thread_ts 作為工作階段後綴（:thread:<threadTs>）。一般 DM 回覆討論串仍只是基礎 DM 工作階段上的介面功能。
• 當符合條件的頂層頻道根訊息預期會啟動可見的 Slack 討論串時，OpenClaw 會將該根訊息植入 agent:<agentId>:slack:channel:<channelId>:thread:<rootTs>，讓根訊息與之後的討論串回覆共用同一個 OpenClaw 工作階段。這適用於 app_mention 事件、明確提及機器人或符合已設定提及模式的情況，以及具有非 off replyToMode 的 requireMention: false 頻道。
• channels.slack.thread.historyScope 的預設值為 thread；thread.inheritParent 的預設值為 false。
• channels.slack.thread.initialHistoryLimit 控制新討論串工作階段啟動時要擷取多少則既有討論串訊息（預設為 20；設為 0 可停用）。
• channels.slack.implicitMentions.replyToBot 控制回覆機器人自己的訊息時，是否略過提及閘門（預設為 true）。
• channels.slack.implicitMentions.threadParticipation 控制機器人曾回覆的討論串中的後續訊息是否略過提及閘門（預設為 true）。將其設為 false，即可要求這些後續訊息再次明確提及機器人。openclaw doctor --fix 會將先前的 channels.slack.thread.requireExplicitMention 索引鍵遷移至此正向標準旗標。
• 帳號覆寫位於 channels.slack.accounts.<id>.implicitMentions；共用預設值位於 channels.defaults.implicitMentions。

回覆討論串控制項：

• 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 討論串，請將 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 也可作為相同的頂層退出選項。

確認回應

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

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

表情符號（ackReaction）

解析順序：

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• 代理程式身分表情符號後援（agents.entries.*.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"：永不加入表情回應。

{  messages: {    ackReaction: "eyes",    ackReactionScope: "all", // 在 DM 和群組中加入表情回應  },}

文字串流

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.entries.*.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": "Quarterly revenue",      "categories": ["Q1", "Q2"],      "series": [{ "name": "Revenue", "values": [120, 145] }],      "xLabel": "Quarter"    }  ]}

原生算繪前會強制執行 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": "Open pipeline",      "headers": ["Account", "Stage", "ARR"],      "rows": [        ["Acme", "Won", 125000],        ["Globex", "Review", 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 外掛，也能在 OpenClaw 為代理程式可見的 系統事件壓縮承載資料前，接收互動視窗 view_submission 和 view_closed 生命週期事件。開啟 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 的 Slack 外掛核准者、具名帳號的 allowFrom，或帳號預設路由。
• 仍會強制執行核准者授權：僅具執行核准權限的核准者，除非同時也是外掛核准者，否則無法核准外掛請求。

這會使用與其他頻道相同的共用核准按鈕介面。當你的 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」討論串回覆）會視為一般使用者訊息處理。
• 新增／移除回應事件會對應為系統事件。
• 成員加入／離開、頻道建立／重新命名，以及釘選新增／移除事件會對應為系統事件。
• 選用的上線狀態輪詢，可以將觀察到的人類參與者從 away 到 active 的轉換，對應至該參與者最近活躍且符合資格的 Slack 工作階段。預設為停用。
• 啟用 configWrites 時，channel_id_changed 可以遷移頻道組態鍵。
• 頻道主題／用途中繼資料會視為不受信任的上下文，並可注入路由上下文。
• Agent View app_context 實體會依 Slack 相關性順序驗證，且只會作為結構化的不受信任上下文公開；省略的上下文會清除該回合，而不是重複使用過時實體。
• 適用時，討論串起始訊息與初始討論串歷史上下文植入會依設定的傳送者允許清單篩選。
• 區塊動作、捷徑和互動視窗互動會發出結構化的 Slack interaction: ... 系統事件，並包含豐富的承載資料欄位：
  • 區塊動作：選取值、標籤、選擇器值，以及 workflow_* 中繼資料
  • 全域捷徑：回呼與動作者中繼資料，路由至動作者的直接工作階段
  • 訊息捷徑：回呼、動作者、頻道、討論串，以及所選訊息的上下文
  • 互動視窗 view_submission 與 view_closed 事件，包含已路由的頻道中繼資料與表單輸入

請在 Slack 應用程式組態中定義全域或訊息捷徑，並使用任何非空白回呼 ID。OpenClaw 會確認相符的捷徑承載資料、套用與其他 Slack 互動相同的私訊／頻道傳送者政策，並將已清理的事件排入路由後代理程式工作階段的佇列。觸發 ID 和回應 URL 會從代理程式上下文中遮蔽。

上線狀態事件

Slack 不會透過 Events API 或 Socket Mode 傳送上線狀態變更。OpenClaw 可以改為針對訊息已通過一般 Slack 存取與路由檢查的人類參與者，輪詢 users.getPresence。

{  channels: {    slack: {      presenceEvents: { mode: "auto" },      channels: {        C0123456789: { presenceEvents: { mode: "on" } },        C0987654321: { presenceEvents: { mode: "off" } },      },    },  },}

• off（預設）：不啟動上線狀態計時器，也不呼叫 Slack API。
• auto：監控過去 24 小時內活躍的私訊、MPIM 和 Slack 討論串，最多觀察 8 位人類參與者。不包含頂層頻道工作階段。
• on：監控相同的對話，不設參與者上限，並包含頂層頻道工作階段。使用各頻道覆寫來強制監控或排除特定頻道。

OpenClaw 每個 Slack 帳號每分鐘最多輪詢 45 位不重複使用者，植入第一次結果時不會喚醒代理程式，且只會在觀察到從 away 到 active 的轉換時喚醒。每個 Slack 帳號與使用者都會套用持久的 8 小時冷卻期，即使該人參與多個討論串亦然。事件只會路由至該人最近活躍且符合資格的對話，並指示代理程式在決定是否傳送一句簡短問候前，先查閱記憶／Wiki 和已知時區上下文。代理程式可以保持沉默。

機器人權杖需要 users:read，建議的資訊清單中已包含此項。Enterprise Grid 全組織安裝無法使用上線狀態事件。

組態參考

主要參考：組態參考 - 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.models[] 項目之 maxBytes 也會套用。
• 下載失敗：Slack 無法提供的檔案、過期的 URL、無法存取的檔案、超過大小限制的檔案，以及 Slack 驗證／登入 HTML 回應，都會略過，而不會回報為不支援的格式。
• 視覺模型：當使用中的回覆模型支援視覺時，圖片分析會使用該模型；否則使用在 agents.defaults.imageModel 設定的圖片模型。

已知限制

相關文件

• 媒體理解流水線
• 音訊與語音留言
• PDF 工具

相關內容