安装 NcatBot、编写 config.yaml、确认 NapCat 连接 — 运行 Bot 前的必要准备。

---

前提条件

• Python ≥ 3.12
• NapCat 已安装并运行（提供 WebSocket 服务）

1. 安装 NcatBot

pip install ncatbot5

或使用 uv：

uv add ncatbot5

验证安装：

python -c "import ncatbot; print('NcatBot 可用')"

2. 编写 config.yaml

在项目根目录创建 config.yaml：

bot_uin: '你的QQ号'
root: '管理员QQ号'
adapters:
  - type: napcat
    platform: qq
    enabled: true
    config:
      ws_uri: ws://localhost:3001
      ws_token: napcat_ws
plugin:
  load_plugin: true

关键字段说明：

字段	说明
bot_uin	Bot 登录的 QQ 号
root	超级管理员 QQ 号，拥有所有权限
ws_uri	NapCat WebSocket 地址，默认 ws://localhost:3001
ws_token	NapCat WebSocket 认证 Token
load_plugin	是否启用插件加载（非插件模式可设为 false）

也可以使用 ncatbot init 交互式生成此文件。

3. 确认 NapCat 连接

确保 NapCat 已启动并监听在 ws_uri 指定的地址。NcatBot 启动时会自动连接。

连接成功后终端会输出类似：

[INFO] WebSocket 连接已建立: ws://localhost:3001

---

延伸阅读

• 配置项完整说明 → 配置管理指南
• 各平台适配器登录与配置 → 适配器指南（NapCat/Bilibili/GitHub/Mock）
• 下一步：选择启动模式 → 非插件模式 或 插件模式

版权所有

版权归属：huan-yp

许可证：署名 4.0 国际 (CC-BY-4.0)