跳转到主要内容
在消息平台接入专属聊天机器人,可快速生成答案。与项目管理、CRM 等系统集成后,机器人能根据任务进展自动建群、推送进度提醒,并 @ 相关人员。 AstrBot 是一个多平台聊天机器人及开发框架,可调用多款主流 LLM,支持接入飞书、钉钉等消息平台。其模块化、低耦合的特点便于快速部署功能扩展。 以下为完整接入教程。 项目地址:https://github.com/AstrBotDevs/AstrBot

PPIO × AstrBot配置教程

获取 API key

1

获取 API 密钥

注册并登录派欧云。打开 API 密钥管理页面,点击创建按钮,输入自定义密钥名称,生成 API 密钥。1280X1280.PNG
2

生成并保存 API 密钥

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

获取模型 ID

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

部署 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 日志:
AstrBot 支持基于 Docker 的沙箱代码执行器。如需使用,请额外添加 -v /var/run/docker.sock:/var/run/docker.sock 参数,即:
安装成功后,即可看到 AstrBot 打印的日志。

配置 AstrBot

1

访问管理面板

当启动 AstrBot 之后,你可以通过浏览器访问http://localhost:6185 来访问管理面板。默认用户名和密码是 astrbot 和 astrbot。1e118328-eb1a-4535-8ea2-4486acaf5439.png
2

可视化配置

在管理面板中,可通过可视化配置来配置 AstrBot 的插件。点击左栏配置即可进入配置页面。f3c36f3d-5b8a-4a17-b283-0c5e1752da77.png顶部两个按钮可切换可视化编辑配置和代码编辑配置。在可视化编辑配置中,修改完配置后,需点击右下角保存按钮保存配置。在代码编辑配置中,可直接编辑配置文件。编辑完后先点击应用此配置,配置将应用到可视化配置中,再点击右下角保存按钮保存配置。8e4e8624-9cfc-47ae-8cf1-9381c25db0a1.png
3

配置服务供应商

打开 AstrBot,选择服务供应商,点击新增服务供应商,选择 PPIO 派欧云。54713981-7729-4348-9816-626f23b92d90.jpg8bc6cd7a-1cae-4548-b60f-026290878d14.jpg
4

按以下方案配置模型

  • ID:PPIO
  • 启用:开启
  • API Key:PPIO 派欧云官网保存的密钥
  • API Base URL:固定为 https://api.ppio.com/openai
  • 模型名称:从派欧云官网复制的模型名称 8fcde90c-e4f9-4191-90f6-45d93f3dffbe.jpg

接入平台

AstrBot 支持在多种消息平台上部署聊天机器人,此处以飞书为例。
1

创建机器人

前往飞书「开发者后台」,创建企业自建应用,添加应用能力「机器人」。地址:https://open.feishu.cn/app12f614bd-c4d3-4456-81b5-b36e02f063bb.png227573a2-0ada-4fc9-9a2d-938413c5c7e8.png
2

获取凭证信息

点击凭证与基础信息,获取 app_id 和 app_secret。a86e4a30-f634-4904-82b0-ea904dffb70f.png
3

进入 AstrBot 管理面板

进入 AstrBot 管理面板。
4

打开消息平台

点击左边栏「消息平台」。
5

新增适配器

在右侧界面中,点击 + 新增适配器。
6

选择飞书适配器

选择 lark(飞书)。
7

填写配置项

弹出的配置项填写:
  • ID(id):随意填写,用于区分不同的消息平台实例。
  • 启用(enable):勾选。
  • app_id:获取的 app_id
  • app_secret:获取的 app_secret
  • 飞书机器人的名字
如使用国际版飞书,请将 domain 设置为 https://open.larksuite.com。
8

在飞书后台配置事件与回调

接下来,点击事件与回调,使用长连接接收事件,点击保存。如果上一步没有成功启动,这里将无法保存。b3ef89a2-cfd9-4d24-a1bd-e6d53483ac7e.png点击添加事件,消息与群组,下拉找到「接收消息」,确认添加。8b5ff487-40aa-4766-b32f-2d8b9c68368b.png点击开通以下权限。97982c95-c3e5-45af-a71a-d30facbe8700.png再点击上方的保存按钮。
9

开通消息权限

接下来,点击权限管理,点击开通权限,输入 im:message:send,im:message,im:message:send_as_bot,添加筛选到的权限。再次输入 im:resource:upload,im:resource 开通上传图片相关的权限。最终开通的权限如下图:a7ef4383-a302-430a-ba88-593291b2e596.png
10

创建版本

19fc4899-a3e6-4864-8d5a-064ef0d11efb.png
11

开启对话

进入飞书 APP(网页版飞书无法添加机器人),搜索刚刚创建的机器人名称,即可开启对话。022a76a8-8506-49a5-b2ef-350337c76b52.jpg
最后修改于 2026年11月11日