跳转到主要内容
在日常学习、工作中,聊天机器人可协同用户进行定时提醒、问答、整理文件等,提升效率。 LangBot 是一个开源即时通信机器人平台,支持接入飞书、钉钉、QQ 等消息平台,用户可直接在平台内处理任务。 借助 PPIO 的模型 API 服务,LangBot 可接入 DeepSeek、Qwen 等主流模型,用户按需选择以适配不同场景。以下为完整配置教程。

PPIO × LangBot配置教程

获取 API key

1

获取 API 密钥

注册并登录 PPIO。打开 API 密钥管理页面,点击创建按钮,输入自定义密钥名称,生成 API 密钥。20250613-145217.jpeg
2

生成并保存 API 密钥

注意:密钥在服务端加密存储,请在生成时保存好密钥;若遗失,可在控制台删除并创建一个新的密钥。20250613-145225.jpeg
3

获取模型 ID

推荐使用的模型 ID
  • deepseek/deepseek-v4-pro
  • deepseek/deepseek-v4.1-flash
  • qwen/qwen3.8-max
  • zai-org/glm-5.3
其他模型 ID、最大上下文及价格可参考:模型列表

部署并配置 LangBot

通过 Docker 可将 LangBot 部署到 Windows、macOS、Linux 上。 部署前,请确保已安装 Git、Docker。 项目地址:https://github.com/RockChinQ/LangBot
1

通过 Docker 部署 LangBot

Git 克隆本项目:
启动容器:
如果主机位于中国大陆,可将 docker-compose.yaml 文件中的镜像名称改为 docker.langbot.app/langbot-public/rockchin/langbot:latest,以使用 LangBot 提供的镜像源。
2

创建配置文件

首次启动会输出创建配置文件的提示,请按照生成的配置文件继续配置。容器会映射 5300 端口供 WebUI 使用,可访问 http://127.0.0.1:5300 查看 WebUI;还会映射 2280-2290 端口,供使用 OneBot 协议的消息平台适配器反向连接。
3

配置对话模型

打开 LangBot,点击模型配置,模型提供商选择派欧云。5a3035cd-2c5d-44f4-9da6-411d7a5c5028.jpgdownload.jpg按以下信息配置模型。
  • 模型名称:从 PPIO 官网复制的所需模型名称
  • 模型提供商:派欧云
  • 请求 URL:固定为 https://api.ppio.com/openai
  • API Key:从派欧云官网保存的密钥
e709b012-c8ad-4f13-b989-ebfdff5711aa.jpg

接入平台

LangBot 支持将聊天机器人接入 QQ、微信公众平台、飞书等平台。以钉钉为例,接入教程如下。

创建机器人

1

进入开发者后台

进入 钉钉开发者后台,登录并进入组织。地址:https://open-dev.dingtalk.com/cd68ddcf-f538-46a4-963b-7b970c82ad29.jpg
2

创建应用

点击上方的 应用开发,选择 创建应用,填写机器人的基本信息并保存。4838716d-c88b-4b9c-a2ff-b0d5cf7d132a.jpg
3

添加机器人能力

选择「添加应用能力」为应用添加机器人能力。21a22730-ee41-4f2f-9cd3-bd464d133ca2.jpg

配置机器人

1

填写机器人信息并发布

点击左侧「机器人」选项卡,填写机器人配置信息,完成名称、简介、消息名称等基础配置,配置完成后点击发布。9de0f769-abff-4aca-b903-5e73527fac60.jpg
2

配置版本并发布

发布成功后,点击左侧最下方的版本管理与发布,配置应用版本号及版本描述。f1241e3d-5509-47ab-ac2f-66a59003e75a.jpg
3

设置事件订阅

事件订阅选择「Stream 模式」,无需注册公网回调地址。e230bc70-48a9-4f3b-9003-d9a1b1a47b7c.jpg
4

记录凭证信息

点击「凭证与基础信息」,记录 Client ID 和 Client Secret;点击左侧机器人,记录 RobotCode 和机器人名称。1f25c601-9ae6-4683-b837-1b8a1bf8e26c.jpg
5

填写 LangBot 机器人配置

记录以上配置项后,填入 LangBot 机器人配置表单,确认提交。7357567b-664d-459c-84a3-6f49411226ab.jpg
6

绑定流水线

启动 LangBot,编辑机器人,绑定流水线(初始会有一个 ChatPipeline 流水线),平台选择钉钉。f78a1745-fdd2-4f1e-a859-e93b66abd4cd.jpg
7

配置 AI 能力

编辑流水线,在 AI 能力配置中选择内置 Agent,并选择此前绑定好的所需模型。b85ac1a9-8bb5-4922-bd19-dd8f09fc8cee.jpge0815d11-fb6f-413c-9e8d-33becda159ae.jpg

使用机器人

1

搜索机器人并聊天

在钉钉搜索刚刚配置的机器人名称,点击机器人即可与其聊天。51c00478-159a-4299-905b-a900089cca8f.png
2

添加机器人到群聊

如需将机器人添加到群,点击钉钉群的「群管理」并选择「添加机器人」,搜索机器人名称即可在群聊中使用。76d14ae1-a31b-4165-9924-d2e1917548ec.png
最后修改于 2026年11月11日