Slack

​

选择 Socket Mode 或 HTTP Request URLs

​

安装

openclaw plugins install @openclaw/slack

​

快速设置

{
  "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
    },
    "assistant_view": {
      "assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.",
      "suggested_prompts": [
        { "title": "What can you do?", "message": "你能帮我做什么？" },
        {
          "title": "Summarize this channel",
          "message": "总结这个频道最近的活动。"
        },
        { "title": "Draft a reply", "message": "帮我起草一条回复。" }
      ]
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "发送消息给 OpenClaw",
        "should_escape": false
      }
    ]
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "assistant:write",
        "channels:history",
        "channels:read",
        "chat:write",
        "commands",
        "emoji:read",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "pins:read",
        "pins:write",
        "reactions:read",
        "reactions:write",
        "usergroups:read",
        "users:read"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "assistant_thread_context_changed",
        "assistant_thread_started",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    }
  }
}

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

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
    },
    "assistant_view": {
      "assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.",
      "suggested_prompts": [
        { "title": "What can you do?", "message": "你能帮我做什么？" },
        {
          "title": "Summarize this channel",
          "message": "总结这个频道最近的活动。"
        },
        { "title": "Draft a reply", "message": "帮我起草一条回复。" }
      ]
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "发送消息给 OpenClaw",
        "should_escape": false,
        "url": "https://gateway-host.example.com/slack/events"
      }
    ]
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "assistant:write",
        "channels:history",
        "channels:read",
        "chat:write",
        "commands",
        "emoji:read",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "pins:read",
        "pins:write",
        "reactions:read",
        "reactions:write",
        "usergroups:read",
        "users:read"
      ]
    }
  },
  "settings": {
    "event_subscriptions": {
      "request_url": "https://gateway-host.example.com/slack/events",
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "assistant_thread_context_changed",
        "assistant_thread_started",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    },
    "interactivity": {
      "is_enabled": true,
      "request_url": "https://gateway-host.example.com/slack/events",
      "message_menu_options_url": "https://gateway-host.example.com/slack/events"
    }
  }
}

export SLACK_BOT_TOKEN=slack-bot-token-example
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 传输调优

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

• 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 秒。连续的可恢复启动/启动等待失败会在 12 次尝试后停止；在成功连接后，后续可恢复断开会开启新的重试周期。不可恢复的 Slack 认证错误，例如 invalid_auth、已撤销的 token 或缺少作用域，会快速失败，而不是永远重试。

​

Manifest 和作用域清单

{
  "display_information": {
    "name": "OpenClaw",
    "description": "OpenClaw 的 Slack 连接器"
  },
  "features": {
    "bot_user": { "display_name": "OpenClaw", "always_online": true },
    "app_home": {
      "home_tab_enabled": true,
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "assistant_view": {
      "assistant_description": "OpenClaw 将 Slack assistant threads 连接到 OpenClaw 代理。",
      "suggested_prompts": [
        { "title": "What can you do?", "message": "What can you help me with?" },
        {
          "title": "Summarize this channel",
          "message": "Summarize the recent activity in this channel."
        },
        { "title": "Draft a reply", "message": "Help me draft a reply." }
      ]
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "向 OpenClaw 发送消息",
        "should_escape": false
      }
    ]
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "assistant:write",
        "channels:history",
        "channels:read",
        "chat:write",
        "commands",
        "emoji:read",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "pins:read",
        "pins:write",
        "reactions:read",
        "reactions:write",
        "usergroups:read",
        "users:read"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "assistant_thread_context_changed",
        "assistant_thread_started",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    }
  }
}

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

​

其他 manifest 设置

