> ## Documentation index
> Fetch the complete documentation index at: https://docs.manyfold.ai/zh/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack

> 将 Slack app 连接到 Manyfold Agent。

Source: https://docs.manyfold.ai/zh/docs/channels/slack/

当你希望在 Slack 私聊、公共/私有 channel、多人私聊、thread 或 Slack Assistant 面板中使用 Agent 时，可以连接 Slack。Slack 通过带签名的 webhook 投递事件和原生 slash command。

## 渠道能力

| 能力 | 支持情况 |
| ---- | -------- |
| DM、channel 和 thread | 支持；channel 默认需要 @mention。 |
| Slack Assistant / DM thread | 支持；每个 thread 可使用独立 session。 |
| 原生 slash command | 支持；原生命令回复仅发给调用者（ephemeral）。 |
| 接收文件 | 支持；纯文件消息也可以驱动 Agent。 |
| Agent 生成的文件 | 支持；可把 workspace 文件上传到同一 channel/thread。 |
| 实时进度 | 支持；Agent 工作时更新同一条消息。 |
| 用户和 operator allowlist | 支持；dispatch 前检查 Slack user ID。 |

## 前提条件

- 已有 Manyfold Agent。
- 有权限在 workspace 中创建和安装 Slack app。
- 有权限把 app 邀请到目标 channel。

## 使用 Manyfold manifest 配置

渠道拥有专属 inbound URL 后，Manyfold 才能生成 manifest。它适合重建/迁移 app，或让 Slack 一次校验完整配置。

全新配置可使用以下 bootstrap 流程：

