Slack

套接字模式（默认）

快速设置（初学者）

创建 Slack 应用并启用套接字模式。
创建应用令牌（xapp-...）和机器人令牌（xoxb-...）。
为 openclaw 设置令牌并启动网关。

最小配置：

json5

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

设置

在 https://api.slack.com/apps 创建 Slack 应用（从头开始）。
套接字模式 → 切换开启。然后转到基本信息 → 应用级令牌 → 生成令牌和范围，范围选择 connections:write。复制应用令牌（xapp-...）。
OAuth 和权限 → 添加机器人令牌范围（使用下面的清单）。点击安装到工作区。复制机器人用户 OAuth 令牌（xoxb-...）。
可选：OAuth 和权限 → 添加用户令牌范围（参见下面的只读列表）。重新安装应用并复制用户 OAuth 令牌（xoxp-...）。
事件订阅 → 启用事件并订阅：
- message.*（包括编辑/删除/线程广播）
- app_mention
- reaction_added、reaction_removed
- member_joined_channel、member_left_channel
- channel_rename
- pin_added、pin_removed
邀请机器人到您希望它读取的频道。
斜杠命令 → 如果您使用 channels.slack.slashCommand，创建 /clawd。如果启用原生命令，为每个内置命令添加一个斜杠命令（与 /help 中的名称相同）。Slack 的原生命令默认关闭，除非您设置 channels.slack.commands.native: true（全局 commands.native 是 "auto"，这会使 Slack 保持关闭）。
应用主页 → 启用消息选项卡，以便用户可以私信机器人。

使用下面的清单以保持范围和事件同步。

多账户支持：使用 channels.slack.accounts 进行每个账户的令牌配置和可选的 name。有关共享模式，请参阅 gateway/configuration。

openclaw 配置（最小）

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

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

或通过配置：

json5

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

用户令牌（可选）

openclaw 可以使用 Slack 用户令牌（xoxp-...）进行读取操作（历史记录、置顶、反应、表情符号、成员信息）。默认情况下，这保持只读：读取操作在存在时优先使用用户令牌，而写入操作仍使用机器人令牌，除非您明确选择加入。即使设置了 userTokenReadOnly: false，当机器人令牌可用时，写入操作仍优先使用机器人令牌。

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

包含机器人 + 应用 + 用户令牌的示例：

json5

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

明确设置 userTokenReadOnly 的示例（允许用户令牌写入）：

json5

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

令牌使用

读取操作（历史记录、反应列表、置顶列表、表情符号列表、成员信息、搜索）在配置时优先使用用户令牌，否则使用机器人令牌。
写入操作（发送/编辑/删除消息、添加/移除反应、置顶/取消置顶、文件上传）默认使用机器人令牌。如果 userTokenReadOnly: false 且没有机器人令牌可用，openclaw 会回退到用户令牌。

历史上下文

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

HTTP 模式（事件 API）

当您的网关可以通过 HTTPS 被 Slack 访问时（典型的服务器部署），使用 HTTP webhook 模式。 HTTP 模式使用事件 API + 交互性 + 斜杠命令，共享一个请求 URL。

设置

创建 Slack 应用并禁用套接字模式（如果仅使用 HTTP，可选）。
基本信息 → 复制签名密钥。
OAuth 和权限 → 安装应用并复制机器人用户 OAuth 令牌（xoxb-...）。
事件订阅 → 启用事件并设置请求 URL 为您的网关 webhook 路径（默认 /slack/events）。
交互性和快捷方式 → 启用并设置相同的请求 URL。
斜杠命令 → 为您的命令设置相同的请求 URL。

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

openclaw 配置（最小）

json5

