安装指南

# Linux / macOS (amd64, arm64)
curl -fsSL https://raw.githubusercontent.com/ai-pivot/xbot/master/scripts/install.sh | bash

# Windows (PowerShell)
irm https://raw.githubusercontent.com/ai-pivot/xbot/master/scripts/install.ps1 | iex

指定版本或安装路径：

VERSION=v0.0.48 curl -fsSL ... | bash          # 指定版本
INSTALL_PATH=~/.local/bin curl -fsSL ... | bash  # 自定义安装路径

git clone https://github.com/ai-pivot/xbot.git && cd xbot
make build          # 构建 xbot (server + runner)
make run            # 构建并运行 server

安装器会让你选择 Standalone 或 Server 模式。

CLI 直接在本地运行 Agent，不依赖后台服务。

• ✅ 简单，安装即用
• ✅ 无后台进程
• ❌ 关终端就停
• ❌ 仅 CLI 渠道，不支持飞书/QQ/Web
• ❌ 不能团队共享 LLM

适合：个人开发者快速体验。

后台运行一个 Server 进程，CLI 通过 WebSocket 远程连接。同时启用飞书/QQ/Web 等渠道。

• ✅ Agent 常驻运行，开机自启
• ✅ 支持飞书/QQ/Web 多渠道同时接入
• ✅ Web 浏览器聊天界面
• ✅ 管理员配置 LLM Key，全团队共享使用
• ✅ 多个 CLI 客户端可同时连接

适合：团队使用、需要飞书/QQ 接入、需要 Web 界面的场景。

💡 大多数团队应选 Server 模式。

安装器会自动配置系统服务（无需 sudo）：

Server 启动命令：xbot-cli serve

1. 下载 xbot-cli 二进制到 ~/.local/bin/（或你指定的路径）
2. 生成随机 admin token
3. 写入/更新 ~/.xbot/config.json
4. Server 模式额外：安装系统服务 + 下载 Web UI

安装完成后运行：

xbot-cli

首次运行会自动弹出 Setup 向导，引导你配置：

LLM 订阅配置

1. 选择 LLM 提供商（OpenAI / Anthropic / 自定义兼容 API）
2. 输入 API Key（必填）
3. 输入 API 地址（默认 https://api.openai.com/v1，使用兼容服务时修改）
4. 选择模型
5. 配置模型层（Vanguard / Balance / Swift，可按不同场景选用不同模型）
6. Tavily 搜索 Key（可选，不填则无法使用网页搜索）

环境配置

• 沙箱模式（默认 none，Docker 用户选 docker）
• 记忆模式（默认 flat）

外观

• 配色方案（9 种可选）

配置完成后即可开始对话。随时可用 /setup 命令或 Ctrl+K → Setup 重新配置。

配置文件位于 ~/.xbot/config.json，也可以直接编辑。详见 配置参考。

最小配置（Standalone 模式）：

{
  "subscriptions": [
    {
      "name": "default",
      "provider": "openai",
      "api_key": "sk-xxx",
      "model": "gpt-4o"
    }
  ]
}

使用 DeepSeek 等兼容 API：

{
  "subscriptions": [
    {
      "name": "DeepSeek",
      "provider": "openai",
      "api_key": "your-key",
      "base_url": "https://api.deepseek.com/v1",
      "model": "deepseek-chat"
    }
  ]
}

# 查看版本
xbot-cli --version

# Server 模式检查服务状态
# Linux:
systemctl --user status xbot-server
# macOS:
launchctl list | grep xbot

Tip

快速健康检查： 运行 xbot-cli 并输入"你好"。如果 Agent 回复了，说明一切正常。

• 快速开始 — 5 分钟快速上手
• 配置参考 — config.json 全字段
• 渠道 — 飞书、QQ、Web、CLI 配置