Slack

可用于 Slack 应用集成下的私信和频道，已达到生产就绪状态。默认模式是 Socket Mode；也支持 HTTP Request URLs。

选择 Socket Mode 或 HTTP Request URLs

两种传输方式都已达到生产就绪状态，并且在消息传递、斜杠命令、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" },},},}JSON5openclaw config patch --file ./slack.socket.patch.json5 --dry-runopenclaw 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",},},}JSON5openclaw config patch --file ./slack.http.patch.json5 --dry-runopenclaw config patch --file ./slack.http.patch.json5

openclaw gateway

Socket Mode 传输调优

OpenClaw 默认将 Socket Mode 的 Slack SDK 客户端 pong 超时设置为 15 秒。只有在需要针对工作区或主机进行特定调优时，才覆盖传输设置：

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

仅当 Socket Mode 工作区记录 Slack websocket pong/server-ping 超时，或运行在已知存在事件循环饥饿的主机上时，才使用此配置。clientPingTimeout 是 SDK 发送客户端 ping 后等待 pong 的时间；serverPingTimeout 是等待 Slack 服务器 ping 的时间。应用消息和事件仍然是应用状态，而不是传输活跃性信号。

清单和权限范围检查清单

基础 Slack 应用清单在 Socket Mode 和 HTTP Request URLs 中相同。只有 settings 块（以及斜杠命令的 url）不同。

基础清单（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 变体，并为每个斜杠命令添加 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"    }  }}

其他清单设置

公开不同的功能，用于扩展上述默认值。

默认清单会启用 Slack App Home 的 Home 标签页，并订阅 app_home_opened。当工作区成员打开 Home 标签页时，OpenClaw 会使用 views.publish 发布一个安全的默认 Home 视图；不包含会话 payload 或私有配置。Messages 标签页仍为 Slack 私信启用。

{"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 对象。
• 配置令牌会覆盖环境回退。
• SLACK_BOT_TOKEN / SLACK_APP_TOKEN 环境变量回退仅适用于默认账户。
• userToken (xoxp-...) 仅能通过配置提供（没有环境变量回退），并默认采用只读行为（userTokenReadOnly: true）。

Status 快照行为：

• Slack 账户检查会跟踪每个凭据的 *Source 和 *Status 字段（botToken、appToken、signingSecret、userToken）。
• Status 为 available、configured_unavailable 或 missing。
• configured_unavailable 表示账户通过 SecretRef 或其他非内联密钥来源进行了配置，但当前命令/运行时路径 无法解析实际值。
• 在 HTTP 模式中，会包含 signingSecretStatus；在 Socket Mode 中， 必需的配对是 botTokenStatus + appTokenStatus。

操作和门控

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

当前 Slack 工具中可用的操作组：

当前 Slack 消息操作包括 send、upload-file、download-file、read、edit、delete、pin、unpin、list-pins、member-info 和 emoji-list。download-file 接受入站文件占位符中显示的 Slack 文件 ID，并为图片返回图片预览，或为其他文件类型返回本地文件元数据。

访问控制和路由

线程、会话和回复标签

• 私信路由为 direct；频道路由为 channel；MPIM 路由为 group。
• Slack 路由绑定接受原始对等 ID，以及 Slack 目标形式，例如 channel:C12345678、user:U12345678 和 <@U12345678>。
• 使用默认 session.dmScope=main 时，Slack 私信会折叠到智能体主会话。
• 频道会话：agent:<agentId>:slack:channel:<channelId>。
• 适用时，线程回复可以创建线程会话后缀（:thread:<threadTs>）。
• 在 OpenClaw 无需显式提及即可处理顶层消息的频道中，非 off 的 replyToMode 会将每个已处理根消息路由到 agent:<agentId>:slack:channel:<channelId>:thread:<rootTs>，使可见的 Slack 线程从第一轮开始映射到一个 OpenClaw 会话。
• 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>]]

对于来自 message 工具的显式 Slack 线程回复，请将 replyBroadcast: true 与 action: "send" 以及 threadId 或 replyTo 一起设置，以请求 Slack 同时将线程回复广播到父频道。这会映射到 Slack 的 chat.postMessage reply_broadcast 标志，并且仅支持文本或 Block Kit 发送，不支持媒体上传。

当 message 工具调用在 Slack 线程内运行并以同一频道为目标时，OpenClaw 通常会根据 replyToMode 继承当前 Slack 线程。在 action: "send" 或 action: "upload-file" 上设置 topLevel: true 可强制发送新的父频道消息。threadId: null 也会被接受为相同的顶层退出方式。

确认响应

ackReaction 会在 OpenClaw 处理入站消息时发送一个确认表情符号。

解析顺序：

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• 智能体身份表情符号回退（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 可在隐藏原始命令/执行文本的同时保留紧凑的工具进度行（默认：raw）。

