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

写给完全零基础的新手。本文不需要你懂编程、不需要你懂网络协议只要你会用电脑、会打字就能跟着做。目录聊天机器人到底是什么搞清楚三个角色就够了动手前需要准备什么方案一轻量入门NoneBot2 NapCat方案二零代码方案AstrBot写你的第一个插件遇到问题怎么办下一步怎么走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 官方 GitHubNapCatQQ 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消息格式选ArrayToken 随便设一个记下来后面要用点击保存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文件没有就新建写入ENVIRONMENTdev DRIVER~fastapi~websockets HOST127.0.0.1 PORT8080 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管理员 PowerShelliwr -useb https://docs.astrbot.app/install.ps1 | iexMac / Linuxcurl -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 再 NapCatWebSocket 连不上Token 不匹配检查 NapCat 和.env里的 Token 是否一样发 /hello 没反应命令前缀问题试试在 QQ 里发.helloNoneBot2 默认前缀是.或/NapCat 闪退QQ 版本目录不对查看 NapCat 的文档确保文件在正确目录端口被占用有其他程序在用端口在.env里改PORT8081NapCat 那边也改排查流程机器人没反应 ├── NapCat 跑着吗 → 看有没有 NapCat 窗口 / 看端口 3001 ├── NoneBot2 跑着吗 → 看终端有没有 Running on 127.0.0.1:8080 ├── WebSocket 连上了吗 → NoneBot2 日志里有没有连接成功的消息 ├── 插件加载了吗 → NoneBot2 日志里有没有 loaded plugin └── 命令写对了吗 → 检查命令名字和触发方式8. 下一步怎么走跑通之后你按这个顺序走 第 1 步多写几个插件查天气掷骰子自我介绍群管理禁言、踢人 第 2 步接入 AI花 10 块钱注册 DeepSeek拿到 API Key。 在机器人里配置 AI 对话插件你的机器人就能像 ChatGPT 一样说话了。 第 3 步上服务器买一台最便宜的云服务器阿里云/腾讯云一个月几十块。 用 Docker 部署让机器人 24 小时在线。 第 4 步进阶接入 RAG 知识库让机器人懂你的私有数据接入语音让机器人能说话多平台QQ Telegram Discord 同时运行记住一句话先跑起来再学原理。90% 的人失败不是因为难是因为还没开始就放弃了。照着这篇文章一两个小时你就能拥有一个自己的机器人。