在消息平台接入专属聊天机器人，能快速生成精准答案，与项目管理、CRM等系统集成后，机器人还能根据任务进展自动建群、推送进度提醒，并精准@相关人员，实现信息的高效传递。
AstrBot 是一个多平台聊天机器人及开发框架，可调用当前多款主流LLM，支持接入飞书、钉钉等消息平台，其高度模块化和低耦合的特点，能够帮助用户快速部署多种功能扩展。
以下为完整教程，简单接入，即可开启高效协作。
项目地址：https://github.com/AstrBotDevs/AstrBot
PPIO × AstrBot配置教程
第一步：获取 API key
1. 获取 API 密钥
点击阅读原文，注册登录派欧云，填写邀请码【N7EUVY】得 15元代金券。
打开 API 密钥管理页面，点击创建按钮，输入自定义密钥名称，生成API密钥。
2. 生成并保存 API 密钥
!!注意:秘钥在服务端是加密存储，请在生成时保存好秘钥；若遗失可以在控制台上删除并创建一个新的秘钥。
3. 获取 【模型ID】
推荐使用的模型 ID
-
deepseek/deepseek-r1-turbo
-
deepseek/deepseek-v3-0324
-
qwen/qwen3-235b-a22b-fp8
-
qwen/qwen3-30b-a3b-fp8
其他模型ID、最大上下文及价格可参考：模型列表
第二步：部署AstrBot
通过 Docker 可以方便地将 AstrBot 部署到 Windows, Mac, Linux 上。
以下教程默认您的环境已安装 Docker。如果没有安装，请参考 Docker 官方文档进行安装。
文档地址：https://docs.docker.com/get-started/get-docker/
1. 通过 Docker 部署AstrBot
mkdir astrbot
sudo docker run -itd -p 6180-6200:6180-6200 -p 11451:11451 -v $PWD/data:/AstrBot/data -v /etc/localtime:/etc/localtime:ro -v /etc/timezone:/etc/timezone:ro --name astrbot soulter/astrbot:latest关于端口映射，如果您不想映射上面这么多端口，可以参考下表：
| Port | Description | Type |
|---|---|---|
| 6185 | AstrBot WebUI 默认 端口 | 需要 |
| 6195 | 企业微信 默认 端口 | 可选 |
| 6199 | OneBot(aiocqhttp) 默认 端口 | 可选 |
| 6196 | QQ 官方 API(Webhook) HTTP callback server 默认 端口 | 可选 |
| 11451 | Gewechat callback HTTP server 默认 端口 | 可选 |
Windows 下不需要加 sudo，下同 Windows 同步 Host Time（需要WSL2）
-v \\wsl.localhost\(your-wsl-os)\etc\timezone:/etc/timezone:ro
-v \\wsl.localhost\(your-wsl-os)\etc\localtime:/etc/localtime:ro通过以下命令查看 AstrBot 的日志：
sudo docker logs -f astrbotAstrBot 支持基于 Docker 的沙箱代码执行器。如果你需要使用沙箱代码执行器，请额外添加 -v /var/run/docker.sock:/var/run/docker.sock 参数。即:
sudo docker run -itd -p 6180-6200:6180-6200 -p 11451:11451 -v $PWD/data:/AstrBot/data -v /var/run/docker.sock:/var/run/docker.sock -v /etc/localtime:/etc/localtime:ro -v /etc/timezone:/etc/timezone:ro --name astrbot soulter/astrbot:latest安装成功后，即可看到 AstrBot 打印出的日志。
第三步：配置AstrBot
1. 访问管理面板
当启动 AstrBot 之后，你可以通过浏览器访问http://localhost:6185 来访问管理面板。默认用户名和密码是 astrbot 和 astrbot。
2. 可视化配置
在管理面板中，你可以通过可视化配置来配置 AstrBot 的插件。点击左栏配置即可进入配置页面。
顶部的两个按钮可以切换可视化编辑配置和代码编辑配置。
在可视化编辑配置中，当修改完配置后，需要点击右下角保存按钮来保存配置。
在代码编辑配置中，你可以直接编辑配置文件，编辑完后首先点击应用此配置，此时配置将应用到可视化配置中，然后再点击右下角保存按钮来保存配置。
3. 配置服务供应商
打开AstrBot，选择服务供应商，点击新增服务供应商，选择PPIO派欧云。
4. 按以下方案配置模型
-
ID:PPIO
-
启用：开启
-
API Key：PPIO派欧云官网保存的密钥
-
API Base URL:固定为https://api.ppinfra.com/v3/openai
-
模型名称：从派欧云官网复制的模型名称（https://ppio.cn/ai-computing/llm-api）
第三步：接入平台
AstrBot 支持在多种消息平台上部署聊天机器人，此处以飞书为例。
1. 创建机器人
前往飞书 开发者后台 ，创建企业自建应用，添加应用能力“机器人”。
地址：https://open.feishu.cn/app
2. 获取凭证信息
点击凭证与基础信息，获取 app_id 和 app_secret。
3. 配置 AstrBot
-
进入 AstrBot 的管理面板
-
点击左边栏 消息平台
-
然后在右边的界面中，点击 + 新增适配器
-
选择 lark(飞书)
弹出的配置项填写：
-
ID(id)：随意填写，用于区分不同的消息平台实例。
-
启用(enable): 勾选。
-
app_id: 获取的 app_id
-
app_secret:获取的 app_secret
-
飞书机器人的名字
如果您正在用国际版飞书，请将 domain 设置https://open.larksuite.com。
4. 设置回调和权限
接下来，点击事件与回调，使用长连接接收事件，点击保存。如果上一步没有成功启动，那么这里将无法保存。
点击添加事件，消息与群组，下拉找到 接收消息，确认添加。
点击开通以下权限。
再点击上面的保存按钮。
接下来，点击权限管理，点击开通权限，输入 im:message:send,im:message,im:message:send_as_bot。添加筛选到的权限。
再次输入 im:resource:upload,im:resource 开通上传图片相关的权限。
最终开通的权限如下图：
5. 创建版本
6. 开启对话
进入飞书 APP（网页版飞书无法添加机器人），搜索刚刚创建的机器人的名字，即可开启对话。
