Chatbot UI作为当前最热门的开源AI对话工具之一，支持与OpenAI、Claude、本地大模型等多种AI服务集成，本文提供保姆级教程，涵盖部署到高阶功能全流程。

项目特点

1. 开源且免费：任何人士皆可运用并为该项目作出贡献。
2. 易于部署：已提供详尽的本地及云端部署指南。
3. 持续更新：开发者始终致力于改进部署流程、后端兼容性以及移动端布局等诸方面。
4. 官方托管版本：用户能够直接运用官方托管的 Chatbot UI，无需自行进行部署。

Chatbot UI功能特征：

• 具备聊天功能，涵盖图像及文件功能。
• 可使用 OpenAI 嵌入或本地嵌入。
• 设有详细的聊天设置。
  创建用于快速选择的聊天设置预设。
• 支持使用/命令的提示。
• 支持使用@命令的文件。
• 支持使用@命令的文件集合（集合）。
• 助手（诸如角色/GPTs，相关工具正在开发当中）。
• 实现所有功能的导入/导出。
• 具备分享功能。
• 拥有认证系统。
• 具有带有个人档案背景的个人资料。
• 设有带有自定义指令的工作区。
• 支持本地运行或部署托管。
• 集成图像/文件存储。

一、环境准备与部署（10分钟完成）

1. 基础要求操作系统：Windows/macOS/Linux均可硬件配置：4GB内存+支持Docker的环境（本地模型需更高配置）
2. 快速部署方案云端托管：访问ChatbotUI官网 直接使用（需OpenAI API密钥）本地部署（推荐开发者）：

# 克隆代码库 
git clone https://github.com/mckaywrigley/chatbot-ui 
# 安装依赖 
npm install 
# 启动服务 
npm run dev

访问http://localhost:3000即可进入

二、核心功能详解（附实战截图）

对话管理

1. 新建对话：点击左侧栏「+ New Chat」创建独立会话
2. 历史存档：支持导出/导入JSON格式对话记录（企业知识库构建利器）

模型切换
在设置页可切换80+AI模型，包括：

1. OpenAI GPT-4/GPT-3.5
2. Claude 3
3. 本地部署的Ollama/LLaMA模型
   示例代码（配置本地模型）：

OPENAI_API_KEY=sk-xxx OPENAI_API_HOST=http://localhost:11434

1. 高级交互技巧
2. 指令触发：输入/调出预设指令模板（如写邮件、生成代码）
3. 文件解析：通过@文件上传PDF/TXT，实现文档问答
4. 角色扮演：在「Assistants」中设置系统提示词（例：模拟客服专家语气）

三、企业级应用场景

1. 智能客服系统接入企业知识库（参考Chatbot_CN 的NLU模块）设置「工单分类」等自动化流程
2. 多模态内容生产图文生成：输入/draw 描述调用DALL·E生成图片数据可视化：结合@数据表实现动态图表
3. 私有化部署方案通过Docker Compose整合LocalAI服务配置Nginx反向代理实现HTTPS加密

四、常见问题排查

• 模型无响应：检查API密钥有效性，或尝试降低「生成温度」参数4
• 中文输出异常：在settings.yaml 中增加本地化配置：

language: zh-CN tokenizer: jieba

下载地址：https://github.com/mckaywrigley/chatbot-ui/

体验地址：https://www.chatbotui.com/