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": "Slack connector for OpenClaw"  },  "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": "Slack connector for OpenClaw"  },  "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 隨後會將設定的頻道、使用者、私訊和提及原則套用至每個傳送的事件。Enterprise V1 會在分派前拒絕所有由機器人建立的 message 和 app_mention 事件，無論 allowBots 為何，因為組織安裝不會提供穩定且含工作區限定資訊的機器人身分來防止迴圈。

企業支援刻意僅限於直接 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 請求 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,      },    },  },}

僅針對會記錄 Slack WebSocket pong／伺服器 ping 逾時，或在已知會發生事件迴圈資源匱乏的主機上執行的 Socket Mode 工作區使用此設定。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 秒。可復原的啟動、等待啟動及中斷連線失敗會持續重試，直到頻道停止。無效驗證、已撤銷權杖或缺少範圍等永久性帳號與認證資訊錯誤會快速失敗，而不會無限重試。

Manifest 與範圍檢查清單

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

基礎 Manifest（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 模式，請將 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",        "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"    }  }}

其他 Manifest 設定

呈現擴充上述預設值的不同功能。

預設資訊清單會啟用 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": "顯示或設定 exec 預設值","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，並針對圖片傳回圖片預覽，或針對其他檔案類型傳回本機檔案中繼資料。

存取控制與路由

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

• 私人訊息會路由為 direct；頻道會路由為 channel；MPIM 會路由為 group。
• Slack 路由繫結接受原始對等端 ID，以及 channel:C12345678、user:U12345678 和 <@U12345678> 等 Slack 目標格式。
• 使用預設的 session.dmScope=main 時，一般 Slack 私人訊息會合併至代理程式的主要工作階段。Agent View 根項目和既有的 Assistant View 討論串仍會各自隔離為 :thread:<threadTs> 工作階段。
• 頻道工作階段：agent:<agentId>:slack:channel:<channelId>。
• 一般的頂層頻道訊息會留在每個頻道的工作階段中，即使 replyToMode 不是 off。
• Slack 頻道、MPIM、Agent View 和 Assistant View 的討論串回覆會使用父層 Slack thread_ts 作為工作階段後綴（:thread:<threadTs>）。一般私人訊息的回覆討論串仍只是基礎私人訊息工作階段上的 UI 操作方式。
• 當符合條件的頂層頻道根訊息預期會建立可見的 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 也會被視為相同的頂層選擇退出設定。

確認反應

OpenClaw 處理傳入訊息時，ackReaction 會傳送確認表情符號。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"：在私人訊息和群組中加入反應，包括環境聊天室事件。
• "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.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，並將 pluginInteractiveData: "<namespace>:<payload>" 放入互動視窗的 private_metadata。

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

Slack 中的原生核准

Slack 可以透過互動式按鈕和互動操作作為原生核准用戶端，而不必退回使用網頁 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：監控相同的對話，但不限制參與者人數，並包含頂層頻道工作階段。使用個別頻道覆寫可強制啟用或抑制某個頻道。

每個 Slack 帳號每分鐘最多輪詢 45 位不重複使用者；OpenClaw 會植入第一次結果而不喚醒代理程式，且只有在觀察到從 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 工具

相關內容