Slack

Socket 模式（默认）

快速配置（新手向）

创建一个 Slack 应用并启用 Socket Mode。
创建 App Token（xapp-...）和 Bot Token（xoxb-...）。
为 OpenClaw 设置 Token 并启动 Gateway。

最小配置：

{
  channels: {
    slack: {
      enabled: true,
      appToken: "xapp-...",
      botToken: "xoxb-...",
    },
  },
}

配置步骤

在 https://api.slack.com/apps 创建一个 Slack 应用（From scratch）。
Socket Mode → 开启。然后进入 Basic Information → App-Level Tokens → Generate Token and Scopes，添加 connections:write 权限。复制 App Token（xapp-...）。
OAuth & Permissions → 添加 bot token scopes（使用下面的 manifest）。点击 Install to Workspace。复制 Bot User OAuth Token（xoxb-...）。
可选：OAuth & Permissions → 添加 User Token Scopes（参考下面的只读列表）。重新安装应用并复制 User OAuth Token（xoxp-...）。
Event Subscriptions → 启用事件并订阅：
- message.*（包括编辑/删除/线程广播）
- app_mention
- reaction_added、reaction_removed
- member_joined_channel、member_left_channel
- channel_rename
- pin_added、pin_removed
邀请机器人加入你希望它读取的频道。
Slash Commands → 如果使用 channels.slack.slashCommand，创建 /openclaw 命令。如果启用原生命令，为每个内置命令添加一个斜杠命令（名称与 /help 中的一致）。Slack 的原生命令默认关闭，除非设置 channels.slack.commands.native: true（全局 commands.native 是 "auto"，Slack 默认关闭）。
App Home → 启用 Messages Tab，让用户可以私信机器人。

使用下面的 manifest 来保持权限和事件同步。

多账号支持：使用 channels.slack.accounts，为每个账号配置 Token 和可选的 name。参考 gateway/configuration 了解通用模式。

OpenClaw 配置（最小）

通过环境变量设置 Token（推荐）：

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

或通过配置文件：

{
  channels: {
    slack: {
      enabled: true,
      appToken: "xapp-...",
      botToken: "xoxb-...",
    },
  },
}

User Token（可选）

OpenClaw 可以使用 Slack user token（xoxp-...）进行读取操作（历史记录、置顶、表情回应、emoji、成员信息）。默认情况下这是只读的：读取操作优先使用 user token（如果配置了），写入操作仍使用 bot token，除非你明确选择启用。即使设置了 userTokenReadOnly: false，当 bot token 可用时，写入操作仍优先使用 bot token。

User token 在配置文件中配置（不支持环境变量）。对于多账号，设置 channels.slack.accounts.<id>.userToken。

同时配置 bot + app + user token 的示例：

{
  channels: {
    slack: {
      enabled: true,
      appToken: "xapp-...",
      botToken: "xoxb-...",
      userToken: "xoxp-...",
    },
  },
}

明确设置 userTokenReadOnly（允许 user token 写入）的示例：

{
  channels: {
    slack: {
      enabled: true,
      appToken: "xapp-...",
      botToken: "xoxb-...",
      userToken: "xoxp-...",
      userTokenReadOnly: false,
    },
  },
}

Token 使用规则

读取操作（历史记录、表情回应列表、置顶列表、emoji 列表、成员信息、搜索）优先使用 user token（如果配置了），否则使用 bot token。
写入操作（发送/编辑/删除消息、添加/移除表情回应、置顶/取消置顶、文件上传）默认使用 bot token。如果设置了 userTokenReadOnly: false 且没有 bot token，OpenClaw 会回退到 user token。

历史上下文

channels.slack.historyLimit（或 channels.slack.accounts.*.historyLimit）控制将多少条最近的频道/群组消息包装到 Prompt 中。
回退到 messages.groupChat.historyLimit。设置 0 禁用（默认 50）。

HTTP 模式（Events API）

当你的 Gateway 可以通过 HTTPS 被 Slack 访问时（服务器部署的典型场景），使用 HTTP Webhook 模式。HTTP 模式使用 Events API + Interactivity + Slash Commands，共享一个请求 URL。

配置步骤

