ClawdBotAI LogoClawdBotAI
Home平台集成Slack

Slack 集成

将 ClawdBot 部署到你的 Slack 工作区

概述

Slack 是团队协作的首选平台，ClawdBot 可以作为一个强大的 AI 助手 融入你的工作流程。无论是回答问题、处理任务还是自动化工作， ClawdBot 都能在 Slack 中为你服务。

频道支持

在公共或私有频道中 @mention 使用

团队协作

整个团队共享同一个 AI 助手

斜杠命令

自定义 /clawdbot 命令快速调用

创建 Slack App

首先需要在 Slack 创建一个 App：

步骤 1: 访问 Slack API

  1. 访问 Slack API Apps
  2. 点击 "Create New App"
  3. 选择 "From scratch"
  4. 输入 App 名称（如 "ClawdBot"）
  5. 选择要安装的工作区

步骤 2: 配置 Bot

  1. 在左侧菜单选择 "OAuth & Permissions"
  2. 在 "Bot Token Scopes" 添加必要权限（见下方）
  3. 点击 "Install to Workspace"
  4. 授权后复制 "Bot User OAuth Token"（格式：xoxb-xxx...）

步骤 3: 启用 Socket Mode（推荐）

Socket Mode 让你无需公网 URL 也能接收事件：

  1. 进入 "Socket Mode" 页面
  2. 启用 Socket Mode
  3. 生成 App-Level Token（格式：xapp-xxx...）

配置权限

在 "OAuth & Permissions" 页面添加以下 Bot Token Scopes：

必需权限

权限说明
app_mentions:read接收 @mention 消息
chat:write发送消息
im:history读取私信历史
im:read接收私信
im:write发送私信

可选权限（增强功能）

权限说明
channels:history读取频道历史
files:read读取分享的文件
files:write上传文件
reactions:write添加表情回应
users:read读取用户信息

事件订阅

在 "Event Subscriptions" 页面订阅以下事件：

  • app_mention - 当有人 @你的 Bot
  • message.im - 收到私信
  • message.channels - 频道消息（可选）

连接配置

方法 1: 配置向导

clawdbot slack setup

按照提示输入 Bot Token 和 App Token。

方法 2: 配置文件

# ~/.clawdbot/config.yaml

channels:
  slack:
    enabled: true
    bot_token: "xoxb-xxx..."
    app_token: "xapp-xxx..."  # Socket Mode 需要

    # 可选配置
    default_channel: "#general"
    reply_in_thread: true  # 在线程中回复

方法 3: 环境变量

export CLAWDBOT_SLACK_BOT_TOKEN="xoxb-xxx..."
export CLAWDBOT_SLACK_APP_TOKEN="xapp-xxx..."
clawdbot gateway

验证连接

# 检查 Slack 连接状态
clawdbot channels list

# 发送测试消息
clawdbot slack test

功能特性

消息交互

  • @mention - 在任何频道 @ClawdBot 开始对话
  • 私信 - 直接给 Bot 发私信
  • 线程回复 - 在消息线程中继续对话
  • 表情回应 - Bot 可以用表情表示状态

文件处理

  • 接收和分析用户分享的文件
  • 生成并上传文件（文档、图片等）
  • 处理代码片段

团队功能

  • 多用户共享同一个 Bot
  • 独立的对话上下文（每个用户/频道）
  • 管理员权限控制

斜杠命令

配置自定义斜杠命令（可选）：

创建斜杠命令

  1. 在 Slack App 设置中进入 "Slash Commands"
  2. 点击 "Create New Command"
  3. 设置命令名（如 /clawdbot）
  4. 配置请求 URL（使用 Socket Mode 时自动处理）

使用示例

# 在 Slack 中使用
/clawdbot 帮我总结今天的会议内容
/clawdbot 翻译这段文字到英文
/clawdbot 生成一份项目周报模板

内置命令

命令说明
/clawdbot help显示帮助信息
/clawdbot status查看 Bot 状态
/clawdbot clear清除对话上下文

故障排查

Bot 不响应 @mention

  • 确认 Bot 已被邀请到频道
  • 检查 app_mentions:read 权限
  • 确认事件订阅已配置 app_mention
  • 查看日志：clawdbot logs

Token 无效错误

  • 确保使用 Bot Token（xoxb- 开头），不是 User Token
  • 检查 Token 是否完整复制
  • 如果重新安装了 App，需要更新 Token

Socket Mode 连接失败

  • 确认 Socket Mode 已启用
  • 检查 App-Level Token（xapp- 开头）
  • 确保网络可以连接到 Slack

获取更多帮助

# 运行诊断
clawdbot doctor --verbose

# 查看详细日志
clawdbot logs --level debug

# 测试 Slack 连接
clawdbot slack test --verbose
WhatsAppSignal