Slack
Anyy 通过 Slack Socket Mode 连接。一个可用账号同时需要 Bot Token（Web API 与消息操作）和 App Token（WebSocket 连接）。
1. 准备 Slack App
在 Slack App 配置中：
- 为目标 Workspace 创建 App；
- 启用 Socket Mode；
- 创建具备 Socket Mode Scope 的 App-level Token；
- 添加读取目标会话、发消息和读取支持文件所需的 Bot Scopes；
- 启用私聊和群组 Mention 所需的消息 Event Subscriptions；
- Scope 变化后重新安装 App 到 Workspace。
Dashboard 会列出 Socket Mode、Event Subscriptions、App Token Scopes 与 Bot Token Scopes 等外部前置条件。满足后再启用账号。
2. 连接到 Anyy
进入 Dashboard → Channels → Add channel → Slack，选择 Socket Mode，填写：
- Bot Token（
xoxb-…）； - App Token（
xapp-…）； - Anyy 内的账号标识；
- 私聊与群组访问策略。
CLI 设置：
anyy setup channel slack
账号启用时两个 Token 都是必填项，并会保存为 Profile Secret 引用。
3. 访问策略
Slack 私聊默认 pairing，群组默认 mention。DM 支持 open、allowlist、pairing、disabled；Group 支持 mention、open、allowlist、disabled。
Sender Allowlist 使用 Slack User ID，允许的群组使用 Channel ID。确认模型费用和已启用工具前，优先使用 Pairing/Allowlist。
4. Reload 并测试
anyy channel reload
anyy channel doctor slack
私聊 App，或在允许的频道 Mention。DM Pairing 模式下批准请求：
anyy channel pairing list --channel slack
anyy channel pairing approve --request REQUEST_ID
Thread 与文件
Anyy 会把 Slack Thread Timestamp 保留在渠道路由中，并在原 Thread 回复。受支持的入站文件通过 Bot Credential 下载，检查大小后作为有作用域的附件暂存。
Socket Mode 不需要公开的入站 Webhook URL，但 Gateway 必须能主动连接 Slack。
Slack Token 的 Scope 来自 App 安装授权。只改 App 配置不一定会更新现有 Bot Token，通常需要重新安装。
常见问题
| 现象 | 检查项 |
|---|---|
| Socket 无法连接 | 检查 Socket Mode、xapp- Token、Scope 与出站网络 |
| 认证成功但收不到消息 | 检查 Event Subscription、Bot Scope、安装与频道成员身份 |
| 无法发消息 | 核对 xoxb- Token 和目标会话的写权限 |
| 私聊被 Hold | 批准 Pairing 后重新发送 |
| 无法读取文件 | 检查文件 Scope、Private Download 权限与媒体大小上限 |
通用 Access Grant 管理见 消息平台。