NcatBot 文档

外观

适配器登录与使用指南

约 659 字大约 2 分钟

2026-03-19

各内置适配器的认证、配置与使用流程 — 从零开始接入每个平台。

适配器一览

适配器平台认证方式协议适用场景
NapCatQQWebUI 扫码 / 快速登录OneBot v11 (WebSocket)QQ 群聊/私聊 Bot
BilibiliBilibili终端扫码bilibili-api-python直播弹幕 / 私信 / 视频评论
GitHubGitHubPersonal Access TokenWebhook / REST PollingIssue/PR/Push 事件处理
Lark飞书App ID + App Secretlark-oapi SDK (WebSocket)飞书群聊/私聊 Bot
AI多平台 LLMAPI Key / 环境变量litellm (REST)Chat / Embeddings / 图像生成
Mock测试无需认证内存模拟插件集成测试

配置入口

推荐使用 CLI 管理适配器：

ncatbot adapter list              # 查看可用适配器及启用状态
ncatbot adapter enable bilibili   # 交互式启用（Bilibili 扫码登录）
ncatbot adapter enable github     # 交互式启用（GitHub 填写 PAT）
ncatbot adapter disable <type>    # 禁用适配器
ncatbot adapter status            # 查看已配置适配器状态

ncatbot init 同样支持多适配器选择——通过 checkbox 多选后，依次调用各适配器的 cli_configure() 钩子完成配置。部分适配器含智能跳过逻辑：

  • NapCat：选择自动安装时跳过 WS/WebUI 地址输入（启动时自动配置）
  • Bilibili：选择扫码登录时跳过 sessdata 等凭据手动输入（扫码自动获取）

完整 CLI 命令说明见 CLI 命令详解。

也可以直接编辑 config.yaml 的 adapters 列表：

adapters:
  - type: napcat          # 适配器名称
    platform: qq          # 平台标识
    enabled: true
    config:               # 适配器专属配置
      ws_uri: ws://localhost:3001
      ws_token: napcat_ws

多个适配器可同时运行：

adapters:
  - type: napcat
    platform: qq
    enabled: true
    config:
      ws_uri: ws://localhost:3001
  - type: bilibili
    platform: bilibili
    enabled: true
    config:
      live_rooms: [12345]
  - type: github
    platform: github
    enabled: true
    config:
      token: "ghp_xxxx"
      repos: ["owner/repo"]
  - type: ai
    platform: ai
    enabled: true
    config:
      completion_model: "gpt-4"

本目录索引

文档说明难度
1_napcat_qq.mdNapCat/QQ — Setup/Connect 两种模式、WebUI 登录、诊断⭐
2_bilibili.mdBilibili — 扫码登录、凭据持久化、多数据源配置⭐
3_github.mdGitHub — Token 认证、Webhook/Polling 双模式、内网穿透⭐⭐
6_lark.mdLark — 飞书企业应用创建、WebSocket 长连接、群聊/私聊⭐
5_ai.mdAI — litellm 统一接口、多提供商、Chat/Embeddings/ImageGen⭐
4_mock.mdMock — 测试用内存适配器⭐

交叉引用

版权归属：MI

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

© 2025-2026 NcatBot