---
author: OOMOL
author_url: https://oomol.com/zh-cn/about/
title: Slack 应用指南
description: 在 OOMOL 中添加、使用、排查和移除 Slack 应用。
lang: zh-CN
canonical_url: https://oomol.com/zh-cn/docs/slack/
markdown_url: https://oomol.com/zh-cn/docs/slack.md
---

# Slack 应用指南

OOMOL 支持你连接一次 Slack workspace，并通过已批准的工具调用，把经过授权的 Slack 工具提供给支持的 AI Agent 和可复用 Skills。本文说明如何安装和连接 Slack 应用、OOMOL 会使用哪些 Slack 权限、可以用它完成什么、常见问题如何排查，以及如何移除应用。

OOMOL 要求用户先登录，再连接外部账号。如需安装 Slack 应用，请先登录 OOMOL，打开 Slack 连接页面，然后点击 **Connect** 进入 Slack OAuth 授权流程。

[在 OOMOL 中连接 Slack](https://console.oomol.com/connections/slack)

## 前置条件

- 一个 OOMOL 账号。
- 一个属于目标 workspace 的 Slack 账号。
- 拥有在该 workspace 中安装或授权 Slack app 的权限。
- 可以访问 [OOMOL Console](https://console.oomol.com/)。
- 如果你的 Slack workspace 限制 app 安装，可能需要 Slack workspace owner 或 administrator 先审批 OOMOL 应用。

## 添加应用

1. 登录 [OOMOL Console](https://console.oomol.com/)。
2. 打开 [Slack App Connections 页面](https://console.oomol.com/connections/slack)，或进入 **App Connections** 并搜索 **Slack**。
3. 选择 **Slack**，然后点击 **Connect**。
4. OOMOL 会跳转到 Slack。如有提示，请登录 Slack。
5. 如果 Slack 要求选择 workspace，请选择你要连接的 Slack workspace。
6. 检查 Slack 授权页面，包括请求的权限。
7. 点击 **Allow** 授权 OOMOL。
8. Slack 跳回 OOMOL 后，确认 Slack 已显示为已连接。

如果任一步骤失败，请查看[常见问题排查](#常见问题排查)。

授权后，OOMOL 会保存调用 Slack 工具所需的连接信息。之后，你就可以在 OOMOL 支持的 Agent 和可复用 Skills 中，通过已批准的工具调用使用 Slack 工具。

## OOMOL 在 Slack 中做什么

连接 workspace 后，OOMOL Slack 应用会提供可用的 Slack 动作。根据你运行的动作不同，OOMOL 可以读取已连接 app 可访问的 channels 和 threads，以 OOMOL app 身份发送消息、回复 threads、定时发送消息、上传文件、打开 direct messages，以及添加或移除 emoji reactions。

安装完成后，OOMOL 不会自行开始使用 Slack。只有当已授权用户、可复用 Skill、支持的 Agent 动作或已批准的 OOMOL 工具调用带着必要目标和内容调用 Slack 工具时，Slack 工具才会运行。

## 安装后的下一步

Slack 跳回 OOMOL 后，请先在 OOMOL Console 中确认 Slack 连接已显示为 connected。之后你可以：

- 如果要在支持的 AI Agent 环境中使用已连接的 Slack 工具，配置 oo CLI。
- 使用测试频道列出可见 Slack channels、读取最近消息、发送 demo message、回复 thread、上传 demo file，或添加测试 reaction。
- 如果要让 OOMOL 读取或发送到某个 private channel，并且你的 workspace 策略要求 app 必须在频道内，请先把 OOMOL app 邀请到该 channel。

## 使用方式

Slack 工具需要先连接 Slack workspace 后才能使用。OOMOL 中展示的具体工具列表可能随 connector 更新而变化；当前 Slack connector 包含读取 conversations、读取 threads、发送消息、回复 threads、定时发送消息、管理 bot 已发送消息、处理文件、读取用户信息、打开 direct messages，以及管理 emoji reactions 等工具。

### 通过 oo CLI 使用 Slack 工具

如果你要在支持的 AI Agent 环境中使用已连接的 Slack 工具，请在登录 OOMOL 后安装并配置 oo CLI。

1. 登录 [OOMOL Console](https://console.oomol.com/)。
2. 打开 [oo CLI 安装页面](https://console.oomol.com/install-oo-cli)。
3. 按照页面中的说明操作。该页面会提供一键复制的提示词，用于在支持的 AI Agent 环境中安装并配置 oo CLI。
4. 完成 oo CLI 配置，并在 OOMOL 中连接 Slack 后，就可以让 Agent 使用已连接的 Slack 工具处理 demo channels、messages 和 files。

具体 prompt 可以根据 Agent 环境调整。例如，你可以让 Agent 列出可见 Slack channels、读取测试频道最近消息、发送 demo message、在 thread 中回复，或给测试消息添加 reaction。

### 使用的权限

OOMOL 使用 Slack 权限，让已授权的 Slack 用户可以把 workspace 作为一个 App 连接到 OOMOL，然后把经过授权的 Slack 工具提供给 Agent 和可复用 Skills。

Slack OAuth 授权页面中显示的具体 scopes 是当前安装的准确信息。根据 workspace 启用的工具不同，OOMOL 可能请求以下权限类别：

| Slack 权限范围 | 对应工具 | OOMOL 使用原因 |
| --- | --- | --- |
| Workspace 和 conversation metadata | List Conversations、List Channels、Get Conversation | 展示已连接 Slack app 可访问的 conversations 和 channels，让用户或 Agent 在读取或发送前选择正确目标。 |
| Message history | Get Channel Messages、Get Thread | 当用户或已批准的 Agent 动作需要上下文时，读取已连接 Slack app 可见 conversations 中的消息和 thread replies。 |
| Message posting 和管理 | Post Message、Post Ephemeral Message、Reply Message、Update Message、Schedule Message、Delete Message | 当用户、Skill 或已批准的 Agent 动作提供内容和目标时，发送消息、回复 threads、定时发送消息，并管理已连接 Slack app 发送的消息。 |
| File access | Upload File、List Files、Get File、Delete File | 按已批准的工具调用请求上传文件到 Slack、列出 app 可见文件、读取文件 metadata，或在允许时删除文件。 |
| User information 和 direct messages | List Users、Get User、Open Conversation | 识别 app 可见 Slack users，并在用户、Skill 或 Agent 选择某个 Slack user 后打开或恢复 direct-message conversation。 |
| Emoji reactions | Add Reaction、Get Reactions、Remove Reaction | 当用户、Skill 或已批准的 Agent 动作请求时，为 Slack 消息添加、读取或移除 emoji reactions。 |

如果 Slack 管理员没有授予某个必需权限，Slack 连接可能失败，或依赖该权限的工具不可用，直到该权限被授予。

### 支持的 Slack 工具

| 工具 | 支持的功能 | 常见使用场景 | 前置条件 |
| --- | --- | --- | --- |
| List Conversations | 列出已连接 app 可见的 Slack conversations。 | 让 Agent 在执行后续动作前选择正确的 channel、private channel、group message 或 direct message。 | 已在 OOMOL 中连接 Slack，且已连接 app 可以访问这些 conversations。 |
| List Channels | 列出已连接 app 可见的公开 Slack channels。 | 为报告、提醒、摘要或后续消息找到正确公开频道。 | 已在 OOMOL 中连接 Slack，且公开 channels 对已连接 app 可见。 |
| Get Conversation | 读取 Slack conversation metadata。 | 在后续动作使用 conversation 前，确认名称、ID、类型、成员状态或其他可用 metadata。 | 已在 OOMOL 中连接 Slack，且 conversation 对已连接 app 可见。 |
| Get Channel Messages | 获取 Slack conversation 最近消息。 | 总结近期更新、收集支持请求，或从测试/已批准工作频道准备后续事项。 | 已在 OOMOL 中连接 Slack，且已连接 app 可以读取 conversation history。 |
| Get Thread | 获取 Slack thread 中的消息。 | 总结讨论、准备回复，或从 thread 中提取 action items。 | 已在 OOMOL 中连接 Slack，且已连接 app 可以读取该 thread。 |
| Post Message | 使用 plain text 或 Block Kit blocks 发送 Slack 消息。 | 向指定频道发送状态更新、提醒、摘要或任务结果。 | 已在 OOMOL 中连接 Slack，目标已确定，且用户、Skill 或 Agent 提供了消息内容。 |
| Post Ephemeral Message | 发送只对 conversation 中某个用户可见的消息。 | 向一个 Slack 用户发送私密确认或提示，而不公开给所有人。 | 已在 OOMOL 中连接 Slack，目标 conversation 和 user 已确定，且 app 有权限发送。 |
| Reply Message | 回复 Slack thread。 | 把任务结果、回答、摘要或后续事项直接补充到已有讨论中。 | 已在 OOMOL 中连接 Slack，parent message 已确定，且 app 可以在该 conversation 中发送。 |
| Update Message | 更新 bot 已发送的 Slack 消息。 | 修正、替换或刷新 bot 发送的状态消息。 | 已在 OOMOL 中连接 Slack，且目标消息由已连接 app 发送。 |
| Schedule Message | 定时发送 Slack 消息。 | 为未来某个时间安排提醒、交接说明或更新。 | 已在 OOMOL 中连接 Slack，目标和计划时间有效，且 app 可以在目标位置发送。 |
| Delete Message | 删除 bot 已发送的 Slack 消息。 | 删除 bot 发送的测试消息、过期提醒或错误更新。 | 已在 OOMOL 中连接 Slack，且目标消息可由已连接 app 删除。 |
| Upload File | 通过 file URL 上传文件到 Slack。 | 向指定 conversation 分享报告、导出结果、图片或文档。 | 已在 OOMOL 中连接 Slack，目标已确定，且 file URL 可由 connector runtime 访问。 |
| List Files | 列出已连接 app 可见的 Slack files。 | 在后续动作使用文件前，查找某个 channel 或用户分享的文件。 | 已在 OOMOL 中连接 Slack，且 app 可以看到请求的文件。 |
| Get File | 读取 Slack file metadata。 | 在决定下一步前检查文件名、所有者、类型或其他可用 metadata。 | 已在 OOMOL 中连接 Slack，且文件对已连接 app 可见。 |
| Delete File | 在已连接 app 被允许时删除 Slack file。 | 当用户请求清理时，删除测试文件或 bot 上传的文件。 | 已在 OOMOL 中连接 Slack，且已连接 app 有权限删除该文件。 |
| List Users | 列出已连接 app 可见的 Slack users。 | 在发送 ephemeral message 或打开 direct message 前找到用户。 | 已在 OOMOL 中连接 Slack，且 users 对已连接 app 可见。 |
| Get User | 读取 Slack user metadata。 | 在 Skill 或 Agent 引用某个人前确认正确的 Slack user。 | 已在 OOMOL 中连接 Slack，且 user 对已连接 app 可见。 |
| Open Conversation | 与一个 Slack user 打开或恢复 direct message。 | 用户选择某个 Slack user 后，准备 direct-message 任务。 | 已在 OOMOL 中连接 Slack，且 app 可以打开或访问该 direct message。 |
| Add Reaction | 给 Slack 消息添加 emoji reaction。 | 标记消息已确认、已排队、已完成或需要跟进。 | 已在 OOMOL 中连接 Slack，且消息对已连接 app 可见。 |
| Get Reactions | 获取 Slack 消息 reactions。 | 检查消息是否已通过 reaction 被确认或分流。 | 已在 OOMOL 中连接 Slack，且消息对已连接 app 可见。 |
| Remove Reaction | 移除 Slack 消息上的 emoji reaction。 | 清除不再准确的 reaction。 | 已在 OOMOL 中连接 Slack，且已连接 app 可以移除该 reaction。 |

### 读取 conversations 和 threads

使用场景：让 Agent 在总结更新、提取 action items、准备回复，或把工作转交给其他已连接工具前，查看近期 Slack 消息或某个 thread。

前置条件：

- 已在 OOMOL 中连接 Slack。
- 已连接 Slack app 可以访问目标 conversation 或 thread。
- Agent、Skill 或工具调用已经获得正确的 channel、conversation、message 或 thread identifier。

工具行为：

- 读取已连接 Slack app 可见的 conversation metadata、最近消息和 thread replies。
- 返回通过已连接 workspace 授权可获得的 Slack 数据。
- 只读操作不会发送、更新、删除消息，也不会添加 reaction。

### 发送和管理消息

使用场景：让 Agent 在任务完成后发送状态更新、回复 thread、安排提醒、向某个用户发送 ephemeral message，或更新 bot 已发送的消息。

前置条件：

- 已在 OOMOL 中连接 Slack。
- 目标 channel、conversation、user、message 或 thread 已确定。
- 用户、Skill 或 Agent 已经提供消息内容，并确认发送目标。

工具行为：

- 在提供内容后发送 plain-text messages 或 Block Kit messages。
- 在提供 parent message 后回复已有 threads。
- 当 Slack 接受目标和 timestamp 时，安排未来发送消息。
- 只有在已连接 app 有权限管理目标消息时，才会更新或删除消息。

### 处理文件和 reactions

使用场景：让 Agent 在 Slack 中分享文件、检查 file metadata，或添加 reaction 来标记某条消息已确认、已排队、已完成或需要跟进。

前置条件：

- 已在 OOMOL 中连接 Slack。
- 目标 conversation、file、message 或 reaction name 已确定。
- 文件上传需要提供 connector runtime 可以访问的 URL。

工具行为：

- 在提供 file URL 和目标后上传文件到 Slack。
- 读取已连接 app 可见的 file metadata 和 reactions。
- 在 Slack 允许已连接 app 操作时，添加或移除 reactions。
- 只有在已连接 app 有权限删除目标文件时，才会删除文件。

## 测试应用

你可以使用一个允许安装 app 的 Slack workspace 测试 Slack 应用。建议使用测试频道和 demo messages，这样可以安全测试读取、发送、更新、文件和 reaction 动作。

### 示例测试 prompts

- List Slack public channels visible to the connected app.
- Get recent messages from the `#oomol-test` channel.
- Post `Hello from OOMOL` to the `#oomol-test` channel.
- Reply to the latest test message with `Received`.
- Add the `white_check_mark` reaction to a test message.
- Get reactions for the test message.
- Schedule a Slack message in the test channel for later today.
- Upload a demo file to the test channel.
- List Slack users visible to the connected app.
- Open a direct message with a test user.

测试时请只使用 demo data，不要在测试 prompt 中使用真实客户、员工或机密 Slack 内容。

## 常见问题排查

### 无法添加 Slack 应用

- 确认你登录的是正确的 OOMOL 账号。
- 确认你正在登录想要连接的 Slack workspace。
- 如果你的 Slack workspace 需要 app approval，请让 Slack workspace owner 或 administrator 审批 OOMOL 应用。
- 如果 OOMOL 中已有失败或不完整的 Slack 连接，先断开它，再重新连接。
- 如果问题仍然存在，请联系 OOMOL 支持，并附上 OOMOL 账号邮箱、Slack workspace 名称或 ID、尝试连接的时间、错误信息或截图。

### Slack 工具找不到 channel 或 conversation

- 确认已连接 Slack app 可以访问目标 conversation。
- 如果目标是 private channel，请确认已连接 app 已加入该 channel，或拥有所需 workspace 权限。
- 确认请求使用了正确的 conversation ID、channel name 或搜索输入。
- 如果你最近调整过 Slack 权限，请在 OOMOL 中重新连接 Slack，以刷新授权状态。

### Slack 工具无法读取消息

- 确认已连接 Slack app 有权限读取目标 conversation history。
- 如果消息在 private channel 中，请确认 app 已在该 private channel 中。
- 检查请求是否使用了正确的 message timestamp、thread timestamp 或 conversation ID。
- 如果 workspace 最近修改过 app scopes 或 channel access，请在 OOMOL 中重新连接 Slack。

### Slack 工具无法发送或更新消息

- 确认已连接 Slack app 可以在目标 conversation 中发送消息。
- 确认工具调用具有有效的目标和消息正文。
- 对于 update 和 delete 动作，确认目标消息由已连接 Slack app 发送，并且可由该 app 管理。
- 如果 Slack 返回 workspace policy 或 permission error，请让 Slack workspace owner 或 administrator 检查 app 权限。

### Slack 文件动作失败

- 对于上传动作，确认 file URL 可由 connector runtime 访问。
- 确认已连接 Slack app 可以访问目标 conversation。
- 对于删除动作，确认已连接 app 有权限删除目标文件。

## 移除应用

你可以从 OOMOL 或 Slack 任一侧移除 Slack 应用。如果你不再希望 OOMOL 访问 Slack，建议两边都移除。

### 从 OOMOL 移除 Slack

1. 登录 [OOMOL Console](https://console.oomol.com/)。
2. 打开 [Connections](https://console.oomol.com/connections)。
3. 在已连接应用中找到 **Slack**。
4. 打开 Slack 连接详情。
5. 选择 **Disconnect**、**Remove**，或 OOMOL 界面中显示的等效移除操作。
6. 确认移除。

### 从 Slack 移除 OOMOL

1. 登录已连接 workspace 中的 Slack。
2. 打开 **Manage apps**，或进入该 workspace 的 Slack app management 页面。
3. 找到 **OOMOL**。
4. 打开应用详情。
5. 选择 remove、uninstall 或 revoke app 的操作。
6. 确认移除。

如果你没有在 Slack 中移除 app 的权限，请让 Slack workspace owner 或 administrator 移除该应用。

## 移除后的影响

- 移除或取消授权 Slack 连接后，OOMOL 将无法再为你的 workspace 使用 Slack 工具。
- 依赖 Slack 的 Agent、Skills 或其他任务可能会失败，直到你重新连接 Slack。
- 移除前已创建的 Slack 消息、文件、channels 和 reactions 会保留在 Slack 中，除非你在 Slack 中删除或修改它们。
- 移除应用不会删除你的 OOMOL 账号。

## 数据处理

OOMOL 只会在 Slack 用户授权应用，并且用户、Skill 或已批准的 Agent 动作需要使用 Slack 时访问 Slack 数据。OOMOL 只会为了提供通过 OOMOL 支持的 Agent、可复用 Skills 和已批准工具调用请求的 Slack 工具而使用 Slack 数据。

- Slack OAuth tokens 会被加密存储。
- OOMOL 不会向 AI Agent、提示词、浏览器客户端、应用代码或终端用户暴露 Slack OAuth token。
- 当 Slack 工具被调用时，OOMOL 可能会处理 Slack workspace metadata、conversation metadata、messages、thread replies、files、user metadata 和 reactions。
- Slack 数据只会在必要时存储在用户可见的工具结果、使用记录、执行历史或运营记录中。
- 存储的数据会静态加密，并通过 TLS/SSL 传输。
- OOMOL 不会出售你的 Slack 数据。
- OOMOL 不会将 Slack 数据用于广告。
- OOMOL 不会使用客户私有内容训练 AI 模型。
- 作为该 connector 的一部分，OOMOL 不会在后台持续同步或复制 Slack workspace 数据。只有当已授权用户、Skill 或已批准的 Agent 动作调用 Slack 工具时，OOMOL 才会访问 Slack 数据。
- 当你移除或取消授权 Slack 应用后，OOMOL 会停止使用已撤销的 Slack 授权，并按照正常连接移除流程删除或失效化已保存的 Slack 授权 token。
- 某些日志、支持记录、安全记录或账单相关记录可能会按照[隐私政策](/zh-cn/privacy/)中的说明保留。

## FAQ

### 是否需要付费 Slack workspace？

大多数 OOMOL Slack 工具只要求 Slack workspace 允许请求的 app 权限。部分 Slack 功能、app approval controls、retention settings 或 workspace policies 可能取决于你的 Slack 套餐或组织设置。

### 可以连接多个 Slack workspace 吗？

请在 OOMOL Console 中查看你的账号或 workspace 当前支持的连接选项。如果你需要处理多个 Slack workspaces，可以联系支持团队。

### 连接后 Agent 会自动使用 Slack 吗？

连接 Slack 会让 Slack 工具在 OOMOL 中可用，但是否调用工具仍取决于你选择的 Agent、Skill、权限和审批。基于账号的服务仍然需要你的授权。

### 连接后 OOMOL 会读取所有 Slack 消息吗？

OOMOL 按需访问 Slack 数据：已授权用户、Skill 或已批准的 Agent 动作针对已连接 App 可访问的 conversation 调用工具时，才会读取或修改对应数据。

### OOMOL 可以删除 Slack 消息或文件吗？

当前 Slack connector 包含删除 bot 已发送消息的动作，以及在已连接 app 被允许时删除文件的动作。只有当用户或已批准的工具调用使用支持的 delete tool，并提供必要目标信息时，OOMOL 才会删除 Slack 内容。

## 联系支持

如果你在添加、使用、测试或移除 Slack 应用时需要帮助，请联系 OOMOL 支持：

- 邮箱：[support@oomol.com](mailto:support@oomol.com)
- 支持页面：[https://oomol.com/zh-cn/support/](https://oomol.com/zh-cn/support/)

请附上你的 OOMOL 账号邮箱、相关 Slack workspace 名称或 ID、你正在执行的操作，以及错误信息或截图。