创建一个 Slack 应用并 禁用 Socket Mode（如果只使用 HTTP，这是可选的）。
Basic Information → 复制 Signing Secret。
OAuth & Permissions → 安装应用并复制 Bot User OAuth Token（xoxb-...）。
Event Subscriptions → 启用事件并设置 Request URL 为你的 Gateway Webhook 路径（默认 /slack/events）。
Interactivity & Shortcuts → 启用并设置相同的 Request URL。
Slash Commands → 为你的命令设置相同的 Request URL。

请求 URL 示例： https://gateway-host/slack/events

OpenClaw 配置（最小）

{
  channels: {
    slack: {
      enabled: true,
      mode: "http",
      botToken: "xoxb-...",
      signingSecret: "your-signing-secret",
      webhookPath: "/slack/events",
    },
  },
}

多账号 HTTP 模式：设置 channels.slack.accounts.<id>.mode = "http" 并为每个账号提供唯一的 webhookPath，这样每个 Slack 应用可以指向自己的 URL。

Manifest（可选）

使用这个 Slack 应用 manifest 快速创建应用（如果需要可以调整名称/命令）。如果你计划配置 user token，包含 user scopes。

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Slack connector for OpenClaw"
  },
  "features": {
    "bot_user": {
      "display_name": "OpenClaw",
      "always_online": false
    },
    "app_home": {
      "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": [
        "chat:write",
        "channels:history",
        "channels:read",
        "groups:history",
        "groups:read",
        "groups:write",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "users:read",
        "app_mentions:read",
        "reactions:read",
        "reactions:write",
        "pins:read",
        "pins:write",
        "emoji:read",
        "commands",
        "files:read",
        "files:write"
      ],
      "user": [
        "channels:history",
        "channels:read",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "mpim:history",
        "mpim:read",
        "users:read",
        "reactions:read",
        "pins:read",
        "emoji:read",
        "search:read"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_mention",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "reaction_added",
        "reaction_removed",
        "member_joined_channel",
        "member_left_channel",
        "channel_rename",
        "pin_added",
        "pin_removed"
      ]
    }
  }
}

如果启用原生命令，为每个你想暴露的命令添加一个 slash_commands 条目（与 /help 列表匹配）。使用 channels.slack.commands.native 覆盖。

Scopes（当前 vs 可选）

Slack 的 Conversations API 是按类型划分权限的：你只需要为实际使用的对话类型（channels、groups、im、mpim）添加权限。参考 https://docs.slack.dev/apis/web-api/using-the-conversations-api/ 了解概览。

Bot Token Scopes（必需）

chat:write（通过 chat.postMessage 发送/更新/删除消息） https://docs.slack.dev/reference/methods/chat.postMessage
im:write（通过 conversations.open 打开用户 DM） https://docs.slack.dev/reference/methods/conversations.open
channels:history、groups:history、im:history、mpim:history https://docs.slack.dev/reference/methods/conversations.history
channels:read、groups:read、im:read、mpim:read https://docs.slack.dev/reference/methods/conversations.info
users:read（用户查询） https://docs.slack.dev/reference/methods/users.info
reactions:read、reactions:write（reactions.get / reactions.add） https://docs.slack.dev/reference/methods/reactions.get https://docs.slack.dev/reference/methods/reactions.add
pins:read、pins:write（pins.list / pins.add / pins.remove） https://docs.slack.dev/reference/scopes/pins.read https://docs.slack.dev/reference/scopes/pins.write
emoji:read（emoji.list） https://docs.slack.dev/reference/scopes/emoji.read
files:write（通过 files.uploadV2 上传） https://docs.slack.dev/messaging/working-with-files/#upload

User Token Scopes（可选，默认只读）

如果配置 channels.slack.userToken，在 User Token Scopes 下添加这些权限。

channels:history、groups:history、im:history、mpim:history
channels:read、groups:read、im:read、mpim:read
users:read
reactions:read
pins:read
emoji:read
search:read

暂时不需要（但未来可能需要）

mpim:write（仅当我们添加通过 conversations.open 打开群组 DM/启动 DM 时）
groups:write（仅当我们添加私有频道管理：创建/重命名/邀请/归档时）
chat:write.public（仅当我们想发送消息到机器人不在的频道时） https://docs.slack.dev/reference/scopes/chat.write.public
users:read.email（仅当我们需要从 users.info 获取邮箱字段时） https://docs.slack.dev/changelog/2017-04-narrowing-email-access
files:read（仅当我们开始列出/读取文件元数据时）

配置

Slack 仅使用 Socket Mode（无 HTTP Webhook 服务器）。提供两个 Token：

