OpenClaw中文社区

主题

Slack ​

Socket 模式（默认） ​

快速设置（初学者） ​

  1. 创建一个 Slack 应用并启用 Socket Mode。
  2. 创建一个 App Token（xapp-...）和 Bot Token（xoxb-...）。
  3. 为 OpenClaw 设置令牌并启动网关。

最小配置：

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

设置 ​

  1. 在 https://api.slack.com/apps 创建一个 Slack 应用（从零开始）。
  2. Socket Mode → 开启。然后进入 Basic Information → App-Level Tokens → Generate Token and Scopes，作用域选择 connections:write。复制 App Token（xapp-...）。
  3. OAuth & Permissions → 添加机器人令牌作用域（使用下面的清单）。点击 Install to Workspace。复制 Bot User OAuth Token（xoxb-...）。
  4. 可选：OAuth & Permissions → 添加 User Token Scopes（见下面的只读列表）。重新安装应用并复制 User OAuth Token（xoxp-...）。
  5. Event Subscriptions → 启用事件并订阅：
    • message.*（包括编辑/删除/线程广播）
    • app_mention
    • reaction_added, reaction_removed
    • member_joined_channel, member_left_channel
    • channel_rename
    • pin_added, pin_removed
  6. 邀请机器人加入你想要读取的频道。
  7. 如果你使用 channels.slack.slashCommand，创建斜杠命令 /clawd。如果你启用原生命令，为每个内置命令添加一个斜杠命令（与 /help 名称相同）。除非你设置 channels.slack.commands.native: true，否则 Slack 默认关闭原生命令（全局 commands.native 为 "auto"，Slack 保持关闭）。
  8. App Home → 启用 Messages Tab，以便用户可以向机器人发送私信。

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

多账户支持：使用 channels.slack.accounts 配置每个账户的令牌和可选名称。共享模式请参阅 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 模式（Events API） ​

当你的网关可以通过 HTTPS 被 Slack 访问时，使用 HTTP webhook 模式（典型用于服务器部署）。HTTP 模式使用 Events API + Interactivity + 共享请求 URL 的斜杠命令。

设置 ​

  1. 创建一个 Slack 应用并禁用 Socket Mode（如果你只使用 HTTP，这是可选的）。
  2. Basic Information → 复制 Signing Secret。
  3. OAuth & Permissions → 安装应用并复制 Bot User OAuth Token（xoxb-...）。
  4. Event Subscriptions → 启用事件并将 Request URL 设置为你的网关 webhook 路径（默认 /slack/events）。
  5. Interactivity & Shortcuts → 启用并设置相同的 Request URL。
  6. Slash Commands → 为你的命令设置相同的 Request 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": "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": "/clawd",
        "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 覆盖。

作用域（当前 vs 可选） ​

Slack 的 Conversations API 是类型作用域的：你只需要实际使用的对话类型的作用域（频道、群组、im、mpim）。有关概述，请参阅 https://docs.slack.dev/apis/web-api/using-the-conversations-api/。

机器人令牌作用域（必需） ​

用户令牌作用域（可选，默认只读） ​

如果你配置了 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

今天不需要（但未来可能需要） ​

配置 ​

Slack 只使用 Socket Mode（没有 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所有回复都进入线程。保持对话-contained 但可能降低可见性。

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

每个聊天类型的线程 ​

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

json5
{
  channels: {
    slack: {
      replyToMode: "off",        // 频道的默认设置
      replyToModeByChatType: {
        direct: "all",           // DMs 始终线程化
        group: "first"           // 群组 DMs/MPIM 第一个回复线程化
      },
    }
  }
}

支持的聊天类型：

  • direct：1:1 DMs（Slack im）
  • group：群组 DMs / MPIMs（Slack mpim）
  • channel：标准频道（公开/私有）

优先级：

  1. replyToModeByChatType.<chatType>
  2. replyToMode
  3. 提供商默认（off）

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

示例：

仅线程化 DMs：

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

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

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

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

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

手动线程标签 ​

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

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

会话 + 路由 ​

  • DMs 共享 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> 用于 DMs
  • 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（对模式 allowlist 使用 reactionAllowlist）。
  • 默认忽略机器人作者消息；通过 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 中。
  • 附件在允许和大小限制下下载到媒体存储。

基于 MIT 许可发布

Copyright © 2026-present OpenClaw中文社区