1.1 LangBot 核心功能
多平台支持：
无缝集成到多种主流即时通信平台，如 QQ、微信（包括企业微信和个人微信）、飞书、Discord 等。
多模态交互：
支持文本、语音、图片等多种输入输出形式，处理复杂的交互任务，如图片识别和语音识别，为用户提供更丰富的互动体验。
多模型适配：
支持接入多种主流的大语言模型（LLM），如 OpenAI 的 ChatGPT、DeepSeek、Claude、Gemini、Ollama 等，用户可以根据需求选择合适的模型进行对话任务。
高稳定性：
内置访问控制、限速和敏感词过滤等机制，确保机器人稳定运行，避免滥用和不当内容传播。
插件扩展：
支持强大的插件系统，用户可以根据业务需求定制功能模块，拓展机器人的能力。
Web 管理面板：
提供直观的 Web 管理面板，方便用户配置和管理机器人实例，无需频繁编辑配置文件，即可快速调试和优化机器人。
1.2 LangBot 核心技术
即时通信平台的 API 集成：
基于调用各个即时通信平台提供的 API 接口，实现与用户的交互。
大语言模型（LLM）的集成：
LangBot 支持多种主流的大语言模型，模型提供强大的自然语言处理能力。
LangBot 将用户的输入发送到选定的 LLM，将模型生成的响应返回给用户。
事件驱动和插件机制：
基于事件驱动架构，根据不同的事件（如消息接收、用户操作等）触发相应的处理逻辑。
LangBot 支持插件扩展WhatsApp网页版，开发者可以基于编写插件扩展机器人的功能，例如添加数据分析、内容创作辅助等功能。
安全和管理机制：
内置访问控制、限速和敏感词过滤等安全机制，确保机器人的稳定运行和内容安全。
访问控制机制限制只有授权的用户才能与机器人交互；
限速机制防止过多的请求导致系统过载；敏感词过滤机制避免不当内容的传播。
二、LangBot 基础安装2.1 环境准备2.2 安装 LangBot前往Release页面下载最新版本的压缩包（推荐）langbot-xxx-all.zip（请勿下载 Source Code，因为其中不包含 WebUI）。解压，在解压目录打开命令行（终端）
安装依赖
pip install uv -i https://pypi.tuna.tsinghua.edu.cn/simple
uv sync运行一次主程序，生成配置文件
uv run main.py出现如下提示即可
_ ___ _
| | __ _ _ _ __ _| _ ) ___| |_
| |__/ _` | ' \/ _` | _ \/ _ \ _|
|____\__,_|_||_\__, |___/\___/\__|
|___/
️开源地址: https://github.com/RockChinQ/LangBot
文档地址: https://docs.langbot.app
以下文件不存在，已自动生成，请按需修改配置文件后重启：
- plugins/__init__.py
...LangBot 在每次启动时会检查所有插件的依赖以便确保所有插件都能正常运行。
如果由于网络问题导致 LangBot 无法正常检查依赖，可以提供--skip-plugin-deps-check参数跳过检查，并自行安装插件依赖：命令行切换目录到plugins目录下的每个子文件夹（若已安装插件），然后使用uv sync安装依赖。
2.3 配置机器人
机器人用于从消息平台接收消息事件并调用流水线处理消息。
LangBot 支持以下多种机器人，本文以 QQ 机器人为例：
2.4 注册 QQ 机器人（测试机器人）
前往 ，找到下方的 应用管理 ，点击创建机器人，填写基本信息之后，进入机器人页面，如图：
首页 选项中的 发布流程 即为上线机器人的步骤。由于部署的是测试版机器人，所以只需要进行其中的 资料 和 沙箱配置 。
先进行资料填写，然后点击沙箱配置。
配置沙箱配置项
点击 沙箱配置 。 如果要部署在QQ群中，那么按照 QQ群ID 下方的要求进行选择群聊，在消息列表配置中添加有私聊权限的用户。
如果要部署在QQ频道中，那么按照 频道ID 下方的要求选择频道ID，机器人类型为0。
配置开发管理项
点击 开发管理
记录其中的 AppID , Token , AppSecret ,并将 LangBot 所在服务器的IP地址填写到IP白名单中。
2.5 对接 LangBot
打开 LangBot 配置页面，点击机器人，点击添加 平台/适配器选择为OneBot v11
2.6 配置回调地址
由于QQ官方机器人必须要求回调地址是 https 请求，但 LangBot 仅提供 http 方式WhatsApp网页版，所以需要自行配置反向代理。
本文建议使用 Caddy 反向代理，操作流程如下:
安装caddy
进入Caddy安装文档。选择对应自己操作系统的安装步骤，进行安装。
填写Caddyfile
本文假设使用 ubuntu 系统部署 LangBot ，那么在系统中WhatsApp网页版，Caddyfile 的默认位置为 /etc/caddy/Caddyfile。 使用 vim 或 nano 编辑 Caddyfile ，Caddyfile文件填写为：
your_domain_name {
reverse_proxy 127.0.0.1:2284
}例如，如果你有域名 testlb.com，并且解析地址为本机，同时开启443端口，那么填写为：
testlb.com {
reverse_proxy 127.0.0.1:2284
}保存并且退出文件。
Caddyfile文件的填写要求非常严苛，请按照正确的格式填写，如果遇到问题请自行查询Caddy文档或者询问AI。
启动caddy
sudo systemctl start caddy成功启动后，检查 Caddy 状态命令：
sudo systemctl status caddy