abot/plugins/maibot_adapter/DEPLOY_192.168.2.240.md

192.168.2.240 上的 MaiBot 部署说明

这份文档记录当前 MaiBot 官方镜像 在 192.168.2.240 的实际部署状态，供 plugins/maibot_adapter 对接使用。

当前结论

1. MaiBot 使用官方镜像 sengokucola/maibot:latest 部署。
2. 没有改动 MaiBot 源码，dashboard 通过官方 maibot-dashboard==1.0.0 静态资源挂载方式补齐。
3. abot 侧不再走 WebUI 聊天页，而是改走 官方 API Server。
4. 现在的推荐接入地址如下：
   • WebUI / Dashboard：http://192.168.2.240:18001/
   • WebUI Health：http://192.168.2.240:18001/api/webui/health
   • 官方 API Server WS：ws://192.168.2.240:18009/ws

当前 docker-compose 关键点

容器名：

maibot-core-lite

镜像：

sengokucola/maibot:latest

核心端口映射：

18001 -> 8001   # WebUI / Dashboard / WebUI API
18009 -> 8090   # 官方 API Server

Dashboard 访问地址

当前已经补全完成，可直接访问：

http://192.168.2.240:18001/

如果只想看健康状态：

http://192.168.2.240:18001/api/webui/health

期待返回：

{"status":"healthy","service":"MaiBot WebUI"}

embedding 模型现状

当前远端已切到 Ollama 向量服务：

ollama_base_url = "http://192.168.2.50:11434/v1"
embedding_model = "bge-m3:latest"

这套配置已经验证可用，MaiBot 日志里能看到 embedding 维度识别成功。

官方 API Server 接入方式

maibot_adapter 现在用的是官方 API Server 协议，不再使用：

1. POST /api/webui/auth/verify
2. GET /api/webui/ws-token
3. WS /api/webui/ws?token=...

现在实际使用的是：

1. WS ws://192.168.2.240:18009/ws
2. 握手头：
   • x-uuid
   • x-apikey
   • x-platform
3. 消息包类型：
   • sys_std
4. 负载结构：
   • APIMessageBase

abot 配置建议

当前 plugins/maibot_adapter/config.toml 推荐值：

[MaiBotAdapter]
enable = true
collect_group_messages = true
collect_private_messages = true
enable_reply_output = true
reply_group_messages = true
reply_private_messages = true
respect_group_feature_switch = true
mention_user_on_group_reply = false
api_server_ws_url = "ws://192.168.2.240:18009/ws"
api_key = "abot-maibot"
platform_name = "abot-maibot"

设计边界

当前这套接法遵循你已经确认过的原则：

1. 消息默认发送给 MaiBot 做采集。
2. 是否真的回复，由开关和群功能权限控制。
3. 不重新开发 MaiBot 对话/记忆本体能力。
4. 尽量把“参与聊天”的判断留在 MaiBot 侧，而不是在 abot 里再做一遍复杂前置策略。