Slack

​

选择传输方式

​

中继模式

{
  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",
      },
    },
  },
}

​

Enterprise Grid 组织级安装

​

Socket 模式

{
  "display_information": {
    "name": "OpenClaw",
    "description": "OpenClaw 的 Slack 连接器"
  },
  "features": {
    "bot_user": { "display_name": "OpenClaw", "always_online": true },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "向 OpenClaw 发送消息",
        "should_escape": false
      }
    ]
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "channels:history",
        "channels:read",
        "chat:write",
        "commands",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "mpim:history",
        "mpim:read",
        "pins:read",
        "reactions:read",
        "reactions:write",
        "users:read"
      ]
    }
  },
  "settings": {
    "org_deploy_enabled": true,
    "socket_mode_enabled": true,
    "interactivity": { "is_enabled": true },
    "event_subscriptions": {
      "bot_events": [
        "app_mention",
        "channel_created",
        "channel_rename",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "member_joined_channel",
        "member_left_channel",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    }
  }
}

{
  channels: {
    slack: {
      enabled: true,
      mode: "socket",
      appToken: { source: "env", provider: "default", id: "SLACK_APP_TOKEN" },
      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },
      slashCommand: { enabled: true, name: "openclaw" },
      dmPolicy: "open",
      allowFrom: ["*"],
      groupPolicy: "allowlist",
      channels: {
        C0123456789: { requireMention: true },
      },
    },
  },
}

​

HTTP 请求 URL

{
  "display_information": {
    "name": "OpenClaw",
    "description": "OpenClaw 的 Slack 连接器"
  },
  "features": {
    "bot_user": { "display_name": "OpenClaw", "always_online": true },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "向 OpenClaw 发送消息",
        "should_escape": false,
        "url": "https://gateway-host.example.com/slack/events"
      }
    ]
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "channels:history",
        "channels:read",
        "chat:write",
        "commands",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "mpim:history",
        "mpim:read",
        "pins:read",
        "reactions:read",
        "reactions:write",
        "users:read"
      ]
    }
  },
  "settings": {
    "org_deploy_enabled": true,
    "interactivity": {
      "is_enabled": true,
      "request_url": "https://gateway-host.example.com/slack/events"
    },
    "event_subscriptions": {
      "request_url": "https://gateway-host.example.com/slack/events",
      "bot_events": [
        "app_mention",
        "channel_created",
        "channel_rename",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "member_joined_channel",
        "member_left_channel",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    }
  }
}

{
  channels: {
    slack: {
      enabled: true,
      mode: "http",
      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },
      signingSecret: {
        source: "env",
        provider: "default",
        id: "SLACK_SIGNING_SECRET",
      },
      slashCommand: { enabled: true, name: "openclaw" },
      webhookPath: "/slack/events",
      dmPolicy: "open",
      allowFrom: ["*"],
      groupPolicy: "allowlist",
      channels: {
        "team:T0123456789:channel:C0123456789": { requireMention: true },
      },
    },
  },
}

​

安装

openclaw plugins install @openclaw/slack

​

快速设置

{
  "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-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": "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-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

​

用户身份（以真实个人身份发布）

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 下，添加这些用户事件。不要只把它们添加到 bot-events 列表中：
   • message.channels
   • message.groups
   • message.im
   • message.mpim
3. 选择一种事件传输方式：
   • Socket Mode： 启用 Socket Mode，并创建一个带有 connections:write 的应用级 token。将其配置为 appToken。
   • HTTP Request URL： 将 Event Subscriptions 指向公开的 OpenClaw Slack 端点，并复制 Basic Information -> App Credentials -> Signing Secret。将其配置为 signingSecret。
4. 安装或重新安装该应用，将其授权给目标人类用户，并将生成的用户 OAuth token 复制到 userToken 中。

{
  channels: {
    slack: {
      postAs: "user",
      userToken: "<xoxp>",
      appToken: "<xapp>",
    },
  },
}

{
  channels: {
    slack: {
      postAs: "user",
      mode: "http",
      userToken: "<xoxp>",
      signingSecret: "<signing-secret>",
      webhookPath: "/slack/events",
    },
  },
}

​

Socket Mode 传输调优

• channels.slack.socketMode 对象（包括 clientPingTimeout、serverPingTimeout 和 pingPongLoggingEnabled）已弃用，运行时不再读取。openclaw doctor 会针对已弃用的布局调优配置项显示一般性提示，而不是显示逐项路径。openclaw doctor --fix 会移除这些字段在任何位置的配置，包括频道根目录和 accounts.<accountId> 下，并在 socketMode 对象为空后将其删除。你在其中添加的任何其他键都会保留，因此请手动删除。
• 应用消息和事件仍属于应用状态，而不是传输存活信号。
• Socket Mode 重启退避时间从约 2 秒开始，最大约为 30 秒。可恢复的启动、等待启动和断开连接失败会一直重试，直到频道停止。永久性的账户和凭据错误（例如身份验证无效、令牌被撤销或缺少权限范围）会快速失败，而不会无限重试。

​

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
    },
    "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"
      ]
    }
  }
}

