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" },
},
},
}
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 传输调优

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

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

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

# 清单和 scope 检查清单

基础 Slack 应用清单对于 Socket Mode 和 HTTP Request URLs 是相同的。只有 settings 块（以及 slash command 的 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 变体，并为每个 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"
    }
  }
}

# 其他清单设置

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

默认清单会启用 Slack App Home 的 Home 标签页，并订阅 app_home_opened。当工作区成员打开 Home 标签页时，OpenClaw 会使用 views.publish 发布安全的默认 Home 视图；不会包含 conversation 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，以及 channel:C12345678、user:U12345678 和 <@U12345678> 等 Slack 目标形式。
• 使用默认 session.dmScope=main 时，Slack 私信会折叠到智能体主会话。
• 渠道会话：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 处理入站消息时发送确认表情。

解析顺序：

• 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.mode 为 partial 时，channels.slack.streaming.nativeTransport 控制 Slack 原生文本流式传输（默认：true）。

• 要显示原生文本流式传输和 Slack assistant 线程状态，必须有可用的回复线程。线程选择仍遵循 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 会回退到原始文本回复，而不是发送无效的区块载荷。

# Slack 中的 Exec 审批

Slack 可以作为带交互式按钮和交互的原生审批客户端，而不是回退到 Web UI 或终端。

• Exec 审批使用 channels.slack.execApprovals.* 进行原生私信/渠道路由。
• 当请求已进入 Slack 且审批 ID 类型为 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 会自动启用原生 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 审批，了解完整审批转发模型。

# 事件和运维行为

• 消息编辑/删除会映射为系统事件。
• 线程广播（“Also send to channel” 线程回复）会作为普通用户消息处理。
• 反应添加/移除事件会映射为系统事件。
• 成员加入/离开、渠道创建/重命名，以及固定添加/移除事件会映射为系统事件。
• 启用 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 使用机器人令牌（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 工具
• 史诗：#51349 — Slack 附件视觉启用
• 回归测试：#51353
• 实时验证：#51354

# 相关