第四步:启动并使用
恭喜你走到了最后一步!现在你已经下载了简儿、安装好了运行环境、完成了配置,只差一步就能让你的机器人在 QQ 群里正式上线了。
启动顺序
重要:请严格按顺序操作
必须先启动 NapCatQQ(协议端),再启动简儿(机器人主程序)。如果反过来,简儿会因为找不到协议端而连接失败。
第 1 步:启动 NapCatQQ
确保你的 NapCatQQ 已经正确安装和配置(参考 NapCatQQ 使用教程)。
启动 NapCatQQ 后,确认以下几件事:
- ✅ NapCatQQ 已经成功启动
- ✅ 你的机器人 QQ 号已经扫码登录成功
- ✅ WebUI 中的 WebSocket 服务器正在运行(端口与
config.json中一致)
第 2 步:启动简儿主程序
你有两种方式启动简儿:
方式一:通过 Jianer WebUI 启动
如果你已经启动了 Jianer WebUI(python app.py),可以直接在 WebUI 中管理简儿的启动:
- 在浏览器中打开 WebUI(
http://127.0.0.1:5000) - 在左侧导航中点击 "Jianer 管理"
- 在"启动配置"中确认启动命令和工作目录
- 点击 "启动" 按钮
WebUI 还提供了 实时日志 面板,可以直接查看简儿的运行输出。
方式二:通过命令行启动
在简儿的程序根目录中打开终端,运行:
python main.py判断是否启动成功
启动后,观察终端中的日志输出。当你看到类似以下内容时,说明简儿已经成功连接到了协议端:
ℹ️ INFO 成功建立连接看到这条消息后,你就可以去 QQ 群里和你的机器人互动了!🎉
启动后做什么
试着跟机器人说句话
在你的机器人所在的 QQ 群里,发送以下消息试试:
~帮助(这里的 ~ 是你在 config.json 中设置的 reminder 触发符号。如果你改成了其他符号,请用你设置的那个。)
如果机器人回复了帮助信息,说明一切就绪!
你也可以直接 @机器人 来查看帮助内容。
让机器人拥有 AI 能力
现在你的机器人可以正常工作了,但如果你想让它拥有 AI 对话能力(支持 ChatGPT、Gemini、DeepSeek),需要额外配置 API Key。
👉 配置 AI 功能
如果启动失败了怎么办
提示"连接失败"或"无法连接到 WebSocket"
这说明简儿无法连接到 NapCatQQ。请检查:
- NapCatQQ 是否已经启动并成功登录?
- NapCatQQ 的 WebSocket 服务器是否已经开启?
config.json中的Connection.host和Connection.port是否与 NapCatQQ WebUI 中的设置一致?
提示 ModuleNotFoundError
这说明某个依赖库没有安装。根据报错信息手动安装即可:
pip install 缺失的库名提示 SyntaxError
检查你的 Python 版本是否满足要求(NEXT 3 及以上版本需要 Python >=3.12, ❤️.14):
python --version其他问题
如以上方法都无法解决,请参考:👉 问题与解决方法汇总
接下来,推荐你阅读 日常使用指南 来了解简儿的全部功能和群内操作方式。
ℰ𝓃𝒿ℴ𝓎 It! 🎊