{
  "slash_commands": [
    {
      "command": "/new",
      "description": "开始一个新会话",
      "usage_hint": "[model]"
    },
    {
      "command": "/reset",
      "description": "重置当前会话"
    },
    {
      "command": "/compact",
      "description": "压缩会话上下文",
      "usage_hint": "[instructions]"
    },
    {
      "command": "/stop",
      "description": "停止当前运行"
    },
    {
      "command": "/session",
      "description": "管理线程绑定过期时间",
      "usage_hint": "idle <duration|off> or max-age <duration|off>"
    },
    {
      "command": "/think",
      "description": "设置思考级别",
      "usage_hint": "<level>"
    },
    {
      "command": "/verbose",
      "description": "切换详细输出",
      "usage_hint": "on|off|full"
    },
    {
      "command": "/fast",
      "description": "显示或设置快速模式",
      "usage_hint": "[status|on|off]"
    },
    {
      "command": "/reasoning",
      "description": "切换推理可见性",
      "usage_hint": "[on|off|stream]"
    },
    {
      "command": "/elevated",
      "description": "切换提升模式",
      "usage_hint": "[on|off|ask|full]"
    },
    {
      "command": "/exec",
      "description": "显示或设置 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": "按名称运行一个技能",
      "usage_hint": "<name> [input]"
    },
    {
      "command": "/btw",
      "description": "在不更改会话上下文的情况下提出一个旁支问题",
      "usage_hint": "<question>"
    },
    {
      "command": "/side",
      "description": "在不更改会话上下文的情况下提出一个旁支问题",
      "usage_hint": "<question>"
    },
    {
      "command": "/usage",
      "description": "控制使用情况页脚或显示费用摘要",
      "usage_hint": "off|tokens|full|cost"
    }
  ]
}

{
  "slash_commands": [
    {
      "command": "/new",
      "description": "开始一个新会话",
      "usage_hint": "[model]",
      "url": "https://gateway-host.example.com/slack/events"
    },
    {
      "command": "/help",
      "description": "显示简短帮助摘要",
      "url": "https://gateway-host.example.com/slack/events"
    }
  ]
}

​

Token 模型

• botToken + appToken 是 Socket Mode 所必需的。
• HTTP 模式需要 botToken + signingSecret。
• botToken, appToken, signingSecret, 和 userToken 接受明文字符串或 SecretRef 对象。
• 配置中的 token 会覆盖环境变量回退。
• SLACK_BOT_TOKEN / SLACK_APP_TOKEN 环境变量回退仅适用于默认账号。
• userToken 仅可在配置中设置（没有环境变量回退），并默认采用只读行为（userTokenReadOnly: true）。

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

​

操作与门控

​

访问控制与路由

{
  channels: {
    slack: {
      groupPolicy: "allowlist",
      channels: {
        C12345678: { allow: true, requireMention: true },
      },
    },
  },
}

{
  channels: {
    slack: {
      groupPolicy: "allowlist",
      channels: {
        "#eng-my-channel": { allow: true, requireMention: true },
      },
    },
  },
}

​

线程、会话和回复标签

• DMs 路由为 direct；channels 为 channel；MPIMs 为 group。
• Slack 路由绑定接受原始 peer IDs，以及 Slack 目标形式，例如 channel:C12345678、user:U12345678 和 <@U12345678>。
• 在默认 session.dmScope=main 下，Slack DMs 会折叠到 agent 主会话。
• 频道会话：agent:<agentId>:slack:channel:<channelId>。
• 普通顶层频道消息会保留在按频道划分的会话中，即使 replyToMode 不是 off 也是如此。
• Slack 线程回复会使用父 Slack thread_ts 作为会话后缀（:thread:<threadTs>），即使通过 replyToMode="off" 禁用了出站回复线程化也是如此。
• OpenClaw 会在一个符合条件的顶层频道 root 预期会开启一个可见的 Slack thread 时，将其种子化到 agent:<agentId>:slack:channel:<channelId>:thread:<rootTs>，这样 root 和后续线程回复就共享同一个 OpenClaw 会话。这适用于 app_mention 事件、显式 bot 或已配置的 mention-pattern 匹配，以及 requireMention: false 且 replyToMode 非 off 的频道。
• channels.slack.thread.historyScope 默认值为 thread；thread.inheritParent 默认值为 false。
• channels.slack.thread.initialHistoryLimit 控制新 thread session 启动时会拉取多少已有 thread messages（默认 20；设为 0 可禁用）。
• channels.slack.thread.requireExplicitMention（默认 false）：当为 true 时，会抑制隐式 thread mentions，使 bot 只响应 thread 内显式的 @bot mentions，即使 bot 已经参与过该 thread 也是如此。若不启用此项，已参与 bot thread 中的回复会绕过 requireMention 门控。

