Slack

已可透過 Slack app 整合用於正式環境中的 DM 與頻道。預設模式為 Socket 模式；也支援 HTTP 請求 URL。

# 選擇 Socket 模式或 HTTP 請求 URL

兩種傳輸方式都已可用於正式環境，並在訊息傳送、斜線命令、App Home 與互動性方面達到功能一致。請依部署型態選擇，而不是依功能選擇。

# 快速設定

{
"display_information": {
"name": "OpenClaw",
"description": "Slack connector for OpenClaw"
},
"features": {
"bot_user": { "display_name": "OpenClaw", "always_online": true },
"app_home": {
"home_tab_enabled": true,
"messages_tab_enabled": true,
"messages_tab_read_only_enabled": false
},
"slash_commands": [
{
"command": "/openclaw",
"description": "Send a message to OpenClaw",
"should_escape": false
}
]
},
"oauth_config": {
"scopes": {
"bot": [
"app_mentions:read",
"assistant:write",
"channels:history",
"channels:read",
"chat:write",
"commands",
"emoji:read",
"files:read",
"files:write",
"groups:history",
"groups:read",
"im:history",
"im:read",
"im:write",
"mpim:history",
"mpim:read",
"mpim:write",
"pins:read",
"pins:write",
"reactions:read",
"reactions:write",
"usergroups:read",
"users:read"
]
}
},
"settings": {
"socket_mode_enabled": true,
"event_subscriptions": {
"bot_events": [
"app_home_opened",
"app_mention",
"channel_rename",
"member_joined_channel",
"member_left_channel",
"message.channels",
"message.groups",
"message.im",
"message.mpim",
"pin_added",
"pin_removed",
"reaction_added",
"reaction_removed"
]
}
}
}

{
"display_information": {
"name": "OpenClaw",
"description": "Slack connector for OpenClaw"
},
"features": {
"bot_user": { "display_name": "OpenClaw", "always_online": true },
"app_home": {
"home_tab_enabled": true,
"messages_tab_enabled": true,
"messages_tab_read_only_enabled": false
},
"slash_commands": [
{
"command": "/openclaw",
"description": "Send a message to OpenClaw",
"should_escape": false
}
]
},
"oauth_config": {
"scopes": {
"bot": [
"app_mentions:read",
"assistant:write",
"channels:history",
"channels:read",
"chat:write",
"commands",
"groups:history",
"groups:read",
"im:history",
"im:read",
"im:write",
"users:read"
]
}
},
"settings": {
"socket_mode_enabled": true,
"event_subscriptions": {
"bot_events": [
"app_home_opened",
"app_mention",
"message.channels",
"message.groups",
"message.im"
]
}
}
}

export SLACK_APP_TOKEN=xapp-...
export SLACK_BOT_TOKEN=xoxb-...
cat > slack.socket.patch.json5 <<'JSON5'
{
channels: {
slack: {
enabled: true,
mode: "socket",
appToken: { source: "env", provider: "default", id: "SLACK_APP_TOKEN" },
botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },
},
},
}
JSON5
openclaw config patch --file ./slack.socket.patch.json5 --dry-run
openclaw config patch --file ./slack.socket.patch.json5

SLACK_APP_TOKEN=xapp-...
SLACK_BOT_TOKEN=xoxb-...

openclaw gateway

{
"display_information": {
"name": "OpenClaw",
"description": "Slack connector for OpenClaw"
},
"features": {
"bot_user": { "display_name": "OpenClaw", "always_online": true },
"app_home": {
"home_tab_enabled": true,
"messages_tab_enabled": true,
"messages_tab_read_only_enabled": false
},
"slash_commands": [
{
"command": "/openclaw",
"description": "Send a message to OpenClaw",
"should_escape": false,
"url": "https://gateway-host.example.com/slack/events"
}
]
},
"oauth_config": {
"scopes": {
"bot": [
"app_mentions:read",
"assistant:write",
"channels:history",
"channels:read",
"chat:write",
"commands",
"emoji:read",
"files:read",
"files:write",
"groups:history",
"groups:read",
"im:history",
"im:read",
"im:write",
"mpim:history",
"mpim:read",
"mpim:write",
"pins:read",
"pins:write",
"reactions:read",
"reactions:write",
"usergroups:read",
"users:read"
]
}
},
"settings": {
"event_subscriptions": {
"request_url": "https://gateway-host.example.com/slack/events",
"bot_events": [
"app_home_opened",
"app_mention",
"channel_rename",
"member_joined_channel",
"member_left_channel",
"message.channels",
"message.groups",
"message.im",
"message.mpim",
"pin_added",
"pin_removed",
"reaction_added",
"reaction_removed"
]
},
"interactivity": {
"is_enabled": true,
"request_url": "https://gateway-host.example.com/slack/events",
"message_menu_options_url": "https://gateway-host.example.com/slack/events"
}
}
}