{
  "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 设置

{
  "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> 或 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": "/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"
    }
  ]
}

​

Token 模型

• Bot 身份（默认）需要 botToken + appToken 用于 Socket Mode，或 botToken + signingSecret 用于 HTTP 模式。
• User 身份需要 userToken + appToken 用于 Socket Mode，或 userToken + signingSecret 用于 HTTP 模式。它不使用 bot token。
• Relay 模式需要 botToken 加上 relay.url、relay.authToken 和 relay.gatewayId；它不使用 app token 或 signing secret。
• botToken、appToken、signingSecret、relay.authToken 和 userToken 接受明文 字符串或 SecretRef 对象。
• 配置中的 token 会覆盖环境变量回退。
• 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 表示 bot 身份，使用 userTokenStatus + appTokenStatus 表示 user 身份。

​

操作与门控

​

访问控制与路由

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

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

​

群组 DM（MPDM）与 bot

• 如果在创建群组 DM 时就包含了该应用，Slack 会投递 message.mpim 事件，并且当 DM 策略允许时，OpenClaw 可以响应。
• 如果在一个现有群组 DM 中提及了该应用，但它并不是成员，那么 bot token 将完全无法看到该对话。Slack Web API 调用（如 conversations.info、conversations.members 和 conversations.history）会因方法和上下文不同而失败，报访问或未找到错误，该 MPDM 不会出现在 conversations.list?types=mpim 中，且不会有任何事件投递给 OpenClaw。
• OpenClaw 通过已投递的 message.mpim 事件唤醒。app_mention 事件不会把应用加入 DM 或 MPDM 上下文。
• dm.groupEnabled 和 dm.groupChannels 只会过滤 Slack 已经投递给应用的 MPDM。它们不能赋予应用对其从未参与过的群组 DM 的成员资格或可见性。没有任何 OpenClaw 配置项能让应用看到它从未加入过的群组 DM。

1. 将群组 DM 转换为私有频道，然后请现有成员使用 /invite @YourBot 邀请应用。基于 API 的邀请必须使用 conversations.invite，并且所用 token 的执行者必须已经是成员，且被允许邀请该应用。
2. 让应用使用具有 mpim:write 的 bot token，通过 conversations.open 打开一个新的 MPDM，并在 users 中传入人类收件人。Slack 会自动包含调用方 bot 用户。

​

线程、会话与回复标签

• DM 路由为 direct；频道为 channel；MPIM 为 group。
• Slack 路由绑定接受原始对端 ID，以及 Slack 目标形式，例如 channel:C12345678、user:U12345678 和 <@U12345678>。
• 在默认 session.dmScope=main 下，普通 Slack DM 会折叠到 agent 主会话。Agent View 根线程和现有的 Assistant View 线程仍然会隔离为 :thread:<threadTs> 会话。
• 频道会话：agent:<agentId>:slack:channel:<channelId>。
• 普通顶层频道消息会留在按频道划分的会话中，即使 replyToMode 不是 off 也是如此。
• Slack 频道、MPIM、Agent View 和 Assistant View 的线程回复会使用父级 Slack thread_ts 作为会话后缀（:thread:<threadTs>）。普通 DM 回复线程仍然只是基于 DM 主会话的 UI 表现。
• 当某个符合条件的顶层频道根消息预计会开启一个可见的 Slack 线程时，OpenClaw 会将其种子化到 agent:<agentId>:slack:channel:<channelId>:thread:<rootTs>，这样该根消息和后续线程回复就会共享一个 OpenClaw 会话。这适用于 app_mention 事件、显式 bot 触发或配置的 mention-pattern 匹配，以及 requireMention: false 且 replyToMode 非 off 的频道。
• 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>]]