• channels.slack.replyToMode：off|first|all|batched（默认 off）
• channels.slack.replyToModeByChatType：按 direct|group|channel 分别设置
• direct chats 的旧版回退：channels.slack.dm.replyToMode

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

​

确认反应

​

Emoji (ackReaction)

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• agent identity emoji 回退（agents.list[].identity.emoji，否则 "eyes" / 👀）

• Slack 期望使用简写名（例如 "eyes"）。
• 可使用 "" 来禁用该 Slack 账号或全局的反应。

​

范围（messages.ackReactionScope）

• "all"：在 DMs 和群组中都添加反应。
• "direct"：仅在 DMs 中添加反应。
• "group-all"：对每条群组消息都添加反应（不包括 DMs）。
• "group-mentions"（默认）：在群组中添加反应，但仅在 bot 被提及（或在已选择启用的群组可提及对象中）时才触发。不包括 DMs。
• "off" / "none"：从不添加反应。

{
  messages: {
    ackReaction: "eyes",
    ackReactionScope: "all", // 在 DMs 和群组中添加反应
  },
}

​

文本流式传输

• off：禁用实时预览流式传输。
• partial（默认）：使用最新的部分输出替换预览文本。
• block：追加分块预览更新。
• progress：在生成期间显示进度状态文本，然后发送最终文本。
• streaming.preview.toolProgress：当草稿预览处于活动状态时，将工具/进度更新路由到同一条已编辑的预览消息中（默认：true）。设为 false 可保留单独的工具/进度消息。
• streaming.preview.commandText / streaming.progress.commandText：设为 status 可在隐藏原始 command/exec 文本的同时保留紧凑的工具进度行（默认：raw）。

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

• 原生文本流式传输和 Slack assistant 线程状态要显示，必须有可用的回复线程。线程选择仍遵循 replyToMode。
• 当原生流式传输不可用或不存在回复线程时，频道、群聊和顶层 DM 仍可使用常规草稿预览。
• 顶层 Slack DMs 默认保持非线程化，因此不会显示 Slack 的线程式原生流/状态预览；OpenClaw 会改为在 DM 中发布并编辑草稿预览。
• 媒体和非文本载荷会回退到正常投递。
• 媒体/错误最终结果会取消待处理的预览编辑；符合条件的文本/Block 最终结果仅在能够就地编辑预览时才会刷新。
• 如果流式传输在回复中途失败，OpenClaw 会对剩余载荷回退到正常投递。

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

