Skip to main content
xbot
自托管 · 一个 Agent,全渠道

把 AI Agent 部署到
你自己的服务器上

配置一次,全团队通过 飞书 / QQ / 浏览器 / 终端 与同一个 Agent 对话。 它能调用工具、读写文件、跑命令、委派子 Agent —— 数据始终不出你的服务器。

把以下指令发给你的 Agent Claude Code · Codex · Cursor …
帮我在这台机器上安装并启动 xbot:
curl -fsSL https://raw.githubusercontent.com/ai-pivot/xbot/master/scripts/install.sh | bash
一条命令装好 Web UI + 全部内置插件 · 其他安装方式
xbot Web 界面:多会话侧边栏、工具调用与迭代进度

真实会话:多轮对话 · 工具调用(Grep / FileReplace / Shell)· 逐迭代思考过程 · 多会话并行

为什么选 xbot?

大多数 AI 编程 Agent 只活在终端里。xbot 不一样 —— 一个 Agent,全渠道。

xbotCodex / Claude Code / OpenCode
多渠道飞书 · QQ · Web · CLI仅终端
团队共享 LLM管理员配一次,所有人用各自配置 API Key
自托管 数据不出服务器
飞书集成文档、多维表格、云盘、卡片
子 Agent + 群聊委派、并行、辩论仅子 Agent
插件系统工具、hooks、widget、渠道插件有限
Important
最常见场景:部署 Server 模式 → 连接飞书应用 → 全团队在群里 @机器人对话,无需各自配置 API Key。

核心特性

开箱即用的 Agent 能力,以及为生产部署准备的工程细节。

多轮对话 + 工具调用

Shell、文件读写、网页搜索、定时任务、子 Agent 委派,逐迭代可见思考与工具结果。

多渠道接入

同一个 Agent,飞书 / QQ / 终端 / 浏览器不同入口,会话与上下文互不串扰。

团队共享 LLM 订阅

管理员配置一次,全团队直接使用;支持多订阅、按模型切换与上下文配额。

全功能 TUI

鼠标交互、命令面板 (Ctrl+K)、多会话侧边栏、主题系统。

完全自托管

一条命令安装,数据不出你的服务器;SQLite 单文件存储,备份即拷贝。

可扩展

Skills、SubAgents、MCP 协议、插件系统(工具 / hooks / widget / 渠道)。

AI-Native 配置

Agent 可通过 configtui_control 工具自行调整配置和界面。

插件分享能力

插件可产出可分享的面板,生成公开链接(仅主动分享的内容才有 token)。

我该用哪个渠道

同一个 Agent 内核,四种接入方式,按你的场景挑一个即可。

CLI

开发者与终端用户:全功能 TUI,流式输出,工具调用。

飞书

团队协作:群里 @机器人 对话,支持消息卡片与文档集成。

Web

任何有浏览器的人:注册 / 登录,邀请制,移动端自适应。

QQ

个人或小圈子:QQ 聊天窗口交互(via NapCat)。

其他安装方式

Windows:irm https://raw.githubusercontent.com/ai-pivot/xbot/master/scripts/install.ps1 | iex  ·  中国大陆走镜像:curl -fsSL https://ghfast.top/https://raw.githubusercontent.com/ai-pivot/xbot/master/scripts/install-cn.sh | bash

装完打开 http://localhost:8082 → 注册账号 → 齿轮 → LLM → 填 Base URL / API Key / 选模型 → 开聊。 可选参数(默认值通常就是你要的)与全部配置项 → 安装与配置

给 AI agent 的可执行安装手册(每步有断言、含无头配 LLM 与排错表)→ Agent 安装手册。 安装脚本跑完会把这份文档的地址打出来,所以把上面那段指令发给 agent 之后,它会自己知道下一步读什么。

架构

Backend 是纯 RPC 客户端接口(零业务逻辑),Transport 负责实际执行。

飞书 · QQ · Web · CLI channels
Dispatcher channel/
Agent Loop agent/ · Transport
LLM llm/
Agent Loop 调用 → tools/ memory/ skills/ plugins/

阅读完整 架构概览

社区

遇到问题、想要新功能,或者只是想聊聊。