​

确认反应

​

Emoji（ackReaction）

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• agent 身份 emoji 回退（agents.entries.*.identity.emoji，否则为 "eyes" / 👀）

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

​

范围（messages.ackReactionScope）

• "all"：在私聊和群组中添加反应，包括环境房间事件。
• "direct"：仅在私聊中添加反应。
• "group-all"：对所有群组消息添加反应，但不包括环境房间事件（不含私聊）。
• "group-mentions"（默认）：在群组中添加反应，但仅限于提及机器人时（或在已选择加入的群组可提及对象中）。不包括私聊。
• "off" / "none"：从不添加反应。

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

​

文本流式传输

• off：禁用实时预览流式传输
• partial：使用最新的部分输出替换预览文本。设置此值可恢复之前的默认行为
• block：追加分块的预览更新
• progress（默认）：在任务运行期间，在 thread 中维护一张实时 Block Kit 会话卡片，在原位置完成该卡片，并将助手的最终文本作为单独的消息发送
• 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"
        }
      }
    }
  }
}

• 必须存在回复 thread，原生文本流式传输和 Slack assistant thread 状态才能显示。thread 的选择仍遵循 replyToMode
• 当原生流式传输不可用或不存在回复 thread 时，频道、群聊和顶层 DM 根消息仍可使用普通草稿预览
• 顶层 Slack DM 默认不在线程中，因此不会显示 Slack 线程式的原生流/状态预览；OpenClaw 会改为在 DM 中发布并编辑草稿预览
• 自定义出站用户名/图标设置会保持可移植预览启用。OpenClaw 会让预览或会话卡片由应用撰写，并单独发送自定义的最终消息。Slack 不允许删除冒充其他身份发送的消息
• 媒体和非文本负载会回退到普通投递
• 媒体/错误最终消息会取消待处理的预览编辑；符合条件的文本/区块最终消息只有在可以原地编辑预览时才会刷新
• 如果流式传输在回复过程中途失败，OpenClaw 会对剩余负载回退到普通投递

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

{
  channels: {
    slack: {
      streaming: {
        mode: "progress",
        progress: {
          nativeTaskCards: true,
        },
      },
    },
  },
}

• 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 流式传输配置重写为规范键。

​

输入中 typing 反应回退

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

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

​

语音输入

• Slackbot 语音听写 存在于用户的私有 Slackbot 会话中。Slack 会将录音转换为 Slackbot 提示，但不会通过 Events API 向第三方 Slack 应用发出音频文件、听写事件、提示或输入源标记。OpenClaw Slack 插件无法启用或接收它。
• Slack 音频剪辑 是可存储的 Slack 文件，可以发布到 OpenClaw 的 DM、频道或线程中。OpenClaw 会使用 bot token 下载可访问的剪辑，规范化 Slack 剪辑的 MIME 元数据，并通过共享的 音频转录管道 发送它。推荐的应用清单包含所需的 files:read 范围。

​

媒体、分块与投递

​

命令与斜杠行为

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

/openclaw /help

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

/help

• 3-5 个简短选项：溢出（"..."）菜单
• 超过 100 个选项，且可用异步选项过滤：外部选择
• 1-2 个选项，或任何其编码值对于选择器来说过长的选项：按钮块
• 否则（6-100 个选项，或超过 100 个但没有异步过滤）：静态选择菜单，每个菜单最多分块显示 100 个选项

/think

​

原生图表

{
  "blocks": [
    {
      "type": "chart",
      "chartType": "bar",
      "title": "季度收入",
      "categories": ["Q1", "Q2"],
      "series": [{ "name": "收入", "values": [120, 145] }],
      "xLabel": "季度"
    }
  ]
}

