OneBot 适配器配置指南
概述
OneBot 适配器（onebot_adapter）是 Neo-MoFox 连接 QQ 平台的推荐方式，通过 OneBot 协议与 Napcat QQ 客户端通信。
前置条件
在配置适配器之前，请确保已完成：
- Neo-MoFox 主程序部署（Python 环境 + 依赖安装）
config/core.toml和config/model.toml基础配置- 已安装并登录 Napcat QQ 客户端
启用适配器
OneBot 适配器默认已启用。确认 config/plugins/onebot_adapter/config.toml 中：
toml
[plugin]
enabled = true配置连接参数
配置监听端口
toml
[onebot_server]
mode = "reverse" # reverse/direct
host = "localhost" # 监听地址
port = 8095 # 监听端口配置 Napcat 客户端
在 Napcat QQ 客户端中：
- 点击"网络配置" → "WebSocket 客户端" → "新建"
- URL 填写
ws://127.0.0.1:8095（端口与上面的port一致） - 保存
启动
bash
uv run main.py日志中出现 [OneBot 适配器] Bot xxxxxxx 连接成功 即表示连接建立。
故障排除
- 端口不通：检查
port值是否与 Napcat 客户端一致 - 连接失败：确认 Napcat QQ 已登录在线
- 不回复消息：检查
model.toml的 API Key 是否有效，以及白名单设置
贡献者
minecraft1024a
ikun-11451
Windpicker-owo
sunbiz1024