把 AI Agent 部署到
你自己的服务器上
配置一次,全团队通过 飞书 / QQ / 浏览器 / 终端 与同一个 Agent 对话。 它能调用工具、读写文件、跑命令、委派子 Agent —— 数据始终不出你的服务器。
帮我在这台机器上安装并启动 xbot:
curl -fsSL https://raw.githubusercontent.com/ai-pivot/xbot/master/scripts/install.sh | bash 
真实会话:多轮对话 · 工具调用(Grep / FileReplace / Shell)· 逐迭代思考过程 · 多会话并行
为什么选 xbot?
大多数 AI 编程 Agent 只活在终端里。xbot 不一样 —— 一个 Agent,全渠道。
| xbot | Codex / Claude Code / OpenCode | |
|---|---|---|
| 多渠道 | 飞书 · QQ · Web · CLI | 仅终端 |
| 团队共享 LLM | 管理员配一次,所有人用 | 各自配置 API Key |
| 自托管 | ✓ 数据不出服务器 | ✓ |
| 飞书集成 | 文档、多维表格、云盘、卡片 | — |
| 子 Agent + 群聊 | 委派、并行、辩论 | 仅子 Agent |
| 插件系统 | 工具、hooks、widget、渠道插件 | 有限 |
Important最常见场景:部署 Server 模式 → 连接飞书应用 → 全团队在群里 @机器人对话,无需各自配置 API Key。
核心特性
开箱即用的 Agent 能力,以及为生产部署准备的工程细节。
Shell、文件读写、网页搜索、定时任务、子 Agent 委派,逐迭代可见思考与工具结果。
同一个 Agent,飞书 / QQ / 终端 / 浏览器不同入口,会话与上下文互不串扰。
管理员配置一次,全团队直接使用;支持多订阅、按模型切换与上下文配额。
鼠标交互、命令面板 (Ctrl+K)、多会话侧边栏、主题系统。
一条命令安装,数据不出你的服务器;SQLite 单文件存储,备份即拷贝。
Skills、SubAgents、MCP 协议、插件系统(工具 / hooks / widget / 渠道)。
Agent 可通过 config 与 tui_control 工具自行调整配置和界面。
插件可产出可分享的面板,生成公开链接(仅主动分享的内容才有 token)。
我该用哪个渠道
同一个 Agent 内核,四种接入方式,按你的场景挑一个即可。
开发者与终端用户:全功能 TUI,流式输出,工具调用。
团队协作:群里 @机器人 对话,支持消息卡片与文档集成。
任何有浏览器的人:注册 / 登录,邀请制,移动端自适应。
个人或小圈子: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 负责实际执行。
tools/
memory/
skills/
plugins/阅读完整 架构概览。
社区
遇到问题、想要新功能,或者只是想聊聊。