1. 创建并安装一个最小 bootstrap Slack app，取得 `xoxb-` token 和 signing secret。
2. 使用这些凭证在 Manyfold 创建 Slack 渠道并获得 inbound URL。
3. 打开渠道详情页，选择 **Copy manifest JSON**。
4. 在 [Slack API Apps](https://api.slack.com/apps) 中选择 **Create New App -> From an app manifest**。
5. 选择 workspace，粘贴 JSON，检查后创建 app。
6. 在 **OAuth & Permissions** 中安装或重新安装 app。
7. 在 Manyfold 渠道中用最终 app 的 Bot User OAuth Token 和 signing secret 替换 bootstrap 凭证。
8. 不再需要时删除 bootstrap app，然后运行渠道注册和测试。

Manifest 会配置 Request URL、所有 event subscription、11 个 slash command 和文件所需 scope。Slash command 名称在 workspace 内是全局的；如果其他 app 已占用 `/new` 等名称，请在安装前修改 manifest 中的 command。

## 手动配置 Slack app

从零创建 app、添加 bot user，并添加以下 bot token scope：

| Scope | 用途 |
| ----- | ---- |
| `app_mentions:read` | 接收 channel 中的 @mention。 |
| `channels:history` | 接收公共 channel 消息事件。 |
| `groups:history` | 接收私有 channel 消息事件。 |
| `im:history` | 接收私聊消息事件。 |
| `mpim:history` | 接收多人私聊消息事件。 |
| `chat:write` | 发送回复和实时进度消息。 |
| `commands` | 使用原生 slash command。 |
| `files:read` | 下载用户附加的文件。 |
| `files:write` | 上传 Agent 生成的 workspace 文件。 |

在 **Event Subscriptions** 中，把 Manyfold 渠道 inbound URL 设为 Request URL，并订阅：

| Bot event | 用途 |
| --------- | ---- |
| `app_mention` | 接收 channel 中明确的 @mention。 |
| `message.channels` | 公共 channel 消息，包括 file share。 |
| `message.groups` | 私有 channel 消息。 |
| `message.im` | 私聊和 Assistant 对话。 |
| `message.mpim` | 多人私聊。 |

在 **Slash Commands** 下创建 `/help` 中列出的每个 command，并把它们都指向同一个 Manyfold inbound URL。修改 scope、event 或 command 后必须重新安装 app。

## 连接到 Manyfold

1. 打开 **Settings -> Channels**。
2. 创建渠道并选择 **Slack**。
3. 选择 Agent 并输入标签。
4. 粘贴 `xoxb-` Bot User OAuth Token 和 signing secret。
5. 创建渠道。
6. 如果没有使用生成的 manifest，把 inbound URL 配到 Slack Event Subscriptions 和所有 slash command。
7. 安装/重新安装 app，并邀请到每个目标 channel。
8. 运行 **Register**，然后运行 **Test**。

注册通过 `auth.test` 保存 bot user ID 和 workspace ID。来自其他 workspace 的消息会被拒绝；把 app 移动或重新安装到其他 workspace 后，请再次注册。

## 消息和文件

- 文本、Slack file share 和纯文件消息都可以驱动 Agent。
- Incoming file 使用 Slack 鉴权下载 URL。Manyfold 每条消息最多接收 10 个文件、单文件 25 MB、总计 100 MB；不支持或超限文件会被跳过，其他文本/文件仍继续处理。
- 开启 **Attach files the agent links** 后，final answer 中链接的 workspace 文件会上传到同一 channel 或 thread。
- 长回复会拆成多段，后续段落会留在当前 Slack thread。
- Markdown 链接和基本强调会转换为 Slack 原生格式。

文件输入仍要求所选 Agent framework 支持 attachment。

## Thread 和命令

- 开启 **Thread isolation** 后，每个 channel thread、Assistant 对话或手动 DM thread 映射到独立 session；普通 DM 按用户保持一个扁平 session。
- **Auto-thread** 会把顶层 channel mention 回复到以该消息为根的新 thread。它要求 thread isolation，且不适用于 DM 或 slash command。
- 原生 slash command 使用 Slack command payload，并返回仅调用者可见的 ephemeral 回复。Slack 原生命令 payload 不包含输入框所在 thread，因此它操作 channel-level scope，而不是当前打开的 thread。
- 文本形式的命令仍走普通消息路径。完整命令见[切换 Session](/zh/docs/channels/session-switching/)。

## 设置

| 设置 | 建议 |
| ---- | ---- |
| Mention only | Channel 中建议开启；DM 无需 mention。 |
| Shared session | 默认关闭以按用户隔离；只有明确希望团队共享一段对话时才开启。 |
| Thread isolation | 保持开启，让每个 Slack thread 使用独立 session。 |
| Auto-thread | 希望顶层 mention 自动进入 thread 时开启。 |
| Progress mode | **Preview** 更新一条实时消息；**Activity** 还会显示工具/思考活动；**Final** 只发送最终答案。 |
| Attach files the agent links | 希望用户在 Slack 收到生成文件时保持开启。 |
| Send message context | 建议开启，让 Agent 获得 sender、workspace/channel、thread 和 message ID。 |

## 访问控制

| 设置 | 效果 |
| ---- | ---- |
| Allowed user IDs | 非空时只有列出的 Slack 用户和 operator 能使用 bot；留空允许 app 在已注册 workspace 中能触达的所有人。 |
| Operator user IDs | 允许执行 `/model` 等 Agent 级命令的用户；留空会禁用这些 Slack 命令。 |

在成员 profile 的三点菜单中选择 **Copy member ID** 获取 Slack user ID。Operator 自动拥有对话权限。Slack 身份只是外部 actor，不会关联到 Manyfold 账号。

## 验证

运行 **Test**，通过 `auth.test` 验证 token 并确认渠道 active。然后：

1. 私聊 app。
2. 把 app 邀请到 channel 后 @mention。
3. 从 Slack command 菜单运行 `/help`。
4. 如需文件能力，上传一个小文件测试。

## 排查问题

- **Request URL 验证失败**：确认 signing secret，并使用 Manyfold 当前显示的 inbound URL。
- **Bot 忽略 DM 或某类 channel**：添加对应 `message.*` event 和 history scope，然后重新安装 app。
- **Bot 收到 channel 消息但无法回复**：邀请 app 进入 channel，并确认 `chat:write`。
- **Slash command 不存在或被其他 app 响应**：添加 `commands`、使用当前渠道 URL 创建 command，并解决 workspace 内名称冲突。
- **Scope 或 event 修改不生效**：重新安装 Slack app。
- **文件输入失败**：确认 `files:read`；输出失败时确认 `files:write` 和 **Attach files the agent links**。
- **用户消息被静默忽略**：检查 Allowed user IDs，并确认 app 仍安装在渠道记录的 workspace。
- **回复进入错误 scope**：检查 **Thread isolation**、**Auto-thread** 和 **Share session in channel**。

## 另请参阅

- [连接渠道](/zh/docs/channels/)
- [切换 Session](/zh/docs/channels/session-switching/)
- [Telegram](/zh/docs/channels/telegram/)
- [Lark 和飞书](/zh/docs/channels/lark/)
- [Discord](/zh/docs/channels/discord/)
- [Matrix](/zh/docs/channels/matrix/)
- [Slack app manifests](https://api.slack.com/reference/manifests)
- [Slack Events API](https://api.slack.com/apis/events-api)