跳转到主要内容

​
AI Agent 安装指南

本页面写给正在帮助人类安装 Avibe 的 AI 编码 Agent。

​
规则

  • 在选择聊天平台、Agent 后端、workspace 或凭证值之前先问用户。
  • 不要猜测 secret、bot token、app token、API key、workspace ID 或 chat ID。
  • 优先使用 vibe 启动的浏览器设置向导，不要手改配置文件。
  • 除非用户确认安全，否则不要重启已经在运行的本地 vibe 服务。
  • 保持本地优先。除非所选平台要求，不要暴露公开 webhook。

​
1. 检查机器

在 Windows 上，除非用户明确想使用原生 PowerShell，否则优先使用 WSL。

​
2. 安装 Avibe

macOS / Linux：
开源脚本，源码在 GitHub 上；该短链只是到这个文件的 307 重定向。 Windows PowerShell：
验证：

​
3. 可选：安装一个编码 CLI

新安装且开启了 Model Hub（默认开启）的 Avibe，新对话默认交给内置 Agent Vibey。Vibey 本身不需要安装：Model Hub 里有了模型来源、Vibey 有了型号，它就能运行。如果用户想先只用 Vibey，可以跳过这一步；Claude Code、Codex 或 OpenCode 会和 Vibey 并行运行，之后也可以在 Agents 页把其中一个设为默认。 否则，先问用户想先使用哪个 CLI Agent。推荐默认：
  • OpenCode 适合低摩擦设置。
  • Claude Code 适合更深入的代码库工作。
  • Codex 适合 OpenAI 工作流。
OpenCode：
Claude Code：
Codex：
验证：

​
4. 启动设置向导

带用户走完向导：
  1. 添加模型供应商：由用户自己用订阅登录或填入 API Key。
  2. 选择你的 AI 助手：给 Vibey 选一个型号，或启用一个已安装的 CLI Agent。
  3. 进入工作台。
  4. 问用户要在哪个项目里工作，然后在 Workbench 里用打开项目打开它，并在那里开一个会话。
聊天平台以及应该启用的 channel 或 chat 范围，之后在设置 > 通讯平台里配置。如果要在聊天 channel 里做冒烟测试，先在群组里启用这个 channel，并把它的工作目录设为用户的项目。

​
5. 可选远程 Web UI

如果用户想从另一台设备打开本地 Web UI：
把它用于 Web UI 访问，不要用于直接暴露 Agent runtime。

​
6. 冒烟测试

让用户发送：
然后验证：
如果消息没有到达：