Windows 安装

约 900 字大约 3 分钟

2025-02-07

注意

此教程只适用 Window10、Windows11 操作系统。

注意

请不要在云电脑上使用本项目，如果需要上云请使用 Linux 操作系统。

任务列表

我们给出一个简单的任务清单, 你可以按照下面的步骤来安装 NcatBot.

正确安装 Python3.12
通过 pip 安装 NcatBot
安装最新版 QQ
运行代码并扫码登录

1. 安装 Python

教程

2. 安装 NcatBot

注意

不要从 GitHub 上下载 .zip 压缩包；如果下载并解压过，请删掉解压出来的文件。

项目已经发布到 PYPI, 可以使用 pip 直接下载本项目.

按下 Win+R, 在左下角打开运行, 输入 powershell 并回车, 打开终端.

复制下面的代码, 粘贴到终端中, 按回车执行.

pip(稳定版, 推荐)

pip install ncatbot -U -i https://mirrors.aliyun.com/pypi/simple

3. 安装最新版 QQ

提示

如果出现无法登录的问题，请先卸载掉 QQ，再去官网下载安装最新版 QQ。

卸载掉电脑上已经安装的 QQ。

前往 QQ 官网下载安装最新版 QQ。

4. NcatBot 启动

准备 QQ 号

为了测试, 需要两个 QQ 号：

Bot: 由 NcatBot 控制, 可以使用接口收发消息.
root: 由你控制, 用于测试 Bot 的功能.

NcatBot 相当于一个电脑 QQ 客户端，因此在登陆前，你需要退出 Bot 在其它电脑客户端上的登录。

开始运行

建立一个新的工作目录(文件夹)，文件夹名为 ncatbot。

双击进入 ncatbot 文件夹.
在文件夹中新建一个 main.py 文件，注意后缀名是 .py
用记事本或者其它文本编辑器打开 main.py 文件，复制以下代码进去，并保存。

Python

# ========= 导入必要模块 ==========
from ncatbot.core import BotClient, PrivateMessage

# ========== 创建 BotClient ==========
bot = BotClient()

# ========= 注册回调函数 ==========
@bot.private_event()
async def on_private_message(msg: PrivateMessage):
    if msg.raw_message == "测试":
        await bot.api.post_private_msg(msg.user_id, text="NcatBot 测试成功喵~")

# ========== 启动 BotClient==========
bot.run()