PPIO × AstrBot配置教程
获取 API key
1
获取 API 密钥
注册并登录派欧云。打开 API 密钥管理页面,点击创建按钮,输入自定义密钥名称,生成 API 密钥。.PNG?fit=max&auto=format&n=R2NxCPPdlM2Tr19d&q=85&s=7af8bc55e224ad729fb01f9cb9a36253)
2
生成并保存 API 密钥
注意:密钥在服务端加密存储,请在生成时保存好密钥;若遗失,可在控制台删除并新建一个密钥。
3
获取模型 ID
推荐使用的模型 ID
- deepseek/deepseek-v4-pro
- deepseek/deepseek-v4.1-flash
- qwen/qwen3.8-max
- zai-org/glm-5.3
部署 AstrBot
通过 Docker 部署 AstrBot。 Docker 可将 AstrBot 部署到 Windows、macOS、Linux。 以下教程默认已安装 Docker。未安装请参考 Docker 官方文档。 文档地址:https://docs.docker.com/get-started/get-docker/
Windows 下不需要加 sudo,下同。Windows 同步 Host Time 需要 WSL2。
配置 AstrBot
1
访问管理面板
当启动 AstrBot 之后,你可以通过浏览器访问http://localhost:6185 来访问管理面板。默认用户名和密码是 astrbot 和 astrbot。

2
可视化配置
在管理面板中,可通过可视化配置来配置 AstrBot 的插件。点击左栏配置即可进入配置页面。
顶部两个按钮可切换可视化编辑配置和代码编辑配置。在可视化编辑配置中,修改完配置后,需点击右下角保存按钮保存配置。在代码编辑配置中,可直接编辑配置文件。编辑完后先点击应用此配置,配置将应用到可视化配置中,再点击右下角保存按钮保存配置。


3
配置服务供应商
打开 AstrBot,选择服务供应商,点击新增服务供应商,选择 PPIO 派欧云。



4
按以下方案配置模型
- ID:PPIO
- 启用:开启
- API Key:PPIO 派欧云官网保存的密钥
-
API Base URL:固定为
https://api.ppio.com/openai -
模型名称:从派欧云官网复制的模型名称

接入平台
AstrBot 支持在多种消息平台上部署聊天机器人,此处以飞书为例。1
创建机器人
2
获取凭证信息
点击凭证与基础信息,获取 app_id 和 app_secret。

3
进入 AstrBot 管理面板
进入 AstrBot 管理面板。
4
打开消息平台
点击左边栏「消息平台」。
5
新增适配器
在右侧界面中,点击 + 新增适配器。
6
选择飞书适配器
选择 lark(飞书)。
7
填写配置项
弹出的配置项填写:
- ID(id):随意填写,用于区分不同的消息平台实例。
- 启用(enable):勾选。
- app_id:获取的 app_id
- app_secret:获取的 app_secret
- 飞书机器人的名字
https://open.larksuite.com。8
在飞书后台配置事件与回调
接下来,点击事件与回调,使用长连接接收事件,点击保存。如果上一步没有成功启动,这里将无法保存。
点击添加事件,消息与群组,下拉找到「接收消息」,确认添加。
点击开通以下权限。
再点击上方的保存按钮。



9
开通消息权限
接下来,点击权限管理,点击开通权限,输入 
im:message:send,im:message,im:message:send_as_bot,添加筛选到的权限。再次输入 im:resource:upload,im:resource 开通上传图片相关的权限。最终开通的权限如下图:
10
创建版本

11
开启对话
进入飞书 APP(网页版飞书无法添加机器人),搜索刚刚创建的机器人名称,即可开启对话。


