PPIO × LangBot配置教程
获取 API key
1
获取 API 密钥
注册并登录 PPIO。打开 API 密钥管理页面,点击创建按钮,输入自定义密钥名称,生成 API 密钥。

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

3
获取模型 ID
推荐使用的模型 ID
- deepseek/deepseek-v4-pro
- deepseek/deepseek-v4.1-flash
- qwen/qwen3.8-max
- zai-org/glm-5.3
部署并配置 LangBot
通过 Docker 可将 LangBot 部署到 Windows、macOS、Linux 上。 部署前,请确保已安装 Git、Docker。 项目地址:https://github.com/RockChinQ/LangBot1
通过 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,点击模型配置,模型提供商选择派欧云。

按以下信息配置模型。


- 模型名称:从 PPIO 官网复制的所需模型名称
- 模型提供商:派欧云
- 请求 URL:固定为
https://api.ppio.com/openai - API Key:从派欧云官网保存的密钥

接入平台
LangBot 支持将聊天机器人接入 QQ、微信公众平台、飞书等平台。以钉钉为例,接入教程如下。创建机器人
1
进入开发者后台
2
创建应用
点击上方的 
应用开发,选择 创建应用,填写机器人的基本信息并保存。
3
添加机器人能力
选择「添加应用能力」为应用添加机器人能力。

配置机器人
1
填写机器人信息并发布
点击左侧「机器人」选项卡,填写机器人配置信息,完成名称、简介、消息名称等基础配置,配置完成后点击发布。

2
配置版本并发布
发布成功后,点击左侧最下方的版本管理与发布,配置应用版本号及版本描述。

3
设置事件订阅
事件订阅选择「Stream 模式」,无需注册公网回调地址。

4
记录凭证信息
点击「凭证与基础信息」,记录 Client ID 和 Client Secret;点击左侧机器人,记录 RobotCode 和机器人名称。

5
填写 LangBot 机器人配置
记录以上配置项后,填入 LangBot 机器人配置表单,确认提交。

6
绑定流水线
启动 LangBot,编辑机器人,绑定流水线(初始会有一个 ChatPipeline 流水线),平台选择钉钉。

7
配置 AI 能力
编辑流水线,在 AI 能力配置中选择内置 Agent,并选择此前绑定好的所需模型。



使用机器人
1
搜索机器人并聊天
在钉钉搜索刚刚配置的机器人名称,点击机器人即可与其聊天。

2
添加机器人到群聊
如需将机器人添加到群,点击钉钉群的「群管理」并选择「添加机器人」,搜索机器人名称即可在群聊中使用。

