Files

T

Soulter fc33b3eb68 docs: transfer AstrBotDevs/AstrBot-docs to AstrBotDevs/AstrBot (#5960 )

* docs: transfer AstrBotDevs/AstrBot-docs to AstrBotDevs/AstrBot
* refactor: reorder imports and improve type hints in sync_docs_to_wiki.py and upload_doc_images_to_r2.py
* feat: add GitHub Actions workflow to sync wiki with documentation

Co-authored-by: Soulter <37870767+Soulter@users.noreply.github.com>
Co-authored-by: anka-afk <110004162+anka-afk@users.noreply.github.com>
Co-authored-by: zouyonghe <62183434+zouyonghe@users.noreply.github.com>
Co-authored-by: shuiping233 <49360196+shuiping233@users.noreply.github.com>
Co-authored-by: LIghtJUNction <106986785+LIghtJUNction@users.noreply.github.com>
Co-authored-by: Sjshi763 <179909421+Sjshi763@users.noreply.github.com>
Co-authored-by: xiewoc <70128845+xiewoc@users.noreply.github.com>
Co-authored-by: QingFeng-awa <151742581+QingFeng-awa@users.noreply.github.com>
Co-authored-by: PaloMiku <96452465+PaloMiku@users.noreply.github.com>
Co-authored-by: shangxueink <138397030+shangxueink@users.noreply.github.com>
Co-authored-by: IGCrystal-A <244300990+IGCrystal-A@users.noreply.github.com>
Co-authored-by: RC-CHN <67079377+RC-CHN@users.noreply.github.com>
Co-authored-by: MC090610 <113341105+MC090610@users.noreply.github.com>
Co-authored-by: Waterwzy <196913419+Waterwzy@users.noreply.github.com>
Co-authored-by: Lanhuace-Wan <186303160+Lanhuace-Wan@users.noreply.github.com>
Co-authored-by: LiAlH4qwq <61769640+LiAlH4qwq@users.noreply.github.com>
Co-authored-by: HSOS6 <209910899+HSOS6@users.noreply.github.com>
Co-authored-by: th-dd <162813557+th-dd@users.noreply.github.com>
Co-authored-by: miaoxutao123 <81676466+miaoxutao123@users.noreply.github.com>
Co-authored-by: nuomicici <143102889+nuomicici@users.noreply.github.com>
Co-authored-by: nasyt233 <210103278+nasyt233@users.noreply.github.com>
Co-authored-by: jlugjb <7426462+jlugjb@users.noreply.github.com>
Co-authored-by: Raven95676 <176760093+Raven95676@users.noreply.github.com>
Co-authored-by: Futureppo <180109455+Futureppo@users.noreply.github.com>
Co-authored-by: MliKiowa <61873808+MliKiowa@users.noreply.github.com>
Co-authored-by: Fridemn <150212937+Fridemn@users.noreply.github.com>
Co-authored-by: BakaCookie520 <138355736+BakaCookie520@users.noreply.github.com>
Co-authored-by: YumeYuka <125112916+YumeYuka@users.noreply.github.com>
Co-authored-by: xming521 <32786500+xming521@users.noreply.github.com>
Co-authored-by: ywh555hhh <121592812+ywh555hhh@users.noreply.github.com>
Co-authored-by: stevessr <89645372+stevessr@users.noreply.github.com>
Co-authored-by: roeseth <41995115+roeseth@users.noreply.github.com>
Co-authored-by: ikun-1145141 <265925499+ikun-1145141@users.noreply.github.com>
Co-authored-by: evpeople <54983536+evpeople@users.noreply.github.com>
Co-authored-by: Yue-bin <60509781+Yue-bin@users.noreply.github.com>
Co-authored-by: W1ndys <109416673+W1ndys@users.noreply.github.com>
Co-authored-by: TheFurina <218887821+TheFurina@users.noreply.github.com>
Co-authored-by: Seayon <12275933+Seayon@users.noreply.github.com>
Co-authored-by: OnlyblackTea <38585636+OnlyblackTea@users.noreply.github.com>
Co-authored-by: ocetars <74854972+ocetars@users.noreply.github.com>
Co-authored-by: railgun19457 <117180744+railgun19457@users.noreply.github.com>
Co-authored-by: JunieXD <107397009+JunieXD@users.noreply.github.com>
Co-authored-by: advent259141 <197440256+advent259141@users.noreply.github.com>
Co-authored-by: Doge2077 <91442300+Doge2077@users.noreply.github.com>
Co-authored-by: Bocity <23430545+Bocity@users.noreply.github.com>
Co-authored-by: Aurora-xk <192227833+Aurora-xk@users.noreply.github.com>

2026-03-09 23:38:21 +08:00

2.5 KiB

Raw Permalink Blame History

接入 LLTwoBot (Satori)

Tip

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

Tip

请合理控制使用频率。过于频繁地发送消息可能会被判定为异常行为，增加触发风控机制的风险。

本项目严禁用于任何违反法律法规的用途。若您意图将 AstrBot 应用于非法产业或活动，我们明确反对并拒绝您使用本项目。

准备工作

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

完成文档中的步骤，确保你已经：

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

配置 LLTwoBot 的 Satori 服务

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

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

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

确认【启用 Satori 协议】配置项已开启
端口默认为 5600（如需修改请记住新端口）
如有必要，可填写【Satori Token】
点击右下角的【保存配置】

在 AstrBot 中配置 Satori 适配器

进入 AstrBot 的管理面板
点击左边栏 机器人
然后在右边的界面中，点击 + 创建机器人
选择 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协议运行在其他端口，请根据实际情况修改对应的配置！

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

🎉 大功告成

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

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

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

常见问题

如果遇到连接问题，请检查：

LLTwoBot 是否正常运行
Satori 服务是否已启用
端口配置是否正确
Token 是否匹配（如设置了 Token）

2.5 KiB Raw Permalink Blame History Unescape Escape