# Slack 配置指南

## 你可以用它做什么

使用 Bot 发送消息，或接收 Slack 事件。两个入口使用不同凭证，不要混填。

## 配置前准备

在 Slack 应用管理中创建应用并选定测试工作区。Bot 消息场景配置所需 Bot scopes，安装应用后取得 Bot User OAuth Token；事件场景从应用基础信息取得 Signing Secret。权限变更后可能需要重新安装应用。

需要能够在当前 MOI 工作区创建或编辑工具配置。若没有入口或提示无权操作，请联系工作区管理员，不要借用他人的账号。

## 配置页面


```{figure} /assets/images/agents/guide-5-hd/18-slack-events-config.png
:alt: Slack 事件回调配置使用 Signing Secret；它与 Bot Token 不同。
:class: agent-guide-image
:figclass: agent-guide-shot

Slack 事件回调配置使用 Signing Secret；它与 Bot Token 不同。
```

## 在 MOI 中操作

1. 在工具市场打开 Slack，选择 Bot 消息或事件接收能力。
2. Bot 消息实例填写 Bot Token；事件实例填写 Signing Secret。当前入口分别显示对应字段，不需要把两个 Token 填在同一字段。
3. 保存并执行连接测试。Bot 使用前将应用加入准备测试的频道。
4. 需要接收事件时，复制实例详情的回调 URL，到 Slack Event Subscriptions 配置 Request URL 并完成验证，再选择所需事件。
5. 在 MOI 设置事件路由目标；主动调用则在智能体配置中选择正确实例。

## 字段怎么填写

| 字段 | 何时需要 | 填写说明 |
| --- | --- | --- |
| 实例名称 | 必填 | 例如「测试频道 Bot」。 |
| Bot Token | Bot 消息入口必填 | 使用 xoxb- 开头的 Bot User OAuth Token。 |
| Signing Secret | 事件入口必填 | 用于验证 Slack 发来的事件，不是 Bot Token。 |
| App ID / Team ID | 可选 | 用于识别应用及工作区；应与上述凭证一致。 |

## 让智能体实际使用

回到目标智能体详情，在工具区域检查对应能力是否已绑定；提供实例选择时，核对目标连接。具体步骤见[绑定并验证工具](../bind-tools.md)。

Bot 场景请先确认测试频道和内容，再明确要求发送一条「MOI 连接测试」并到 Slack 核对实际消息。事件场景单独触发一次测试事件，检查投递和任务执行。不要向真实客户频道试发。

验收时逐项确认：

- [ ] 保存成功，重新打开后配置仍存在。
- [ ] 测试连接返回成功，而不是只有「已配置」标签。
- [ ] 对话的工具调用记录显示实际调用，结果与目标平台一致。
- [ ] 如启用事件接收，还验证了事件投递和正确目标触发。

## 常见问题

| 现象 | 检查方法 |
| --- | --- |
| invalid_auth | 确认 Bot Token 类型、所属工作区及有效性。 |
| not_in_channel / channel_not_found | 确认频道 ID 和 Bot 已加入目标频道；私有频道尤其要核对。 |
| 事件验签失败 | Signing Secret 必须来自同一个 Slack App，且公网回调地址正确。 |

## 凭证维护与安全

只在 MOI 的敏感字段中输入 Key、Token、密码或私钥，不要放进提示词、截图、Issue 或 Git 仓库。配置更换前先确认有哪些智能体使用该实例；更换后重新测试，再验证一次实际任务。若凭证泄露，应到提供方撤销并生成新凭证。删除或停用配置会影响依赖它的调用，请先确认影响范围。

## 资料与核对范围

- [Slack 创建应用官方指南](https://docs.slack.dev/app-management/quickstart-app-settings/)。外部控制台菜单可能随版本变化；以提供方页面为准。
- 接入范围与资料依据见[指南说明](index.md#tool-configuration-sources)。
- [返回工具配置指南目录](index.md)。