​

Slack

​

快速设置

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

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

openclaw gateway

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

​

令牌模型

• Socket 模式需要 botToken + appToken。
• HTTP 模式需要 botToken + signingSecret。
• 配置中的令牌优先于环境变量回退。
• SLACK_BOT_TOKEN / SLACK_APP_TOKEN 环境变量仅对默认账户生效。
• userToken (xoxp-...) 仅支持配置，且没有环境变量回退，默认只读行为 (userTokenReadOnly: true)。
• 可选：如需让外发消息使用当前代理身份（自定义 username 和头像），可额外添加 chat:write.customize 权限。icon_emoji 采用 :emoji_name: 格式。

​

访问控制与路由

​

命令和斜线命令行为

• Slack 默认关闭原生命令自动模式（commands.native: "auto" 不启用 Slack 原生命令）。
• 通过 channels.slack.commands.native: true（或全局 commands.native: true）启用 Slack 原生命令处理。
• 开启原生命令后，需在 Slack 注册对应斜线命令(/<command>)；仅有一例外：
  • 状态命令注册为 /agentstatus（Slack 保留 /status）
• 未启用原生命令时，可通过 channels.slack.slashCommand 配置单一斜线命令。
• 原生参数菜单的渲染方式动态调整：
  • 不超过 5 选项时使用按钮块
  • 6~100 选项时使用静态选择菜单
  • 超过 100 选项时启用外部选择，具备异步选项过滤（当交互选项处理器可用）
  • 若编码后选项超出 Slack 限制，回退至按钮模式
• 斜线命令的长选项参数菜单，在提交前采用确认对话框。

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

• agent:<agentId>:slack:slash:<userId>

​

线程、会话和回复标签

• 私信路由为 direct；频道为 channel；多方私信（MPIM）为 group。
• 默认 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.replyToMode：off|first|all（默认 off）
• channels.slack.replyToModeByChatType：针对 direct|group|channel 分别设置
• 私信的旧版回退字段：channels.slack.dm.replyToMode

• [[reply_to_current]]
• [[reply_to:<id>]]

​

媒体、分块及发送

​

操作与门控

​

事件与运行行为

• 消息编辑/删除/线程广播映射为系统事件。
• 表情添加/删除事件映射为系统事件。
• 成员加入/离开、频道创建/重命名、固定消息添加/删除事件映射为系统事件。
• 助理线程状态更新（线程中“正在输入…”指示），使用 assistant.threads.setStatus，需机器人权限 assistant:write。
• channel_id_changed 事件可在启用配置写入时迁移频道配置键。
• 频道话题/目的元数据视为不可信上下文，可注入路由上下文。
• 块操作及模态交互产生结构化的 Slack interaction: ... 系统事件，含丰富负载字段：
  • 块操作：选中的值、标签、选择器值及 workflow_* 元数据
  • 模态的 view_submission 和 view_closed 事件携带路由频道元数据和表单输入

​

确认表情

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• 代理身份表情回退（agents.list[].identity.emoji，否则为 ”👀”）

• Slack 期望使用表情简码（例如 "eyes"）。
• 设为空字符串 "" 可禁用对应 Slack 账户或全局的确认表情。

​

输入状态表情回退

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

• Slack 期望使用表情简码（如 "hourglass_flowing_sand"）。
• 该表情为尽力添加且自动清理，发送回复或异常路径完成后尝试移除。

​

清单与权限范围核对清单

{
  "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": "/openclaw",
        "description": "发送消息给 OpenClaw",
        "should_escape": false
      }
    ]
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "chat:write",
        "channels:history",
        "channels:read",
        "groups:history",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "users:read",
        "app_mentions:read",
        "assistant:write",
        "reactions:read",
        "reactions:write",
        "pins:read",
        "pins:write",
        "emoji:read",
        "commands",
        "files:read",
        "files:write"
      ]
    }
  },
  "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"
      ]
    }
  }
}

​

故障排除

openclaw channels status --probe
openclaw logs --follow
openclaw doctor

openclaw pairing list slack

​

文本流式传输

• off：禁用实时预览流式传输。
• partial（默认）：用最新部分输出替换预览文本。
• block：追加分块预览更新。
• progress：生成过程中显示进度状态文本，结束后发送最终文本。

channels:
  slack:
    streaming: partial
    nativeStreaming: false

• channels.slack.streamMode（replace | status_final | append）会自动迁移到 channels.slack.streaming。
• 布尔类型的 channels.slack.streaming 会自动迁移到 channels.slack.nativeStreaming。

​

要求

1. 在 Slack 应用设置中启用 代理和 AI 应用 功能。
2. 确保应用具备 assistant:write 权限。
3. 回复消息必须处于线程中。线程选择依然遵循 replyToMode。

​

行为

• 首个文本块启动流式接口（chat.startStream）。
• 后续文本块追加到同一流（chat.appendStream）。
• 回复结束时终止流（chat.stopStream）。
• 媒体和非文本负载回落为普通发送方式。
• 若流式过程中失败，OpenClaw 对剩余负载改用默认发送。

​

配置参考指引

• 配置参考 - Slack 关键 Slack 字段：
  • 模式/身份认证：mode，botToken，appToken，signingSecret，webhookPath，accounts.*
  • 私信访问权限：dm.enabled，dmPolicy，allowFrom（旧版：dm.policy，dm.allowFrom），dm.groupEnabled，dm.groupChannels
  • 兼容性开关：dangerouslyAllowNameMatching（危险开关，非必需时保持关闭）
  • 频道访问：groupPolicy，channels.*，channels.*.users，channels.*.requireMention
  • 线程/历史：replyToMode，replyToModeByChatType，thread.*，historyLimit，dmHistoryLimit，dms.*.historyLimit
  • 发送能力：textChunkLimit，chunkMode，mediaMaxMb，streaming，nativeStreaming
  • 运营/功能：configWrites，commands.native，slashCommand.*，actions.*，userToken，userTokenReadOnly

​

相关内容

• 配对
• 频道路由
• 故障排除
• 配置
• 斜线命令