{
  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.nativeStreaming 是 channels.slack.streaming.nativeTransport 的运行时别名。
• 运行 openclaw doctor --fix 可将持久化的 Slack 流式配置重写为规范键。

​

输入中 typing 反应回退

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

• Slack 期望使用简写名（例如 "hourglass_flowing_sand"）。
• 该反应尽力而为，回复或失败路径完成后会自动尝试清理。

​

媒体、分块与投递

​

命令与斜杠行为

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

/openclaw /help

• 对于 Slack，原生命令自动模式是 关闭 的，因此 commands.native: "auto" 不会启用 Slack 原生命令。

/help

• 最多 5 个选项：按钮块
• 6-100 个选项：静态选择菜单
• 超过 100 个选项：在可用交互选项处理器时，使用带异步选项过滤的外部选择器
• 超出 Slack 限制：编码后的选项值会回退为按钮

/think

​

交互式回复

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

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

• [[slack_buttons: Approve:approve, Reject:reject]]
• [[slack_select: Choose a target | Canary:canary, Production:production]]

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

• 这是 Slack 专用的旧版 UI。其他渠道不会将 Slack Block Kit 指令转换为它们自己的按钮系统。
• 交互回调值是 OpenClaw 生成的不可读令牌，而不是 agent 直接编写的原始值。
• 如果生成的交互块超过 Slack Block Kit 限制，OpenClaw 会回退为原始文本回复，而不是发送无效的 blocks 负载。

​

插件拥有的模态提交

• 将 callback_id 设为 openclaw:<namespace>:<payload>。
• 或保留现有的 callback_id，并在模态框的 private_metadata 中放入 pluginInteractiveData: "<namespace>:<payload>"。

​

Slack 中的原生审批

• Exec 和插件审批可以渲染为 Slack 原生的 Block Kit 提示。
• channels.slack.execApprovals.* 仍然是原生 exec 审批客户端的启用与 DM/频道路由配置。
• Exec 审批 DM 使用 channels.slack.execApprovals.approvers 或 commands.ownerAllowFrom。
• 当 Slack 被启用为源会话的原生审批客户端时，或者当 approvals.plugin 路由到源 Slack 会话或 Slack 目标时，插件审批会使用 Slack 原生按钮。
• 插件审批 DM 使用来自 channels.slack.allowFrom、命名账号 allowFrom 或账号默认路由的 Slack 插件审批者。
• 审批者授权仍然会被强制执行：仅限 exec 的审批者不能批准插件请求，除非他们同时也是插件审批者。

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

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

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

​

事件与运行行为

• 消息编辑/删除会映射为系统事件。
• 线程广播（“也发送到频道”的线程回复）会被当作普通用户消息处理。
• reaction 的添加/移除事件会映射为系统事件。
• 成员加入/离开、频道创建/重命名，以及 pin 的添加/移除事件会映射为系统事件。
• 启用 configWrites 时，channel_id_changed 可迁移频道配置键。
• 频道 topic/purpose 元数据会被视为不受信任的上下文，并可能被注入到路由上下文中。
• 线程起始消息和初始线程历史上下文种子在适用时会按配置的发送者白名单过滤。
• Block actions 和 modal 交互会发出结构化的 Slack interaction: ... 系统事件，并带有丰富的 payload 字段：
  • block actions：所选值、标签、选择器值，以及 workflow_* 元数据
  • modal view_submission 和 view_closed 事件，包含路由后的频道元数据和表单输入

​

配置参考

​

故障排查

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

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

openclaw pairing list slack

​

附件视觉参考

​

支持的媒体类型

​

入站管道

1. OpenClaw 使用 bot token 从 Slack 的私有 URL 下载文件。
2. 文件在成功后写入媒体存储。
3. 下载的媒体路径和内容类型会添加到入站上下文中。
4. 支持图像的模型/工具路径可以使用该上下文中的图像附件。
5. 非图像文件仍会作为文件元数据或媒体引用保留，供能够处理它们的工具使用。

​

线程根附件继承

• 如果回复本身没有直接媒体，而包含的根消息有文件，Slack 可以将根文件作为线程起始上下文注入。
• 直接回复附件优先于根消息附件。
• 只有文件而没有文本的根消息会表示为附件占位符，以便回退机制仍可包含其文件。

​

多附件处理

• 每个附件都会通过媒体管道独立处理。
• 下载后的媒体引用会聚合到消息上下文中。
• 处理顺序遵循事件负载中 Slack 文件的顺序。
• 某个附件下载失败不会阻止其他附件处理。

​

大小、下载与模型限制

• 大小上限：默认每个文件 20 MB。可通过 channels.slack.mediaMaxMb 配置。
• 下载失败：Slack 无法提供的文件、过期 URL、无法访问的文件、超大文件，以及 Slack auth/login HTML 响应都会被跳过，而不是报告为不支持的格式。
• 视觉模型：图像分析会使用当前激活的回复模型（如果它支持视觉），或者使用 agents.defaults.imageModel 中配置的图像模型。

​

已知限制

​

相关文档

• 媒体理解管道
• PDF 工具
• 里程碑：#51349 — Slack 附件视觉启用
• 回归测试：#51353
• 在线验证：#51354

​

相关内容