全网最简单部署QQ机器人的方式（原创），全程使用可视化面板，不需要运行任何命令！

本教程的环境基于 1Panel，如果没有装 1Panel，建议先去装一个（可以参考本站教程 1Panel 安装，因为真的很好用！

以下是操作步骤

安装 Koishi

此处只写 1Panel 的安装方式，就不写终端命令的方式了（问就是懒）

1Panel 安装 Koishi 很简单，直接在 1Panel 应用商店搜索安装就可以，如果没有装 MySQL，会提示先安装 MySQL，同样也是在应用商店一键安装，可以调整用户和密码，其他不用动，Koishi 安装记得勾选上 端口外部访问 ! MySQL 可以不用，因为不会从外部访问 MySQL

Koishi 默认安装在 5140 端口，安装好之后可以使用 ip:5140 访问 Koishi

部署 Napcat-docker

Napcat-docker 是 Napcat 基于 Docker 容器的版本，旨在简化 NapCat 应用的部署和管理。

使用 1Panel 部署需要修改的配置如下图所示，在镜像处手动输入 mlikiowa/napcat-docker:latest 以及重启规则那里选择一直重启，其他设置如图即可

Napcat Docker 配置

成功运行之后查看一下 Docker 日志，在日志中会有 Token，记录一下，后续使用 Napcat WebUI 登录需要用到这个 Token

部署 Napcat WebUI

我个人来说不喜欢命令行操作，因此我倾向于部署一个可视化的 Napcat WebUI 来方便登录和管理账号

该 WebUI 可以使用 Vercel 一键部署，然后绑定自己的域名

步骤如下：

  1. 将此仓库进行 Fork
  2. 在 Vercel 上创建新项目
  3. 导入已 Fork 的仓库

  4. 配置项目设置

    • 将构建命令修改为 npm run webui:build
    • 编辑您的自定义域名
  5. 部署项目

部署之后访问，能看到以下的面板就是部署成功了

Napcat WebUI

使用 Napcat WebUI 登录 QQ 账号并管理

在 WebUI 的登录界面输入你的 IP:6099 以及之前记录的 Token，点击登录，如果无法成功登录就是浏览器阻止了请求，去地址栏看看拦截的请求，同意请求，就能进入管理界面了

在 网络配置 栏选择新建 Websocket 客户端 填写如下配置，Token 随意填，用于 Koishi 验证，填写完了点击保存

Websocket Client 配置

使用 Koishi adapter-onebot 插件连接

前往 ip:5140，进入 Koishi 管理面板，左侧边栏选择依赖管理，右上角更新全部依赖。刷新网页之后再次进入，左侧边栏选择插件市场，进入搜索下载 adapter-onebot 插件，点击安装。安装完成之后点击配置，配置如下，selfId 填你在 Napcat 登录的QQ账号，token 是上一步自定义的 Token，用于验证的

Adapter-ontbot 配置

验证连接

连接完成之后，前往沙盒（左侧边栏点击沙盒）验证一下链接是否成功

添加一个用户，然后发送 help 到沙盒，如果机器人成功返回消息，则连接成功！

配置登录验证（可选）

前往 插件配置 -> 分组：console -> auth 插件，配置账号密码，右上角点击启用，就可以开启登陆验证了。开启登陆验证之后能避免别人直接访问你的 Koishi 面板，盗用 API KEY 等隐私信息。

接下来就是自己去插件市场下载想用的插件就可以啦~怎么样，是不是很简单ヾ(≧∇≦*)ゝ

大模型聊天插件的话我推荐 chatluna，功能极多！

以上，有什么疑问尽管在评论区提问哦，我懂的话尽量解答

最后修改：2025 年 02 月 17 日
© 允许规范转载
如果觉得我的文章对你有用，请随意赞赏(☆ω☆)