在消息平臺接入專屬聊天機器人，能快速生成精準答案，與項目管理、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（網頁版飛書無法添加機器人），搜索剛剛創建的機器人的名字，即可開啟對話。
)