{
  "slack": {
    "enabled": true,
    "botToken": "xoxb-...",
    "appToken": "xapp-...",
    "groupPolicy": "allowlist",
    "dm": {
      "enabled": true,
      "policy": "pairing",
      "allowFrom": ["U123", "U456", "*"],
      "groupEnabled": false,
      "groupChannels": ["G123"],
      "replyToMode": "all"
    },
    "channels": {
      "C123": { "allow": true, "requireMention": true },
      "#general": {
        "allow": true,
        "requireMention": true,
        "users": ["U123"],
        "skills": ["search", "docs"],
        "systemPrompt": "Keep answers short."
      }
    },
    "reactionNotifications": "own",
    "reactionAllowlist": ["U123"],
    "replyToMode": "off",
    "actions": {
      "reactions": true,
      "messages": true,
      "pins": true,
      "memberInfo": true,
      "emojiList": true
    },
    "slashCommand": {
      "enabled": true,
      "name": "openclaw",
      "sessionPrefix": "slack:slash",
      "ephemeral": true
    },
    "textChunkLimit": 4000,
    "mediaMaxMb": 20
  }
}

Token 也可以通过环境变量提供：

SLACK_BOT_TOKEN
SLACK_APP_TOKEN

确认表情回应通过 messages.ackReaction + messages.ackReactionScope 全局控制。使用 messages.removeAckAfterReply 在机器人回复后清除确认表情回应。

限制

出站文本会按 channels.slack.textChunkLimit（默认 4000）分块。
可选的换行分块：设置 channels.slack.chunkMode="newline" 在长度分块之前按空行（段落边界）分割。
媒体上传受 channels.slack.mediaMaxMb（默认 20）限制。

回复线程

默认情况下，OpenClaw 在主频道中回复。使用 channels.slack.replyToMode 控制自动线程：

模式	行为
`off`	默认。在主频道回复。仅当触发消息已经在线程中时才使用线程。
`first`	第一条回复进入线程（在触发消息下），后续回复进入主频道。适合保持上下文可见同时避免线程混乱。
`all`	所有回复都进入线程。保持对话集中但可能降低可见性。

该模式适用于自动回复和 Agent 工具调用（slack sendMessage）。

按聊天类型设置线程

你可以通过设置 channels.slack.replyToModeByChatType 为每种聊天类型配置不同的线程行为：

{
  channels: {
    slack: {
      replyToMode: "off", // 频道的默认值
      replyToModeByChatType: {
        direct: "all", // DM 总是使用线程
        group: "first", // 群组 DM/MPIM 第一条回复使用线程
      },
    },
  },
}

支持的聊天类型：

direct：1 对 1 DM（Slack im）
group：群组 DM / MPIM（Slack mpim）
channel：标准频道（公开/私有）

优先级：

replyToModeByChatType.<chatType>
replyToMode
Provider 默认值（off）

旧版 channels.slack.dm.replyToMode 仍被接受，当没有设置聊天类型覆盖时作为 direct 的回退。

示例：

仅对 DM 使用线程：

{
  channels: {
    slack: {
      replyToMode: "off",
      replyToModeByChatType: { direct: "all" },
    },
  },
}

对群组 DM 使用线程但频道保持在根级别：

{
  channels: {
    slack: {
      replyToMode: "off",
      replyToModeByChatType: { group: "first" },
    },
  },
}

让频道使用线程，DM 保持在根级别：

{
  channels: {
    slack: {
      replyToMode: "first",
      replyToModeByChatType: { direct: "off", group: "off" },
    },
  },
}

手动线程标签

对于细粒度控制，在 Agent 响应中使用这些标签：

[[reply_to_current]] — 回复触发消息（开始/继续线程）。
[[reply_to:<id>]] — 回复特定消息 ID。

Session + Routing

DM 共享 main Session（类似 WhatsApp/Telegram）。
频道映射到 agent:<agentId>:slack:channel:<channelId> Session。
斜杠命令使用 agent:<agentId>:slack:slash:<userId> Session（前缀可通过 channels.slack.slashCommand.sessionPrefix 配置）。
如果 Slack 不提供 channel_type，OpenClaw 从 Channel ID 前缀（D、C、G）推断，默认为 channel 以保持 Session 键稳定。
原生命令注册使用 commands.native（全局默认 "auto" → Slack 关闭），可以通过 channels.slack.commands.native 按工作空间覆盖。文本命令需要独立的 /... 消息，可以通过 commands.text: false 禁用。Slack 斜杠命令在 Slack 应用中管理，不会自动删除。使用 commands.useAccessGroups: false 绕过命令的访问组检查。
完整命令列表 + 配置：斜杠命令

