AstrBot Plugin: MaiBot Agent Runner

将 MaiBot 作为 AstrBot 的 Agent 执行器，通过 WebSocket 连接 MaiBot API-Server，用 MaiBot 的思维链和回复逻辑替代 AstrBot 内置的 LLM Agent。

功能

• 🔌 Agent Runner 注册 — 启动时自动向 AstrBot 注册 maibot 类型的 Agent Runner，WebUI 可直接选择
• 🔗 持久 WebSocket 连接 — 与 MaiBot API-Server 保持长连接，支持心跳保活和自动重连
• 🛠️ 双向工具注入 — 将 AstrBot 的 LLM 工具同步到 MaiBot，MaiBot 可远程调用 AstrBot 侧的工具
• 📨 maim_message 协议 — 完整实现 sys_std 消息信封协议，支持文本 / 图片 / 表情等消息段

配置

在 AstrBot WebUI 中：

1. 进入 提供商管理 → 添加提供商 → 选择 MaiBot
2. 填写以下配置项：

配置项	说明	默认值
maibot_ws_url	MaiBot API-Server 的 WebSocket 地址	ws://127.0.0.1:18040/ws
maibot_api_key	API Key（需在 MaiBot 配置的 api_server_allowed_api_keys 中添加）	—
maibot_platform	发送给 MaiBot 的平台标识	astrbot

3. 进入 AI 设置 → Agent 执行器 → 选择 maibot，并选择刚才创建的提供商

前置依赖

• AstrBot >= 4.20.1（需要 Agent Runner 动态注册 API）
• MaiBot 需开启 API Server（enable_api_server: true）
• MaiBot 侧需安装 maibot_astrbot_bridge_plugin 以支持回复路由和工具桥接

文件结构

plugin_upload_astrbot_plugin_maibot/
├── main.py                  # 插件入口，注册 AgentRunnerEntry
├── maibot_agent_runner.py   # MaiBotAgentRunner 实现
├── maibot_ws_client.py      # WebSocket 客户端（持久连接 + 工具注入协议）
└── metadata.yaml            # 插件元数据