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

# Slack

> 把 Slack 变成你 Avibe 上本地 agent 的协作空间。

# Slack

Slack 是目前 Avibe 最成熟的入口——支持 thread、Socket Mode、按钮、模态框和丰富的交互模式。

## 你会得到什么

* mention bot 来启动一个任务。
* 在 thread 里继续——每个 thread 是一个隔离、可恢复的会话。
* 不打开终端也能批准交互式提问（按钮、模态框）。
* 接收完成通知。

## 创建 app

向导帮你把重活干了。在 Avibe 设置向导里选择 **Slack**：

1. 点 **Create Slack App**——Slack 打开时清单（manifest）已预填好（名称、scopes、事件、Socket Mode 全配好）。
2. 选你的 workspace，点 **Create**，把 app 安装到 workspace。
3. 跟着折叠步骤复制 **Bot token**（`xoxb-…`）和 **App-level token**（`xapp-…`）。
4. 点 **Validate Tokens**，然后完成并启动服务。

<details>
  <summary><b>这个 app 需要什么（手动设置时）</b></summary>

  如果你想在 [api.slack.com/apps](https://api.slack.com/apps) 手动建：

  * **启用 Socket Mode**——Avibe 通过 Socket Mode 主动外连，所以没有任何公网入站 webhook。
  * 一个带 **`connections:write`** scope 的 **app-level token**（`xapp-…`）。
  * 一个 **bot token**（`xoxb-…`），带消息、mention、文件、reaction 相关 scopes：`app_mentions:read`、`channels:history` / `channels:read`、`groups:history` / `groups:read`、`im:history` / `im:read` / `im:write`、`mpim:history` / `mpim:read` / `mpim:write`、`chat:write`、`users:read`、`commands`、`files:read` / `files:write`、`reactions:read` / `reactions:write`。
  * **事件订阅**：`app_mention`、各 `message.*` 事件、`reaction_added` / `reaction_removed`；并启用 **Interactivity**。

  **Create Slack App** 按钮会把这些全部以 manifest 预填好，所以手动设置只是给想了解的人看的。
</details>

## 在 Slack 里用

* 把 bot 邀请进 channel：`/invite @Avibe`。
* **mention bot** 开始；**在 thread 里回复** 继续同一个会话。
* 想在 **私信** 里用，发 `bind <code>`，code 在 Web UI 里。
* 想指定某个 agent，消息前加前缀：`AgentName: 做这件事`。

## 冒烟测试

向导显示 Slack 连接健康后，在启用的 channel 里 mention bot：

```text theme={null}
@Avibe say hello and tell me which project directory you are running in
```

在 thread 里回复以继续同一个 agent 会话。

## 出站代理

当运行 Avibe 的机器无法直接访问 Slack 时，可在 Web UI 中给 Slack 配置块设置 `proxy_url`。支持 HTTP/HTTPS 代理，以及任意 `socks*://` 协议的 SOCKS 代理（`socks4`、`socks4a`、`socks5`、`socks5h`）。保存配置块只会持久化变更；之后执行 `vibe restart --delay-seconds 60`，让新的传输方式应用到正在运行的连接上。

## 常见问题

| 症状              | 检查                                                             |
| --------------- | -------------------------------------------------------------- |
| Bot 不回复         | Bot 是否被邀请进 channel，channel 是否已启用                               |
| Socket Mode 失败  | App-level token 是否带 `connections:write` scope，Socket Mode 是否启用 |
| 事件到了但 agent 没启动 | 所选后端 CLI 是否在 PATH 上                                            |
| Thread 上下文丢失    | 是否在同一个 thread 里回复，而不是新发顶层消息                                    |
| 机器无法访问 Slack    | Slack 配置上的 `proxy_url`；查看日志中的防火墙或 TLS 错误                       |