abot/plugins/maibot_adapter/README.md

MaiBot Adapter 插件

这个插件用于把外部独立部署的 MaiBot WebUI 对接到 abot 的插件体系里。

当前能力

1. 支持命令触发：
   • 麦麦 你好
   • maibot 你是谁
2. 支持群聊里 @机器人 后把文本转发给 MaiBot。
3. 插件内部会自动执行：
   • POST /api/webui/auth/verify
   • GET /api/webui/ws-token
   • WS /ws?token=...
4. 每次消息会走一个独立的 WebSocket 逻辑会话，并等待 bot_message 事件作为最终回复。

配置说明

见 config.toml：

1. server_url
   • MaiBot WebUI 地址，例如 http://192.168.2.240:8001
2. access_token
   • MaiBot WebUI 登录 token
3. session_scope
   • room：同群共享语境
   • sender：同群内每个用户独立语境

部署建议

如果你后面要让 ai_auto_response 也改走 MaiBot，建议顺序如下：

1. 先用这个插件验证 MaiBot 对话质量与延迟。
2. 确认稳定后，再把 ai_auto_response 的“决策/生成”改成调用同一套桥接逻辑。
3. 最后再决定是否完全下线 ai_auto_response 原本的 LLM 直连链路。