{
"display_information": {
"name": "OpenClaw",
"description": "Slack connector for OpenClaw"
},
"features": {
"bot_user": { "display_name": "OpenClaw", "always_online": true },
"app_home": {
"home_tab_enabled": true,
"messages_tab_enabled": true,
"messages_tab_read_only_enabled": false
},
"slash_commands": [
{
"command": "/openclaw",
"description": "Send a message to OpenClaw",
"should_escape": false,
"url": "https://gateway-host.example.com/slack/events"
}
]
},
"oauth_config": {
"scopes": {
"bot": [
"app_mentions:read",
"assistant:write",
"channels:history",
"channels:read",
"chat:write",
"commands",
"groups:history",
"groups:read",
"im:history",
"im:read",
"im:write",
"users:read"
]
}
},
"settings": {
"event_subscriptions": {
"request_url": "https://gateway-host.example.com/slack/events",
"bot_events": [
"app_home_opened",
"app_mention",
"message.channels",
"message.groups",
"message.im"
]
},
"interactivity": {
"is_enabled": true,
"request_url": "https://gateway-host.example.com/slack/events",
"message_menu_options_url": "https://gateway-host.example.com/slack/events"
}
}
}

export SLACK_BOT_TOKEN=xoxb-...
export SLACK_SIGNING_SECRET=...
cat > slack.http.patch.json5 <<'JSON5'
{
channels: {
slack: {
enabled: true,
mode: "http",
botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },
signingSecret: { source: "env", provider: "default", id: "SLACK_SIGNING_SECRET" },
webhookPath: "/slack/events",
},
},
}
JSON5
openclaw config patch --file ./slack.http.patch.json5 --dry-run
openclaw config patch --file ./slack.http.patch.json5

openclaw gateway

# Socket Mode 傳輸調校

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

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

只有在 Socket Mode 工作區記錄 Slack websocket pong/server-ping timeout，或在已知有事件迴圈飢餓問題的主機上執行時，才使用此設定。clientPingTimeout 是 SDK 傳送 client ping 後等待 pong 的時間；serverPingTimeout 是等待 Slack server ping 的時間。App 訊息和事件仍是應用程式狀態，而不是傳輸存活訊號。

# Manifest 與 scope 檢查清單

基礎 Slack app manifest 對 Socket Mode 和 HTTP Request URLs 都相同。只有 settings 區塊（以及 slash command 的 url）不同。

基礎 manifest（Socket Mode 預設）：

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Slack connector for OpenClaw"
  },
  "features": {
    "bot_user": { "display_name": "OpenClaw", "always_online": true },
    "app_home": {
      "home_tab_enabled": true,
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Send a message to OpenClaw",
        "should_escape": false
      }
    ]
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "assistant:write",
        "channels:history",
        "channels:read",
        "chat:write",
        "commands",
        "emoji:read",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "pins:read",
        "pins:write",
        "reactions:read",
        "reactions:write",
        "usergroups:read",
        "users:read"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    }
  }
}

若使用 HTTP Request URLs 模式，請將 settings 替換為 HTTP 變體，並為每個 slash command 新增 url。需要公開 URL：

{
  "features": {
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Send a message to OpenClaw",
        "should_escape": false,
        "url": "https://gateway-host.example.com/slack/events"
      }
    ]
  },
  "settings": {
    "event_subscriptions": {
      "request_url": "https://gateway-host.example.com/slack/events",
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    },
    "interactivity": {
      "is_enabled": true,
      "request_url": "https://gateway-host.example.com/slack/events",
      "message_menu_options_url": "https://gateway-host.example.com/slack/events"
    }
  }
}

# 其他 manifest 設定

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

