Skip to content
AstrBot
Main Navigation 主页博客路线图HTTP API

简体中文

English

简体中文

English

切换日光/暗黑模式

简介和部署接入消息平台接入 AI使用开发
Sidebar Navigation

简介

关于 AstrBot

社区

常见问题

部署

包管理器部署

雨云一键云部署

桌面客户端部署

启动器一键部署

Docker 部署

Kubernetes 部署

宝塔面板部署

1Panel 部署

手动部署

其他部署方式

CasaOS 部署

优云智算 GPU 部署

社区提供的部署方式

支持我们

接入消息平台

快速接入指南

QQ 官方机器人

Webhook 方式

Websockets 方式

企微应用

企微智能机器人

微信公众号

飞书

钉钉

Telegram

LINE

Slack

Misskey

Discord

OneBot v11

NapCat

Lagrange

其他端

Satori

使用 LLOneBot

使用 server-satori

社区提供

Matrix

KOOK

VoceChat

接入 AI

✨ 接入模型服务

NewAPI

AIHubMix

PPIO 派欧云

硅基流动

小马算力

302.AI

Ollama

LMStudio

⚙️ Agent 执行器

内置 Agent 执行器

Dify

扣子 Coze

阿里云百炼应用

使用

WebUI

插件

内置指令

工具使用 Tools

技能 Skills

SubAgent 编排

主动型 Agent 能力

MCP

网页搜索

知识库

自定义规则

Agent 执行器

统一 Webhook 模式

自动上下文压缩

Agent 沙箱环境

开发

插件开发

🌠 从这里开始

最小实例

接收消息事件

发送消息

插件配置

调用 AI

存储

文转图

会话控制器

杂项

发布插件

插件指南(旧)

接入平台适配器

AstrBot HTTP API

AstrBot 配置文件

其他

自部署文转图

插件下载不了?试试自建 GitHub 加速服务

开源之夏

OSPP 2025

目录

接入 LLTwoBot (Satori) ​

TIP

LLTwoBot 是一个基于 QQNT 的 Onebot v11、Satori 多协议实现端,可以让你在 QQ 平台使用 Satori 协议与 AstrBot 进行通信。

TIP

  • 请合理控制使用频率。过于频繁地发送消息可能会被判定为异常行为,增加触发风控机制的风险。
  • 本项目严禁用于任何违反法律法规的用途。若您意图将 AstrBot 应用于非法产业或活动,我们明确反对并拒绝您使用本项目。

准备工作 ​

请先参考 LLTwoBot 官方文档完成基础配置: LLTwoBot 文档

完成文档中的步骤,确保你已经:

  1. 下载并安装了 LLTwoBot
  2. 成功登录了 QQ 账号

配置 LLTwoBot 的 Satori 服务 ​

在成功登录 QQ 后,先打开 LLTwoBot 的 WebUI 配置界面。

WebUI 默认地址为:http://localhost:3080/


在WebUI的配置界面侧边,选择【Satori】选项卡,进行如下配置:

  1. 确认【启用 Satori 协议】配置项已开启
  2. 端口默认为 5600(如需修改请记住新端口)
  3. 如有必要,可填写【Satori Token】
  4. 点击右下角的【保存配置】

image

在 AstrBot 中配置 Satori 适配器 ​

  1. 进入 AstrBot 的管理面板
  2. 点击左边栏 机器人
  3. 然后在右边的界面中,点击 + 创建机器人
  4. 选择 satori

弹出的配置项填写:

  • 机器人名称 (id): LLTwoBot
  • 启用 (enable): 勾选
  • Satori API 终结点 (satori_api_base_url):http://localhost:5600/v1
  • Satori WebSocket 终结点 (satori_endpoint):ws://localhost:5600/v1/events
  • Satori 令牌 (satori_token):根据 LLTwoBot 配置填写(如有设置)

NOTE

  • LLTwoBot 的 satori协议 默认在 5600 端口提供服务
  • 因此完整的 URL 路径为 http://localhost:5600/v1

如果你的 satori协议运行在其他端口,请根据实际情况修改对应的配置!

image

点击右下角 保存 完成配置。

🎉 大功告成 ​

此时,你的 AstrBot 应该已经通过 Satori 协议成功连接到 LLTwoBot。

在 QQ 中发送 /help 以检查是否连接成功。

如果成功回复,则配置成功。

常见问题 ​

如果遇到连接问题,请检查:

  1. LLTwoBot 是否正常运行
  2. Satori 服务是否已启用
  3. 端口配置是否正确
  4. Token 是否匹配(如设置了 Token)
发现文档有问题?在 GitHub 上编辑此页

Last updated:

Pager
上一篇其他端
下一篇使用 server-satori

Deployed on Rainyun Logo