DM 安全（Pairing）

默认：channels.slack.dm.policy="pairing" — 未知的 DM 发送者会收到 Pairing 码（1 小时后过期）。
通过以下方式批准：openclaw pairing approve slack <code>。
允许任何人：设置 channels.slack.dm.policy="open" 和 channels.slack.dm.allowFrom=["*"]。
channels.slack.dm.allowFrom 接受用户 ID、@handles 或邮箱（在启动时解析，当 Token 允许时）。向导接受用户名并在设置期间解析为 ID（当 Token 允许时）。

群组策略

channels.slack.groupPolicy 控制频道处理（open|disabled|allowlist）。
allowlist 要求频道列在 channels.slack.channels 中。
如果你只设置了 SLACK_BOT_TOKEN/SLACK_APP_TOKEN 且从未创建 channels.slack 部分，运行时会将 groupPolicy 默认为 open。添加 channels.slack.groupPolicy、channels.defaults.groupPolicy 或频道白名单来锁定它。
配置向导接受 #channel 名称并在可能时解析为 ID（公开 + 私有）；如果存在多个匹配，它优先选择活跃频道。
启动时，OpenClaw 将白名单中的频道/用户名解析为 ID（当 Token 允许时）并记录映射；未解析的条目保持原样。
要 不允许任何频道，设置 channels.slack.groupPolicy: "disabled"（或保持空白名单）。

频道选项（channels.slack.channels.<id> 或 channels.slack.channels.<name>）：

allow：当 groupPolicy="allowlist" 时允许/拒绝频道。
requireMention：频道的提及门控。
tools：可选的按频道工具策略覆盖（allow/deny/alsoAllow）。
toolsBySender：可选的频道内按发送者工具策略覆盖（键是发送者 ID/@handles/邮箱；支持 "*" 通配符）。
allowBots：允许此频道中机器人创作的消息（默认：false）。
users：可选的按频道用户白名单。
skills：Skill 过滤器（省略 = 所有 Skill，空 = 无）。
systemPrompt：频道的额外系统 Prompt（与主题/目的结合）。
enabled：设置 false 禁用频道。

投递目标

与 cron/CLI 发送一起使用：

user:<id> 用于 DM
channel:<id> 用于频道

工具操作

Slack 工具操作可以通过 channels.slack.actions.* 门控：

操作组	默认	说明
reactions	启用	表情回应 + 列出表情回应
messages	启用	读取/发送/编辑/删除
pins	启用	置顶/取消置顶/列出
memberInfo	启用	成员信息
emojiList	启用	自定义 emoji 列表

安全说明

写入操作默认使用 bot token，因此状态更改操作保持在应用的机器人权限和身份范围内。
设置 userTokenReadOnly: false 允许在没有 bot token 时使用 user token 进行写入操作，这意味着操作以安装用户的访问权限运行。将 user token 视为高度特权，保持操作门控和白名单严格。
如果启用 user token 写入，确保 user token 包含你期望的写入权限（chat:write、reactions:write、pins:write、files:write），否则这些操作会失败。

注意事项

提及门控通过 channels.slack.channels 控制（设置 requireMention 为 true）；agents.list[].groupChat.mentionPatterns（或 messages.groupChat.mentionPatterns）也算作提及。
多 Agent 覆盖：在 agents.list[].groupChat.mentionPatterns 上设置按 Agent 的模式。
表情回应通知遵循 channels.slack.reactionNotifications（使用 reactionAllowlist 配合 allowlist 模式）。
机器人创作的消息默认被忽略；通过 channels.slack.allowBots 或 channels.slack.channels.<id>.allowBots 启用。
警告：如果允许回复其他机器人（channels.slack.allowBots=true 或 channels.slack.channels.<id>.allowBots=true），使用 requireMention、channels.slack.channels.<id>.users 白名单和/或在 AGENTS.md 和 SOUL.md 中设置清晰的防护措施来防止机器人之间的回复循环。
对于 Slack 工具，表情回应移除语义在 /tools/reactions 中。
附件在允许且低于大小限制时会下载到媒体存储。