手把手教你搭建QQ机器人（Linux篇）

前情提要：本文适合具有一定动手能力的小白

1. 准备阶段

• 服务器配置：2核4G Linux系统（预算充足可选4核4G），建议选择距离最近的国内地区

• 专用QQ账号：用于搭建机器人

• 可选：LLM API Key（非必须

2.部署koishi

Koishi 简述

Koishi 是一个跨平台、可扩展、高性能的机器人框架，具备以下核心特性：

• 实时监控仪表盘：提供直观的机器人运行状态管理界面。

• 插件生态丰富：通过简单配置即可快速扩展功能，满足个性化需求。

• 多驱动支持：适配多种通信协议，灵活部署于不同平台。

• 高性能数据库：高效处理海量数据，确保稳定运行。

无论是快速搭建还是深度定制，Koishi 都能提供流畅的开发

3.使用面板搭建，适合小白玩家（本文首推

在服务器上安装1panel，在这里放1panel的文档，不做过多描述

在线安装 - 1Panel 文档

1.然后配置镜像加速，国内机需要，国外的可以直接跳过

输入这个地址进去，即可配置成功

https://docker.1panel.live

2.在应用商店-实用工具中找到并安装，记得勾选允许访问外部端口

3.打开http://你的服务器ip地址:5140，来到koishi的控制面板，找到依赖管理，先点击小火箭再点√，确保全部插件和koishi为最新版本

4.在插件商店-适配器，找到Onebot适配器

5.在插件配置中找到刚刚下载的插件，机器人账号填写你要拿来当机器人的QQ号，协议选择与图片中相同

6.下载安装napcat，使用一键脚本部署

curl -o napcat.sh https://nclatest.znin.net/NapNeko/NapCat-Installer/main/script/install.sh && sudo bash napcat.sh

7.安装完成后在终端输入napcat，得到以下

8.输入napcat start 机器人的QQ号，然后使用napcat log 机器人QQ号 来查看日志，在日志中会出现二维码，使用对应QQ号扫码登录即可

9.登录napcat控制面板，默认的登录地址为

http://你的服务器ip:6099/webui/web_login

10.登录密码存储在/opt/QQ/resources/app/app_launcher/napcat/config目录中的webui.json文件中

11.登录面板后来到 网络配置-新建-Websocket客户端，按照图片中的内容输入

12.保存后在 猫猫日志 中观察是否连接成功，同时也在koishi中观察状态是否为绿色，确认正常后就搭建成功了

4.无面板方法

除此之外的其他步骤与3.相同

5.番外篇：bot接入AI大模型

1.在插件市场 - 人工智能 搜索 chatluna（插头露娜），安装这2个插件，推荐搭配NewAPI或者OneAPI等项目食用（你问我为什么？因为这些项目可以统一接口为OpenAI格式，配置多个AI渠道，统一调用）

2.根据自己的需求设置插件，需要2个插件同时开启才可使用

3.在chatluna-openai-like-adapter插件中配置你的NewAPI端点，注意URL的末尾需要加上/v1，例如http://example.com/v1

4.回到chatluna插件，选择模型，以及预设

5.如果需要更改预设，来到 资源管理器 ，跟随下方图片指引修改，更改后保存，需要重载chatluna插件才可以生效

6.必看：关于指令权限与管理

1.未知用户的初始默认权限等级可以在全局设置修改，强烈推荐修改为0级，因为很多指令都是1级可用，别人可以随便使用指令使用你的bot

2.修改指令的等级，这里需要引入一个概念：就是koishi的每个插件都有自己的指令，这些指令要求的使用等级各不相同，可以在指令管理处修改每个指令的使用等级，authority/4为最高级，可以使用一切指令

3.给自己设置最高等级权限，需要开启admin插件

3.1来到 权限管理 首先添加用户组，名字可以随便取，然后添加权限

3.2添加用户，平台名为onebot，账号为你的QQ号，添加完毕后你就拥有了最高权限

指令权限展示示例，我已经设置了help指令为1级，未知用户的权限为0级

拥有最高权限：

陌生用户：

4.额，其实这条和6.没什么关系，是我突然想起来了这个问题，那就是你的QQ机器人如果接入了AI大模型，很可能会被群u当成私人管家使唤，或者在你不知情的情况下被拉到其他群消耗你的token，可以在QQ设置关闭临时对话，装上这个插件可以自动拒绝拉群和加好友行为

7.尾声

koishi的插件生态超丰富，更多插件可以自行探索，这里推荐几个好van的插件，更多插件正在等待你挖掘！

1.@yyyhf/jrcd - 每日查询你的牛牛长度，也可能是... “今天你的牛牛长度是... 哦你今天没有牛牛”

2.group-manage - 管理你的QQ群，可以让bot自动禁言触发敏感词的人，帮助你管理群聊，使用这个插件前请确保你的bot是 群管理/群主

3.ba-logo - 使用ba指令生成碧蓝航线风格logo