預設 manifest 會啟用 Slack App Home 的 Home 分頁，並訂閱 app_home_opened。當工作區成員開啟 Home 分頁時，OpenClaw 會使用 views.publish 發布安全的預設 Home 檢視；不會包含任何對話 payload 或私人設定。Messages 分頁仍會為 Slack DM 啟用。

{
"slash_commands": [
{
"command": "/new",
"description": "Start a new session",
"usage_hint": "[model]"
},
{
"command": "/reset",
"description": "Reset the current session"
},
{
"command": "/compact",
"description": "Compact the session context",
"usage_hint": "[instructions]"
},
{
"command": "/stop",
"description": "Stop the current run"
},
{
"command": "/session",
"description": "Manage thread-binding expiry",
"usage_hint": "idle <duration|off> or max-age <duration|off>"
},
{
"command": "/think",
"description": "Set the thinking level",
"usage_hint": "<level>"
},
{
"command": "/verbose",
"description": "Toggle verbose output",
"usage_hint": "on|off|full"
},
{
"command": "/fast",
"description": "Show or set fast mode",
"usage_hint": "[status|on|off]"
},
{
"command": "/reasoning",
"description": "Toggle reasoning visibility",
"usage_hint": "[on|off|stream]"
},
{
"command": "/elevated",
"description": "Toggle elevated mode",
"usage_hint": "[on|off|ask|full]"
},
{
"command": "/exec",
"description": "Show or set exec defaults",
"usage_hint": "host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>"
},
{
"command": "/model",
"description": "Show or set the model",
"usage_hint": "[name|#|status]"
},
{
"command": "/models",
"description": "List providers/models",
"usage_hint": "[provider] [page] [limit=<n>|size=<n>|all]"
},
{
"command": "/help",
"description": "Show the short help summary"
},
{
"command": "/commands",
"description": "Show the generated command catalog"
},
{
"command": "/tools",
"description": "Show what the current agent can use right now",
"usage_hint": "[compact|verbose]"
},
{
"command": "/agentstatus",
"description": "Show runtime status, including provider usage/quota when available"
},
{
"command": "/tasks",
"description": "List active/recent background tasks for the current session"
},
{
"command": "/context",
"description": "Explain how context is assembled",
"usage_hint": "[list|detail|json]"
},
{
"command": "/whoami",
"description": "Show your sender identity"
},
{
"command": "/skill",
"description": "Run a skill by name",
"usage_hint": "<name> [input]"
},
{
"command": "/btw",
"description": "Ask a side question without changing session context",
"usage_hint": "<question>"
},
{
"command": "/side",
"description": "Ask a side question without changing session context",
"usage_hint": "<question>"
},
{
"command": "/usage",
"description": "Control the usage footer or show cost summary",
"usage_hint": "off|tokens|full|cost"
}
]
}

{
"slash_commands": [
{
"command": "/new",
"description": "Start a new session",
"usage_hint": "[model]",
"url": "https://gateway-host.example.com/slack/events"
},
{
"command": "/help",
"description": "Show the short help summary",
"url": "https://gateway-host.example.com/slack/events"
}
]
}

# 權杖模型