隐藏原始命令/执行文本，同时保留紧凑的进度行：

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

channels.slack.streaming.nativeTransport 在 channels.slack.streaming.mode 为 partial 时控制 Slack 原生文本流式传输（默认：true）。

• 必须有回复线程，才能显示原生文本流式传输和 Slack 助手线程状态。线程选择仍遵循 replyToMode。
• 当原生流式传输不可用或不存在回复线程时，渠道、群聊和顶层私信根仍可使用普通草稿预览。
• 顶层 Slack 私信默认保持非线程模式，因此不会显示 Slack 的线程式原生流/状态预览；OpenClaw 会改为在私信中发布并编辑草稿预览。
• 媒体和非文本载荷会回退到普通投递。
• 媒体/错误最终消息会取消待处理的预览编辑；符合条件的文本/分块最终消息只有在可以原地编辑预览时才会刷新。
• 如果流式传输在回复过程中失败，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 消息添加一个临时表情回应，并在运行结束时移除它。这在线程回复之外最有用，因为线程回复会使用默认的 “is typing...” 状态指示器。

解析顺序：

• 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 会回退到原始文本回复，而不是发送无效的 blocks 载荷。

Slack 中的 Exec 审批

Slack 可以充当带有交互按钮和交互事件的原生审批客户端，而不是回退到 Web UI 或终端。

• Exec 审批使用 channels.slack.execApprovals.* 进行原生私信/频道路由。
• 当请求已经落在 Slack 中且审批 ID 类型是 plugin: 时，插件审批仍可通过同一个 Slack 原生按钮界面完成。
• 仍会强制执行审批人授权：只有被识别为审批人的用户才能通过 Slack 批准或拒绝请求。

这使用与其他渠道相同的共享审批按钮界面。在你的 Slack 应用设置中启用 interactivity 后，审批提示会直接在对话中渲染为 Block Kit 按钮。 当这些按钮存在时，它们就是主要审批体验；只有在工具结果表明聊天审批不可用，或手动审批是唯一路径时，OpenClaw 才应包含手动 /approve 命令。

配置路径：

• channels.slack.execApprovals.enabled
• channels.slack.execApprovals.approvers（可选；可行时回退到 commands.ownerAllowFrom）
• channels.slack.execApprovals.target（dm | channel | both，默认：dm）
• agentFilter、sessionFilter

当 enabled 未设置或为 "auto" 且至少解析出一个审批人时，Slack 会自动启用原生 exec 审批。设置 enabled: false 可明确禁用 Slack 作为原生审批客户端。 当审批人可解析时，设置 enabled: true 可强制启用原生审批。

没有显式 Slack exec 审批配置时的默认行为：

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

只有在你想覆盖审批人、添加筛选器，或选择启用来源聊天投递时，才需要显式 Slack 原生配置：

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

共享 approvals.exec 转发是独立的。仅当 exec 审批提示还必须路由到其他聊天或显式带外目标时才使用它。共享 approvals.plugin 转发也是独立的；当这些请求已经落在 Slack 中时，Slack 原生按钮仍可完成插件审批。

同聊天 /approve 也可在已经支持命令的 Slack 频道和私信中使用。参见 Exec 审批，了解完整审批转发模型。

事件和运行行为

• 消息编辑/删除会映射为系统事件。
• 线程广播（“同时发送到频道”的线程回复）会按普通用户消息处理。
• 表情反应添加/移除事件会映射为系统事件。
• 成员加入/离开、频道创建/重命名，以及置顶添加/移除事件会映射为系统事件。
• 启用 configWrites 时，channel_id_changed 可以迁移频道配置键。
• 频道主题/用途元数据会被视为不可信上下文，并可注入到路由上下文中。
• 适用时，线程发起者和初始线程历史上下文种子会按配置的发送者允许列表过滤。
• 块操作和模态交互会发出结构化的 Slack interaction: ... 系统事件，并包含丰富的载荷字段：
  • 块操作：选中值、标签、选择器值，以及 workflow_* 元数据
  • 模态 view_submission 和 view_closed 事件，包含已路由的频道元数据和表单输入

配置参考

主要参考：配置参考 - Slack。

故障排除

openclaw channels status --probeopenclaw logs --followopenclaw doctor

openclaw pairing list slack

附件视觉参考

当 Slack 文件下载成功且大小限制允许时，Slack 可以将下载的媒体附加到智能体轮次。图像文件可以通过媒体理解路径传递，或直接传递给支持视觉的回复模型；其他文件会作为可下载文件上下文保留，而不是被视为图像输入。

支持的媒体类型

入站流水线

当带有文件附件的 Slack 消息到达时：

1. OpenClaw 使用机器人令牌（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

相关