当前位置：首页 > news >正文

AI 聊天机器人完全入门：从零到让你的第一个机器人跑起来

news 2026/5/31 2:28:46

写给完全零基础的新手。本文不需要你懂编程、不需要你懂网络协议，只要你会用电脑、会打字，就能跟着做。

1. 聊天机器人到底是什么？

简单说，一个聊天机器人就是：

一个自动帮你回复消息的程序。

你设好规则，它自动执行：

有人说「/hello」→ 它回「你好呀！」
有人说「/天气北京」→ 它去查天气预报发回来
有人问了一个问题 → 它去问 AI（比如 DeepSeek），再把答案发回来

这个过程不需要你手动操作，机器人 24 小时在线帮你处理。

2. 搞清楚三个角色就够了

整个机器人系统只有三个角色：

┌─────────────────────────────────────────────────────────┐ │ │ │ 你发消息 → ① 信使（NapCat）→ ② 大脑（框架） │ │ ↓ │ │ ③ 智慧（AI模型） │ │ ↓ │ │ 你收到 ← 信使 ← 大脑 ← 生成回复 │ │ │ └─────────────────────────────────────────────────────────┘

① 信使 — NapCat

它负责：

登录你的 QQ 小号
把 QQ 上收到的消息转发给"大脑"
把"大脑"的回复发回 QQ

你不用管它怎么工作的，下载、登录、配置一次就好。

② 大脑 — 框架（NoneBot2 / AstrBot）

它是你真正需要学习的东西。它负责：

收到消息后，决定怎么回复
管理插件（你写的功能模块）
对接 AI 模型

③ 智慧 — AI 模型（DeepSeek / OpenAI）

可选项。如果你只是想让机器人做简单回复（比如查天气、复读），不需要 AI。但如果你想让它能像真人一样聊天、回答问题，就需要接入 AI 模型。

3. 动手前需要准备什么

你需要	说明
一台电脑	Windows / Mac / Linux 都行
一个 QQ 小号	⚠️绝对不要用你的主号，注册个新的或找个不用的
Python 3.12+	只装一个 Python 就行（后面会教）
一两个小时	别着急，慢慢来

4. 方案一：轻量入门（NoneBot2 + NapCat）

这是目前最推荐的入门方案。免费、文档全、社区活跃。

第一步：安装 Python

去 python.org 下载 Python 3.12+。安装时一定要勾选「Add Python to PATH」。

验证安装：

python --version # 应该显示 Python 3.12.x

第二步：部署 NapCat（信使）

Windows 用户（最简单）：

打开 NapCat 官方 GitHub：NapCatQQ Releases
下载最新版的 Windows 压缩包
解压到文件夹，双击运行launcher.bat
会弹出 QQ 登录窗口 → 用你的 QQ 小号扫码登录
登录成功后，浏览器打开http://127.0.0.1:6099/webui/
进入 WebUI → 「网络配置」→ 新建一个WebSocket 客户端
- URL 填：ws://127.0.0.1:8080/onebot/v11/ws
- 消息格式选：Array
- Token 随便设一个（记下来，后面要用）
- 点击保存

NapCat 这个小窗口不要关，关了就掉线了。

第三步：安装 NoneBot2（大脑）

打开一个新的命令行窗口（不要关 NapCat）：

# 创建项目目录 mkdir my-first-bot cd my-first-bot  # 创建虚拟环境（Python 的标准做法） python -m venv .venv  # 激活虚拟环境 # Windows: .venv\Scripts\activate # Mac/Linux: source .venv/bin/activate  # 安装 NoneBot2 脚手架 pip install nb-cli  # 创建项目 nb create

这时会进入一个交互界面，选择：

Project Template: 选bootstrap（新手模板）
Adapter: 按空格选中OneBot V11，然后回车
Driver: 默认FastAPI，直接回车

第四步：配置连接

在my-first-bot文件夹下，找到.env文件（没有就新建），写入：

ENVIRONMENT=dev DRIVER=~fastapi+~websockets HOST=127.0.0.1 PORT=8080 ONEBOT_ACCESS_TOKEN=你刚才在NapCat里设的Token

第五步：让它们连起来

先启动 NoneBot2（在刚才的终端里）：

nb run --reload

看到Running on 127.0.0.1:8080就说明启动成功了。

确保 NapCat 还在运行。如果 NapCat 之前启动过但已关闭，重新打开launcher.bat。
观察 NoneBot2 的终端，应该会看到WebSocket 连接成功之类的日志。

第六步：验证机器人是否活着

在你的 QQ 上，给机器人小号发消息：

/hello

如果机器人回复了「你好！」，恭喜你 🎉你的第一个机器人跑起来了！

如果没有回复，别急，翻到下面的遇到问题怎么办。

5. 方案二：零代码方案（AstrBot）

如果你不想写代码，或者想让机器人在多个平台都能用，直接用 AstrBot。

一句话安装

Windows（管理员 PowerShell）：

iwr -useb https://docs.astrbot.app/install.ps1 | iex

Mac / Linux：

curl -LsSf https://docs.astrbot.app/install.sh | bash

然后：

astrbot init astrbot run

浏览器打开http://localhost:6185，默认账号密码都是astrbot。在后台配置好 NapCat 连接和 AI 模型，你的机器人就能用了。

6. 写你的第一个插件

这一步只有选方案一（NoneBot2）需要做。

找到插件目录src/plugins/，创建一个文件夹echo，里面新建__init__.py文件，写入：

from nonebot import on_command from nonebot.adapters.onebot.v11 import Bot, Event, Message  # 注册一个叫 /hello 的命令 hello = on_command("hello")  @hello.handle() async def handle_hello(bot: Bot, event: Event): """当用户发 /hello 时，机器人回复""" await hello.finish(Message("你好呀！我是你的第一个机器人 🤖"))  # 注册一个复读机 echo = on_command("echo")  @echo.handle() async def handle_echo(bot: Bot, event: Event): content = event.get_plaintext().replace("/echo ", "") await echo.finish(Message(content))

保存后，NoneBot2 会自动重载（因为有--reload参数）。在 QQ 上发：

/hello → 机器人回「你好呀！我是你的第一个机器人 🤖」 /echo 哈哈 → 机器人回「哈哈」

7. 遇到问题怎么办

最常见的问题

问题	原因	解决
机器人收不到消息	NapCat 和 NoneBot2 没连上	检查启动顺序：先 NoneBot2 再 NapCat
WebSocket 连不上	Token 不匹配	检查 NapCat 和`.env`里的 Token 是否一样
发 /hello 没反应	命令前缀问题	试试在 QQ 里发`.hello`（NoneBot2 默认前缀是`.`或`/`）
NapCat 闪退	QQ 版本目录不对	查看 NapCat 的文档，确保文件在正确目录
端口被占用	有其他程序在用端口	在`.env`里改`PORT=8081`，NapCat 那边也改

排查流程

机器人没反应？ ├── NapCat 跑着吗？ → 看有没有 NapCat 窗口 / 看端口 3001 ├── NoneBot2 跑着吗？ → 看终端有没有 Running on 127.0.0.1:8080 ├── WebSocket 连上了吗？ → NoneBot2 日志里有没有连接成功的消息 ├── 插件加载了吗？ → NoneBot2 日志里有没有 loaded plugin └── 命令写对了吗？ → 检查命令名字和触发方式