Files
abot/plugins/maibot_adapter
liuwei 736ac05d98 增加MaiBot发包message_info快照日志用于私聊误判排障
变更项:\n1. 在 _send_outbound_payload 发送前新增 message_info 快照日志,完整输出实际入包的 message_info JSON。\n2. 日志仅输出 message_info,避免正文 segment 造成噪音与隐私扩散。\n3. 增加序列化异常保护,避免日志构建失败影响正常发包。\n4. 为定位‘群消息仍被识别为私聊’提供第一手协议证据。
2026-04-29 11:00:46 +08:00
..

MaiBot Adapter 插件

这个插件现在已经改成对接 MaiBot 官方 API Server,不再依赖 WebUI 聊天页 那套 token + ws-token + /api/webui/ws 流程。

当前能力

  1. 默认把 abot 收到的群聊/私聊消息旁路发送给 MaiBot作为上下文与记忆输入。
  2. 默认不阻断其它插件链路,ai_auto_responseDify、命令插件仍可继续照常处理。
  3. 是否真的把 MaiBot 的回复发回微信,由 enable_reply_outputreply_group_messagesreply_private_messages 以及群功能开关共同控制。
  4. 使用官方 API Server 协议:
    • WebSocket 握手头:x-uuid / x-apikey / x-platform
    • 消息包类型:sys_std
    • 负载结构:APIMessageBase
  5. 支持把图片、语音、视频、位置、应用消息转换成文本占位符发给 MaiBot方便它做长期上下文理解。

推荐定位

这套插件更适合做两件事:

  1. 让 MaiBot 成为 ai_auto_response 之外的一条“长期对话与记忆”能力链路。
  2. 先把全量消息采集给 MaiBot等效果稳定后再逐步提高它的主动参与度。

配置重点

config.toml

  1. api_server_ws_url
    • 例如 ws://192.168.2.240:18009/ws
  2. api_key
    • 用于官方 API Server 路由
  3. enable_reply_output
    • 控制“MaiBot 能不能实际开口说话”
  4. respect_group_feature_switch
    • 控制群里是否还要继续受 abot 功能权限开关约束

现阶段建议

如果你打算逐步替代 ai_auto_response,建议按这个顺序推进:

  1. 先保持 collect_group_messages=trueenable_reply_output=false,只观察 MaiBot 记忆与理解效果。
  2. 然后打开 enable_reply_output=true,但先让少量测试群开启 MAIBOT_CHAT 功能权限。
  3. 确认稳定后,再决定是让 MaiBot 成为独立对话插件,还是进一步吸收进 ai_auto_response 主流程。

Dashboard / WebUI

当前远端 192.168.2.240 已经补好官方 dashboard 静态资源,访问地址如下:

  1. WebUI 首页:http://192.168.2.240:18001/
  2. 健康检查:http://192.168.2.240:18001/api/webui/health
  3. 官方 API Server WebSocketws://192.168.2.240:18009/ws