• Socket Mode 需要 botToken + appToken。
• HTTP 模式需要 botToken + signingSecret。
• botToken、appToken、signingSecret 和 userToken 接受純文字 字串或 SecretRef 物件。
• 設定權杖會覆寫 env 後援。
• SLACK_BOT_TOKEN / SLACK_APP_TOKEN env 後援只套用於預設帳號。
• userToken (xoxp-...) 僅能透過設定提供（沒有 env 後援），並預設為唯讀行為 (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，並針對圖片回傳圖片預覽，或針對其他檔案類型回傳本機檔案中繼資料。

# 存取控制與路由

# 執行緒、工作階段與回覆標籤

• DM 路由為 direct；頻道路由為 channel；MPIM 路由為 group。
• Slack 路由繫結接受原始對等 ID，以及 Slack 目標形式，例如 channel:C12345678、user:U12345678 和 <@U12345678>。
• 使用預設 session.dmScope=main 時，Slack DM 會收斂到代理程式主工作階段。
• 頻道工作階段：agent:<agentId>:slack:channel:<channelId>。
• 適用時，執行緒回覆可建立執行緒工作階段後綴（:thread:<threadTs>）。
• channels.slack.thread.historyScope 預設為 thread；thread.inheritParent 預設為 false。
• channels.slack.thread.initialHistoryLimit 控制新執行緒工作階段開始時擷取多少既有執行緒訊息（預設 20；設為 0 可停用）。
• channels.slack.thread.requireExplicitMention（預設 false）：當為 true 時，會抑制隱含的執行緒提及，因此 bot 只會回應執行緒內明確的 @bot 提及，即使 bot 已參與該執行緒。若沒有此設定，在 bot 已參與的執行緒中的回覆會略過 requireMention 閘門。

回覆執行緒控制：

• channels.slack.replyToMode: off|first|all|batched（預設 off）
• channels.slack.replyToModeByChatType：依 direct|group|channel
• 直接聊天的舊版後援：channels.slack.dm.replyToMode

支援手動回覆標籤：

• [[reply_to_current]]
• [[reply_to:<id>]]

# 確認反應

ackReaction 會在 OpenClaw 處理入站訊息時傳送確認 emoji。

解析順序：

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• 代理程式身分 emoji 後援（agents.list[].identity.emoji，否則為 "👀"）

注意事項：

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

# 文字串流

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

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

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

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

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

• 必須有可用的回覆執行緒，原生文字串流和 Slack 助理執行緒狀態才會出現。執行緒選擇仍遵循 replyToMode。
• 當原生串流不可用或沒有回覆執行緒時，頻道、群組聊天和頂層 DM 根仍可使用一般草稿預覽。
• 頂層 Slack DM 預設保持非執行緒狀態，因此不會顯示 Slack 的執行緒樣式原生串流/狀態預覽；OpenClaw 會改為在 DM 中發佈並編輯草稿預覽。
• 媒體和非文字酬載會後援到一般傳遞。
• 媒體/錯誤最終訊息會取消待處理的預覽編輯；合格的文字/區塊最終訊息只有在可就地編輯預覽時才會清空。
• 如果串流在回覆中途失敗，OpenClaw 會針對剩餘酬載後援到一般傳遞。

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

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

舊版鍵：

• channels.slack.streamMode (replace | status_final | append) 是 channels.slack.streaming.mode 的舊版執行階段別名。
• 布林值 channels.slack.streaming 是 channels.slack.streaming.mode 和 channels.slack.streaming.nativeTransport 的舊版執行階段別名。
• 舊版 channels.slack.nativeStreaming 是 channels.slack.streaming.nativeTransport 的執行階段別名。
• 執行 openclaw doctor --fix，將已保存的 Slack 串流設定重寫為標準鍵。

# 輸入中反應備援

typingReaction 會在 OpenClaw 處理回覆時，為傳入的 Slack 訊息新增暫時反應，並在執行完成時移除。這在執行緒回覆之外最有用；執行緒回覆會使用預設的「正在輸入...」狀態指示器。

解析順序：

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

注意事項：

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

# 媒體、分塊與傳遞

# 指令與斜線行為

斜線指令在 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

原生參數選單使用自適應轉譯策略，會在分派所選選項值之前顯示確認互動視窗：

• 最多 5 個選項：按鈕區塊
• 6-100 個選項：靜態選取選單
• 超過 100 個選項：當互動選項處理常式可用時，使用外部選取並進行非同步選項篩選
• 超過 Slack 限制：編碼後的選項值會退回使用按鈕

/think

斜線工作階段使用像 agent:<agentId>:slack:slash:<userId> 這樣的隔離鍵，並仍會使用 CommandTargetSessionKey 將指令執行路由到目標對話工作階段。

# 互動式回覆

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 專用 UI。其他通道不會將 Slack Block Kit 指示詞轉換成各自的按鈕系統。
• 互動回呼值是由 OpenClaw 產生的不透明權杖，不是代理程式撰寫的原始值。
• 如果產生的互動區塊會超過 Slack Block Kit 限制，OpenClaw 會退回使用原始文字回覆，而不是傳送無效的區塊承載。

# Slack 中的執行核准

Slack 可以作為具備互動式按鈕與互動的原生核准用戶端，而不是退回使用 Web UI 或終端機。

• 執行核准使用 channels.slack.execApprovals.* 進行原生 DM/通道路由。
• 當請求已落在 Slack 中且核准 ID 類型為 plugin: 時，Plugin 核准仍可透過同一個 Slack 原生按鈕介面解析。
• 核准者授權仍會強制執行：只有被識別為核准者的使用者才能透過 Slack 核准或拒絕請求。

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

設定路徑：

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

當 enabled 未設定或為 "auto"，且至少解析出一位核准者時，Slack 會自動啟用原生執行核准。設定 enabled: false 可明確停用 Slack 作為原生核准用戶端。 設定 enabled: true 可在核准者解析成功時強制啟用原生核准。

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

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

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

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

共用的 approvals.exec 轉送是分開的。只有在執行核准提示也必須路由到其他聊天或明確的頻外目標時才使用它。共用的 approvals.plugin 轉送也是分開的；當這些請求已落在 Slack 中時，Slack 原生按鈕仍可解析 Plugin 核准。

同一聊天中的 /approve 也可在已支援指令的 Slack 通道和 DM 中運作。如需完整核准轉送模型，請參閱執行核准。

# 事件與操作行為

• 訊息編輯/刪除會對應為系統事件。
• 執行緒廣播（「同時傳送到通道」執行緒回覆）會作為一般使用者訊息處理。
• 反應新增/移除事件會對應為系統事件。
• 成員加入/離開、通道建立/重新命名，以及釘選新增/移除事件會對應為系統事件。
• 啟用 configWrites 時，channel_id_changed 可以遷移通道設定鍵。
• 通道主題/用途中繼資料會被視為不受信任的脈絡，並可注入路由脈絡。
• 適用時，執行緒起始者和初始執行緒歷史脈絡植入會依設定的傳送者允許清單篩選。
• 區塊動作和互動視窗互動會發出結構化的 Slack interaction: ... 系統事件，並包含豐富的承載欄位：
  • 區塊動作：所選值、標籤、選擇器值，以及 workflow_* 中繼資料
  • 互動視窗 view_submission 和 view_closed 事件，包含已路由的通道中繼資料和表單輸入

# 設定參考

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

# 疑難排解

openclaw channels status --probe
openclaw logs --follow
openclaw doctor

openclaw pairing list slack

# 附件視覺參考

Slack 可在 Slack 檔案下載成功且大小限制允許時，將下載的媒體附加到代理程式回合。圖片檔案可以透過媒體理解路徑傳遞，或直接傳給具備視覺能力的回覆模型；其他檔案會保留為可下載的檔案脈絡，而不是當作圖片輸入處理。

# 支援的媒體類型

# 入站管線

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

1. OpenClaw 會使用機器人 Token（xoxb-...）從 Slack 的私人 URL 下載檔案。
2. 下載成功時，檔案會寫入媒體儲存區。
3. 下載的媒體路徑與內容類型會加入入站脈絡。
4. 支援圖片的模型/工具路徑可以使用該脈絡中的圖片附件。
5. 非圖片檔案會維持為檔案中繼資料或媒體參照，供能處理它們的工具使用。

# 對話串根訊息附件繼承

當訊息到達對話串中（具有 thread_ts 父層）時：

• 如果回覆本身沒有直接媒體，而包含的根訊息有檔案，Slack 可將根檔案水合為對話串起始脈絡。
• 直接回覆附件優先於根訊息附件。
• 只有檔案且沒有文字的根訊息會以附件預留位置表示，因此備援仍可包含其檔案。

# 多附件處理

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

• 每個附件都會透過媒體管線獨立處理。
• 下載的媒體參照會彙總到訊息脈絡中。
• 處理順序遵循事件承載中 Slack 的檔案順序。
• 某個附件下載失敗不會阻擋其他附件。

# 大小、下載與模型限制

• 大小上限：預設每個檔案 20 MB。可透過 channels.slack.mediaMaxMb 設定。
• 下載失敗：Slack 無法提供的檔案、過期 URL、無法存取的檔案、超大檔案，以及 Slack 驗證/登入 HTML 回應都會被略過，而不是回報為不支援的格式。
• 視覺模型：圖片分析會使用支援視覺的作用中回覆模型，或使用在 agents.defaults.imageModel 設定的圖片模型。

# 已知限制

# 相關文件

• 媒體理解管線
• PDF 工具
• Epic：#51349 — 啟用 Slack 附件視覺
• 迴歸測試：#51353
• 即時驗證：#51354

# 相關