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

# 常见问题

> 修复常见 Avibe 安装、平台和 Agent 设置问题。

# 常见问题

## `vibe` 命令找不到

检查安装脚本是否打印了 PATH 指引。

然后检查：

```bash theme={null}
command -v vibe || true
echo "$PATH"
```

如果是通过 `uv tool` 安装，tool bin 目录可能还没有加载到当前 shell。

## Agent CLI 找不到

验证所选后端：

```bash theme={null}
command -v claude || true
command -v opencode || true
command -v codex || true
```

安装缺失的后端，或在设置向导里更新 CLI 路径。

## 聊天 bot 沉默

检查：

* 平台凭证是否正确。
* bot 或 app 是否已安装到 workspace/server/group。
* channel 或 chat 是否已在 Avibe 中启用。
* 所选后端是否已启用。
* 工作目录是否存在。

然后运行：

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

## Slack bot 沉默

检查：

* Socket Mode 是否启用。
* Bot token scopes 是否正确。
* App-level token 是否正确。
* Bot 是否被邀请到 channel。
* Channel 是否在 Avibe 中被选中。

## Telegram 群组沉默

检查：

* Bot privacy mode。
* Bot 是否需要被 mention。
* 群组是否出现在 discovered chats。
* 群组是否在 Avibe 中被选中。

## 另一台设备无法访问 Web UI

Localhost 只在同一台机器上可用。

使用：

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

这会通过安全 avibe.bot tunnel 打开本地 Web UI。

## 自定义域名返回 503 或 403

如果你用自己的反向代理在自定义域名上承载 Web UI,而页面返回 `503`(或某个状态变更操作返回 `403 invalid origin`),那是因为 Avibe 还没被告知要信任这个域名。

**同时**声明 `VIBE_UI_TRUSTED_PROXY_IPS`(你的代理 IP)和 `VIBE_UI_TRUSTED_PUBLIC_ORIGINS`(如 `https://avibe.example.com`),并转发 host 相关的头 —— 只设代理 IP 仍会 `503`。见[反向代理与自定义域名](/zh/self-hosting/reverse-proxy)。