Slack 配置指南¶
你可以用它做什么¶
使用 Bot 发送消息，或接收 Slack 事件。两个入口使用不同凭证，不要混填。
配置前准备¶
在 Slack 应用管理中创建应用并选定测试工作区。Bot 消息场景配置所需 Bot scopes，安装应用后取得 Bot User OAuth Token；事件场景从应用基础信息取得 Signing Secret。权限变更后可能需要重新安装应用。
需要能够在当前 MOI 工作区创建或编辑工具配置。若没有入口或提示无权操作，请联系工作区管理员，不要借用他人的账号。
配置页面¶
Slack 事件回调配置使用 Signing Secret；它与 Bot Token 不同。¶
在 MOI 中操作¶
在工具市场打开 Slack，选择 Bot 消息或事件接收能力。
Bot 消息实例填写 Bot Token；事件实例填写 Signing Secret。当前入口分别显示对应字段，不需要把两个 Token 填在同一字段。
保存并执行连接测试。Bot 使用前将应用加入准备测试的频道。
需要接收事件时，复制实例详情的回调 URL，到 Slack Event Subscriptions 配置 Request URL 并完成验证，再选择所需事件。
在 MOI 设置事件路由目标；主动调用则在智能体配置中选择正确实例。
字段怎么填写¶
字段 |
何时需要 |
填写说明 |
|---|---|---|
实例名称 |
必填 |
例如「测试频道 Bot」。 |
Bot Token |
Bot 消息入口必填 |
使用 xoxb- 开头的 Bot User OAuth Token。 |
Signing Secret |
事件入口必填 |
用于验证 Slack 发来的事件，不是 Bot Token。 |
App ID / Team ID |
可选 |
用于识别应用及工作区；应与上述凭证一致。 |
让智能体实际使用¶
回到目标智能体详情，在工具区域检查对应能力是否已绑定；提供实例选择时，核对目标连接。具体步骤见绑定并验证工具。
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 创建应用官方指南。外部控制台菜单可能随版本变化；以提供方页面为准。
接入范围与资料依据见指南说明。