• 标题和可选坐标轴标签：50 个字符
• 饼图：1-12 个正值分段
• 折线图/柱状图/面积图：1-12 个唯一命名的系列，以及 1-20 个共享类别
• 分段、类别和系列标签：20 个字符
• 每个系列都必须为每个类别包含一个有限值；非饼图数值 可以为负数

​

原生表格

{
  "blocks": [
    {
      "type": "table",
      "caption": "开放中的流水线",
      "headers": ["账户", "阶段", "ARR"],
      "rows": [
        ["Acme", "已赢单", 125000],
        ["Globex", "评审中", 82000]
      ],
      "rowHeaderColumnIndex": 0
    }
  ]
}

• 1-20 列
• 1-100 行数据，外加表头行
• 每一行的单元格数量必须相同
• 在一条消息中的所有表格单元格总字符数最多为 10,000

​

插件拥有的模态框提交

• 将 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",
      },
    },
  },
}

​

事件与运行行为

• 消息编辑/删除会映射为系统事件。
• 线程广播（“也发送到频道”线程回复）会作为普通用户消息处理。
• 反应添加/移除事件会映射为系统事件。
• 成员加入/离开、频道创建/重命名，以及置顶添加/移除事件会映射为系统事件。
• 可选的在线状态轮询可以将观察到的人工参与者从 离开 到 在线 的转换映射到该参与者最近活跃的符合条件的 Slack 会话中。默认关闭。
• 启用 configWrites 时，channel_id_changed 可以迁移频道配置键。
• 频道主题/用途元数据被视为不受信任的上下文，并且可以注入到路由上下文中。
• Agent View app_context 实体会按照 Slack 相关性顺序进行验证，并且只作为结构化的不受信任上下文暴露；省略的上下文会清除该轮内容，而不是复用过期实体。
• 线程发起者和初始线程历史上下文种子在适用时会根据配置的发送者允许列表进行过滤。
• 用于探测、作用域发现、会话分类和投递对账的专用 Web API 读取请求，每次请求尝试都有 30 秒截止时间。瞬态失败仍可能重试，因此完整操作可能耗时更长。共享的 Bolt 和具备 mutation 能力的客户端不使用这个默认截止时间，因为 Slack 可能会在迟到的响应到达 OpenClaw 之前就提交 mutation。
• 块操作、快捷方式和 modal 交互会发出结构化的 Slack interaction: ... 系统事件，并带有丰富的负载字段：
  • 块操作：所选值、标签、选择器值和 workflow_* 元数据
  • 全局快捷方式：回调和参与者元数据，路由到参与者的直接会话
  • 消息快捷方式：回调、参与者、频道、线程和所选消息上下文
  • modal view_submission 和 view_closed 事件，带有路由后的频道元数据和表单输入

​

在线状态事件

{
  channels: {
    slack: {
      presenceEvents: { mode: "auto" },
      channels: {
        C0123456789: { presenceEvents: { mode: "on" } },
        C0987654321: { presenceEvents: { mode: "off" } },
      },
    },
  },
}

• off（默认）：不启用在线状态计时器，也不调用 Slack API。
• auto：监控最近 24 小时内活跃的 DM、MPIM 和 Slack 线程，最多 8 位被观察到的人类参与者。不包括顶层频道会话。
• on：监控相同的会话，不设参与者上限，并包含顶层频道会话。可使用按频道覆盖来强制启用或抑制某个频道。

​

配置参考

​

故障排查

{
  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 配置。
• 音频转写上限：当下载的文件发送到转写提供方或 CLI 时，也会应用所选支持音频的 tools.media.models[] 条目的 maxBytes。
• 下载失败：Slack 无法提供的文件、过期的 URL、无法访问的文件、超大文件以及 Slack 认证/登录 HTML 响应都会被跳过，而不会被报告为不支持的格式。
• 视觉模型：如果当前回复模型支持视觉，则图像分析使用该模型；否则使用 agents.defaults.imageModel 中配置的图像模型。

​

已知限制

​

相关文档

• 媒体理解管道
• 音频与语音笔记
• PDF 工具

​

相关内容