Skip to main content

​
常见问题

​
vibe 命令找不到

检查安装脚本是否打印了 PATH 指引。 然后检查：
如果是通过 uv tool 安装，tool bin 目录可能还没有加载到当前 shell。

​
Agent CLI 找不到

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

​
聊天 bot 沉默

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

​
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 只在同一台机器上可用。 使用：
这会通过安全 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。见反向代理与自定义域名。