xbot — 自托管 AI Agent，接入你的飞书 / QQ / 终端 / 浏览器
你想让 AI 帮团队做事——写代码、查文档、跑命令、操作飞书表格——但又不想把数据交给第三方 SaaS。xbot 让你在自己的服务器上部署一个全功能 AI Agent，通过飞书/QQ/终端/浏览器与它对话，它能调用工具完成实际工作。
核心能力：
- 🧠 多轮对话 + 工具调用（Shell、文件读写、网页搜索、定时任务…）
- 📱 多渠道接入（飞书、QQ、终端 TUI、Web 浏览器）——同一套 Agent，不同入口
- 🔑 团队共享 LLM Key（管理员配置一次，所有人直接用）
- 🧩 可扩展（Skills、SubAgents、MCP 协议）
- 🏠 完全自托管，数据不出你的服务器
| 渠道 | 适合谁 | 特点 |
|---|---|---|
| CLI | 开发者、终端重度用户 | 全功能 TUI，支持流式输出、工具调用、SubAgent |
| 飞书 | 团队协作 | 在群里 @机器人 即可对话，支持消息卡片交互 |
| QQ / NapCat | 个人或小圈子 | 通过 QQ 聊天窗口与 Agent 交互 |
| Web | 任何有浏览器的人 | 网页聊天界面，支持注册/登录和邀请制 |
💡 飞书场景最常见：部署 server 模式 → 配置飞书应用 → 全团队在飞书群里 @机器人对话，无需各自配置 API Key。
安装器会问你选哪种模式（区别见下文）：
# Linux / macOS
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.24 curl -fsSL ... | bash # 指定版本
INSTALL_PATH=~/.local/bin curl -fsSL ... | bash # 自定义路径安装器会让你选择：
| Standalone（单机） | Server（服务端） | |
|---|---|---|
| 架构 | CLI 直接运行 Agent | 后台 Server + CLI 远程连接 |
| 适合 | 个人使用 | 团队使用、多渠道接入 |
| 多渠道 | ❌ 仅 CLI | ✅ 飞书/QQ/Web 同时启用 |
| Web UI | ❌ | ✅ 浏览器聊天界面 |
| LLM 共享 | 各自配置 | 管理员配一次，全团队用 |
| 后台运行 | 关终端就停 | 系统服务，开机自启 |
大多数团队应选 Server 模式。 个人开发者想快速体验可选 Standalone。
安装完成后直接运行：
xbot-cli首次运行会自动弹出 Setup 向导，引导你配置：
- LLM 提供商（OpenAI / Anthropic）
- API Key（必填）
- API 地址（用 OpenAI 兼容服务时修改，如 DeepSeek、Qwen）
- 模型名称
- 沙箱模式和记忆模式
⚠️ Setup 向导中的输入框：选中输入框后，需要先按 Enter 进入编辑模式，然后才能输入内容。输入完毕后再按 Enter 确认。
也可以随时用 /setup 命令重新配置。
配置文件位于 ~/.xbot/config.json，也可以手动编辑：
OpenAI 或兼容 API（DeepSeek、Qwen、Ollama 等）：
{
"llm": {
"provider": "openai",
"api_key": "sk-xxx",
"base_url": "https://api.openai.com/v1",
"model": "gpt-4o"
}
}Anthropic：
{
"llm": {
"provider": "anthropic",
"api_key": "sk-ant-xxx",
"model": "claude-sonnet-4-20250514"
}
}使用 DeepSeek：
{
"llm": {
"provider": "openai",
"api_key": "your-deepseek-key",
"base_url": "https://api.deepseek.com/v1",
"model": "deepseek-chat"
}
}每个渠道通过 ~/.xbot/config.json 启用，无需环境变量。
在 飞书开放平台 创建应用后：
{
"feishu": {
"enabled": true,
"app_id": "cli_xxx",
"app_secret": "xxx"
}
}最小必需的应用权限：im:message、im:message.receive_v1、im:message:send_as_bot、contact:user.base:readonly
详见 飞书配置指南。
详见各渠道的配置指南：Channels
git clone https://github.com/ai-pivot/xbot.git && cd xbot
make build # 构建 xbot (server + runner)
make run # 构建并运行 server仅构建 CLI：
go build -o xbot-cli ./cmd/xbot-cliAgent 在对话中可以调用这些工具：
- Shell — 在沙箱中执行命令（支持 Docker / 远程 / 无沙箱）
- 文件操作 — 读写文件、搜索内容、Glob 匹配
- 网页 — 抓取网页内容、Tavily 搜索
- 上下文 — 编辑对话上下文（裁剪/替换/删除）
- SubAgent — 委派任务给专门化的子 Agent
- 定时任务 — Cron 表达式或一次性定时
- 下载 — 从 URL 下载文件
- 飞书工具 — 操作飞书文档、多维表格、云盘
- Runner — 管理远程沙箱连接
| Flat（默认） | Letta (MemGPT) | |
|---|---|---|
| 核心记忆 | 内存块 | SQLite（始终在上下文中） |
| 归档记忆 | Grep 搜索 | 向量搜索 |
| 依赖 | 无 | 需要嵌入模型 |
- Skills — Markdown 定义的能力包，放在
~/.xbot/skills/ - SubAgents — 基于角色的子 Agent（探索、代码审查等），自定义角色放
~/.xbot/agents/
支持全局和会话级 MCP Server，stdio 和 HTTP 传输。
┌──────────┐ ┌──────────────┐ ┌────────┐ ┌──────────┐
│ 飞书 │────▶│ Dispatcher │────▶│ Agent │────▶│ LLM │
│ QQ │◀────│ (channel/) │◀────│ (agent/)│◀────│ (llm/) │
│ NapCat │ └──────────────┘ │ │ └──────────┘
│ Web │ │ │
│ CLI │ │ │────▶ 工具
└──────────┘ │ │ (tools/)
│ │
│ │────▶ 记忆
│ │ (memory/)
└────────┘
完整文档：cjiw.github.io/xbot
| 文档 | 说明 |
|---|---|
| 安装指南 | 两种模式详解、Setup 向导 |
| 渠道配置 | 飞书 / QQ / NapCat / Web / CLI |
| 配置参考 | config.json 完整字段说明 |
| 沙箱指南 | Docker / 远程沙箱配置 |
| 架构 | 系统设计和数据流 |
| CHANGELOG | 版本历史 |
MIT