> ## 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.

# 设置向导

> 使用本地 Web UI 配置常驻工作台、可选的聊天平台、Agent 后端和项目路由。

# 设置向导

运行：

```bash theme={null}
vibe
```

Avibe 会启动本地 Web UI 并打开设置向导。

## 你会配置什么

向导会带你完成：

* Avibe Workbench —— 常驻的本地 Web 聊天界面（无需任何配置）。
* 可选的聊天平台 —— Slack、Discord、Telegram、微信，或 Lark / 飞书。
* Agent 后端及其模型供应商。
* Agent CLI 路径和默认工作目录。
* Avibe 应该响应的 channel 或 chat。
* 所选配置的健康检查。

走完向导——或中途跳过——都会把设置标记为完成，下次启动就不会再被带回向导。所有内容之后都能在「设置」里修改。

## Avibe Workbench 始终可用

你不需要任何第三方聊天 App 就能使用 Avibe。**Avibe Workbench** 是内置在本地 Web UI 里的 Web 聊天界面，始终启用——它是唯一一个你无法关闭的界面。接入 Slack、Discord 等都是可选的、叠加式的。

在手机上，打开 Workbench 的 URL，用浏览器的**添加到主屏幕**（Add to Home Screen）就能把它装成一个 App。

<Note>
  只用工作台也是一套完整的设置。你可以在不接入任何聊天平台的情况下走完向导，之后想用时再添加平台。
</Note>

## 聊天平台（可选）

接入你本来就在工作的聊天 App。你启用的每个平台都会在向导里有自己的凭证步骤；你也可以全部跳过，之后在「设置」里再添加。

| 平台        | 适合                               |
| --------- | -------------------------------- |
| Slack     | 团队工作流、thread、Socket Mode、成熟的交互能力 |
| Discord   | 社区和个人服务器                         |
| Telegram  | 轻量的个人 bot 和群组 bot                |
| 微信        | 中国场景下的移动优先工作流                    |
| Lark / 飞书 | 中国/亚洲工作区和企业聊天                    |

## Agent 后端

启用一个或多个后端。向导会自动检测已安装的 CLI、对缺失的提供一键安装，并为每个后端提供一个**配置模型供应商**按钮——和你之后在「设置」里看到的供应商配置是同一套，不用重复配置。

| 后端          | 适合           |
| ----------- | ------------ |
| Claude Code | 深度推理和复杂代码库工作 |
| OpenCode    | 快速本地设置和可扩展性  |
| Codex       | OpenAI 编码工作流 |

你可以启用多个后端，并把不同 channel 路由到不同 Agent。

## 优先使用向导，而不是手改配置

Avibe 会把持久化配置存到你的本地用户目录。调试时可以检查配置文件，但首次设置应该走向导，因为向导会验证凭证和平台状态。