{
  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。

清单（可选）

使用此 Slack 应用清单快速创建应用（如果需要，调整名称/命令）。如果您计划配置用户令牌，请包含用户范围。

json

{
  "display_information": {
    "name": "openclaw",
    "description": "openclaw 的 Slack 连接器"
  },
  "features": {
    "bot_user": {
      "display_name": "openclaw",
      "always_online": false
    },
    "app_home": {
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "slash_commands": [
      {
        "command": "/clawd",
        "description": "向 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 覆盖。

范围（当前 vs 可选）

Slack 的对话 API 是按类型划分范围的：您只需要实际接触的对话类型的范围（频道、群组、私信、多用户私信）。有关概述，请参阅 https://docs.slack.dev/apis/web-api/using-the-conversations-api/。

机器人令牌范围（必需）

chat:write（通过 chat.postMessage 发送/更新/删除消息） https://docs.slack.dev/reference/methods/chat.postMessage
im:write（通过 conversations.open 为用户私信打开私信） https://docs.slack.dev/reference/methods/conversations.open
channels:history、groups:history、im:history、mpim:historyhttps://docs.slack.dev/reference/methods/conversations.history
channels:read、groups:read、im:read、mpim:readhttps://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

用户令牌范围（可选，默认只读）

如果您配置 channels.slack.userToken，请在用户令牌范围下添加这些。

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 添加群组私信打开/私信开始时）
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 仅使用套接字模式（无 HTTP webhook 服务器）。提供两个令牌：

json

{
  "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": "clawd",
      "sessionPrefix": "slack:slash",
      "ephemeral": true
    },
    "textChunkLimit": 4000,
    "mediaMaxMb": 20
  }
}

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

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`	所有回复都进入线程。保持对话集中但可能降低可见性。

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

按聊天类型线程

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

json5

{
  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
提供者默认值（off）

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

示例：

仅线程DM：

json5

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

线程群组DM但保持频道在根目录：

json5

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

使频道线程，保持DM在根目录：

json5

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

手动线程标签

要进行细粒度控制，请在代理响应中使用这些标签：

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

会话与路由

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

DM安全（配对）

默认：channels.slack.dm.policy="pairing" — 未知DM发送者获得配对代码（1小时后过期）。
通过以下方式批准：openclaw pairing approve slack <code>。
要允许任何人：设置 channels.slack.dm.policy="open" 和 channels.slack.dm.allowFrom=["*"]。
channels.slack.dm.allowFrom 接受用户ID、@句柄或电子邮件（在令牌允许时在启动时解析）。向导接受用户名并在设置期间在令牌允许时将其解析为ID。

群组策略

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（在令牌允许时）并记录映射关系；未解析的条目保持原样。
要允许没有频道，设置 channels.slack.groupPolicy: "disabled"（或保持空的白名单）。

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

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

投递目标

与cron/CLI发送一起使用：

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

工具操作

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

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

安全注意事项

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

注意事项

提及门控通过 channels.slack.channels 控制（设置 requireMention 为 true）；agents.list[].groupChat.mentionPatterns（或 messages.groupChat.mentionPatterns）也算作提及。
多代理覆盖：在 agents.list[].groupChat.mentionPatterns 上设置每个代理的模式。
反应通知遵循 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中。
附件在允许且不超过大小限制时下载到媒体存储。

Slack ​

套接字模式（默认） ​

快速设置（初学者） ​

设置 ​

openclaw 配置（最小） ​

用户令牌（可选） ​

令牌使用 ​

历史上下文 ​

HTTP 模式（事件 API） ​

设置 ​

openclaw 配置（最小） ​

清单（可选） ​

范围（当前 vs 可选） ​

机器人令牌范围（必需） ​

用户令牌范围（可选，默认只读） ​

当前不需要（但可能未来需要） ​

配置 ​

限制 ​

回复线程 ​

按聊天类型线程 ​

手动线程标签 ​

会话与路由 ​

DM安全（配对） ​

群组策略 ​

投递目标 ​

工具操作 ​

安全注意事项 ​

注意事项 ​

Slack

套接字模式（默认）

快速设置（初学者）

设置

openclaw 配置（最小）

用户令牌（可选）

令牌使用

历史上下文

HTTP 模式（事件 API）

设置

openclaw 配置（最小）

清单（可选）

范围（当前 vs 可选）

机器人令牌范围（必需）

用户令牌范围（可选，默认只读）

当前不需要（但可能未来需要）

配置

限制

回复线程

按聊天类型线程

手动线程标签

会话与路由

DM安全（配对）

群组策略

投递目标

工具操作

安全注意事项

注意事项