Skip to content

Slack 机器人设置

将您的 Claw Buff 智能体连接到 Slack 的分步指南

将您的 Claw Buff AI 智能体连接到 Slack 工作空间。机器人将响应私聊、提及和斜杠命令。设置大约需要 10 分钟。

前置条件

  • 一个拥有管理员权限（或安装应用权限）的 Slack 工作空间
  • 已部署的 Claw Buff 智能体（快速开始）

第一步：创建 Slack App

打开 Slack API 门户

前往 api.slack.com/apps，点击 Create New App。

选择创建方式

选择 From a manifest（推荐——会自动配置所有权限）。从下拉列表选择工作空间，点击 Next。

选择 JSON 标签页，将内容替换为以下 Manifest，然后点击 Next。

您可以修改 name 和 display_name 字段来自定义机器人名称（如 "我的 AI 助手"）。description 和 assistant_description 字段也可以自行修改。

{
  "display_information": {
    "name": "Claw Buff",
    "description": "由 Claw Buff 驱动的 AI 智能体"
  },
  "features": {
    "bot_user": {
      "display_name": "Claw Buff",
      "always_online": false
    },
    "assistant_view": {
      "assistant_description": "由 Claw Buff 驱动的 AI 智能体"
    },
    "app_home": {
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    }
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "chat:write",
        "channels:history",
        "channels:read",
        "groups:history",
        "im:history",
        "im:read",
        "im:write",
        "users:read",
        "app_mentions:read",
        "assistant:write"
      ]
    }
  },
  "settings": {
    "event_subscriptions": {
      "bot_events": [
        "app_mention",
        "assistant_thread_started",
        "message.im"
      ]
    },
    "socket_mode_enabled": true
  }
}

确认摘要信息，点击 Create。

获取 Token

需要两个 Token：

Bot Token：

  • 侧栏进入 OAuth & Permissions
  • 点击 Install to <你的工作空间> → Allow
  • 复制 Bot User OAuth Token（以 xoxb- 开头）

App Token：

  • 进入 Basic Information → App-Level Tokens
  • 点击 Generate Token and Scopes
  • 命名（如 "socket"），添加 scope connections:write
  • 点击 Generate，复制 Token（以 xapp- 开头）

第二步：连接到 Claw Buff

  1. 打开 Claw Buff 控制台 → 渠道页面
  2. 找到 Slack 卡片，点击连接
  3. 粘贴两个 Token：
    • Bot Token（xoxb-...）
    • App Token（xapp-...）
  4. 点击保存并激活

机器人将通过 Socket Mode 连接——无需公网 URL 或 Webhook。

第三步：配对账号

机器人响应之前，需要先配对你的 Slack 账号：

  1. 私聊机器人 — 在 Slack 侧栏的 Apps 下找到你的机器人，发送任意消息（如 "你好"）
  2. 机器人会回复一个配对码（如 7EPLYS7R）
  3. 打开 Claw Buff 控制台 → 渠道页面
  4. 你会看到待处理的配对请求 — 点击配对码旁的批准按钮

批准后，机器人就会回复你的消息。

配对码会在 1 小时后过期。过期后，重新给机器人发消息即可获取新的配对码。

第四步：开启频道（可选）

默认情况下，机器人仅在私聊中工作。要在 Slack 频道中使用：

  1. 在 Slack 中，右键点击频道名称 → 查看频道详情 → 复制面板底部的 Channel ID

如果没有看到 Channel ID，打开频道详情并滚动到底部——它显示为类似 C07V1ABC123 的字符串。

  1. 在控制台中，前往渠道 → 点击 Slack 卡片上的管理
  2. 在授权的频道下，粘贴 Channel ID 并点击添加
  3. 在 Slack 中，邀请机器人到频道：输入 /invite @你的机器人名称

机器人将会在该频道中响应 @提及 消息。你可以添加多个频道。

第五步：开始聊天

  • 私聊 — 在 Slack 侧栏的 Apps 下找到你的机器人
  • 频道提及 — 输入 @你的机器人名称 加上你的消息
  • App Home — 打开机器人的 App Home 标签页进行专属对话

Socket Mode 意味着智能体向外连接到 Slack——无需配置防火墙、反向代理或公网 URL。开箱即用。

功能特性

功能支持情况
私聊支持
频道提及支持
流式响应支持（Slack 原生流式）
斜杠命令支持
App Home支持
线程回复支持
富文本格式支持（Block Kit / mrkdwn）

常见问题

1. 机器人不响应？

  • 检查两个 Token — 需要同时提供 Bot Token（xoxb-）和 App Token（xapp-）
  • 检查 Socket Mode — 确保 Slack App 设置中已启用 Socket Mode
  • 检查控制台 — 渠道页面会显示连接状态和错误日志

2. 机器人不响应私聊？

确保存在以下权限范围：im:history、im:read、im:write。如果使用了上方的 Manifest，这些已包含在内。

3. 机器人不响应频道中的提及？

  • 需要先邀请机器人到频道（输入 /invite @Claw Buff）
  • 确保存在 app_mentions:read 和 channels:history 权限范围

4. "not_allowed_token_type" 错误？

可能是 Bot Token 和 App Token 填反了。Bot Token 以 xoxb- 开头，App Token 以 xapp- 开头。