Slack

Documentation Index

Fetch the complete documentation index at: https://docs.cowagent.ai/llms.txt

Use this file to discover all available pages before exploring further.

通过 Slack App 的 Socket Mode 接入 CowAgent，支持私聊（DM）与频道（@机器人 / 线程内回复触发）。Socket Mode 基于长连接，无需公网 IP 与回调地址，开箱即用。

​

一、接入步骤

​

步骤一：创建 Slack App

1. 打开 Slack API 应用管理页，点击 Create New App → From scratch。
2. 填写 App Name（如 CowAgent），选择要安装的 Workspace，点击创建。

​

步骤二：开启 Socket Mode 并获取 App Token

1. 左侧菜单进入 Settings → Socket Mode，打开 Enable Socket Mode。
2. 系统会提示生成一个 App-Level Token，作用域勾选 connections:write，生成后保存这串以 xapp- 开头的 Token。

​

步骤三：配置 Bot 权限并安装

1. 进入 Features → OAuth & Permissions，在 Bot Token Scopes 中点击 Add an OAuth Scope，逐项添加以下权限：
   app_mentions:read
   channels:history
   chat:write
   commands
   files:read
   files:write
   groups:history
   im:history
   mpim:history
   users:read
   
   files:read / files:write 用于图片、文件的收发；若仅需文本对话可省略。
2. 进入 Features → Event Subscriptions，打开 Enable Events，在 Subscribe to bot events 中点击 Add Bot User Event 添加以下事件：
   app_mention
   message.im
   message.channels
   
   如需在私有频道使用，再添加 message.groups。
3. 进入 Features → App Home，在 Show Tabs 区域勾选 Messages Tab，并勾选下方的 Allow users to send Slash commands and messages from the messages tab（允许用户从消息标签页发送消息），否则私聊输入框会被关闭、无法给机器人发消息。
4. 回到 OAuth & Permissions，点击 Install to Workspace 完成安装，安装后获取以 xoxb- 开头的 Bot User OAuth Token。

​

步骤四：接入 CowAgent

{
  "channel_type": "slack",
  "slack_bot_token": "xoxb-xxxxxxxxxxxx",
  "slack_app_token": "xapp-xxxxxxxxxxxx",
  "slack_group_trigger": "mention_or_reply"
}

[Slack] Bot logged in as user_id=U0XXXXXXX, team=Txxxxxxxx
[Slack] ✅ Slack bot ready, listening for events

​

二、功能说明

​

三、使用

• 私聊（DM）：在 Slack 左侧 Apps 中找到你的 App，直接发消息对话。
• 频道：把 App 邀请进频道（/invite @你的App），使用 @你的App 你好 触发对话；后续在同一线程内直接回复即可继续对话。