如何在您的QQ机器人中集成 码本 AI 模型!
开源技术栏
通过使用此工具,您可以轻松地将 码本 API 服务 集成到您的 QQ 机器人 中,实现快速部署和运行。
这个工具专为简化复杂流程设计,即便是初学者也能轻松上手,让您的机器人拥有智能对话能力。
目录
文章目录

如果需要体验线上机器人,可以进入群体验哦!!
qq-ai-bot-codeBook
我们提供一个高效且易于配置的QQ机器人解决方案,支持无缝接入码本翻译官API和码本大语言模型API。通过简单的配置文件修改,即可快速部署运行。
github: https://github.com/BeardedManZhao/qq-ai-bot-codeBook.git
主要特性:
- 灵活接入:轻松连接至码本翻译API和大语言模型API,无需复杂编码。
- 简易配置:所有外部服务接入设置均通过单一配置文件进行管理,简化了部署流程。
- 即刻运行:完成配置后,机器人即可立即投入使用,为用户提供即时的服务响应
1.前期准备
1.1 下载项目
请访问 github链接 下载项目!
1.2 安装依赖
pip install qq-botpy jieba aiohttp
2.配置文件
# 机器人appId
appid: "*********"
# 机器人安全密钥
secret: "*********"
# 机器人名字
botName: "neko"
# 机器人要绑定的码本用户名
codebook_lyMbl_user_name: "****"
# 机器人要绑定的码本账户对应的密码
codebook_lyMbl_user_password: "********"
# 慰问间隔时间(s)
comfort_interval: 86400
# 用户消息的最大记录数量
userMessageMaxLen: 10
# 群/频道消息的最大记录数量
groupMessageMaxLen: 5
# 每个记录的消息的最大有效时间( s )
userMessageMaxTtl: 7200
# 是否隐藏模型服务,如果隐藏则无法使用模型
needHiddenModule: False
# 模型服务sk
model_server_sk: '********'
# 模型服务id
model_server_id: 49
# 模型的 type 参数 请参考:https://www.lingyuzhao.top/b/Article/377388518747589#model%20%E5%8F%82%E6%95%B0
model_server_type: 'cat_neko'
# 群组模型下的 type 参数
model_server_type_group: 'cat_neko_group'
# 模型的 model 参数 请参考:https://www.lingyuzhao.top/b/Article/377388518747589#type%20%E5%8F%82%E6%95%B0
model_server_model: 'model01'
# 可处理图像的模型 model 参数 请参考:https://www.lingyuzhao.top/b/Article/377388518747589#type%20%E5%8F%82%E6%95%B0
model_server_model_image: 'model03'
# 翻译服务sk
translate_server_sk: '********'
# 翻译服务id
translate_server_id: 46
3. 启动项目
python qqgroup-ai-bot.py <配置文件路径>
4. 内置指令 - qq指令
指令 | 指令类型 | 语法格式 | 详细信息 |
---|---|---|---|
/now | 用户指令 | 无需参数 | 查询当前时间 |
/testArgs | 用户指令 | /testArgs <参数1> <参数2> | 测试参数是否正常 |
/翻译 | 用户指令 | /翻译 <源语言> <目标语言> <需要被翻译的字符串> | 翻译一个文本 |
/我是谁 | 用户指令 | 无需参数 | 查询您在neko眼中的用户名(因为qq不给机器人关于您的qq账号信息,所以机器人会为您生成一个id或用户名) |
/历史消息 | 用户指令 | 无需参数 | 查询您所在空间的历史消息(暂时停用) |
/清理 | 用户指令 | 无需参数 | 清理当前用户空间的上下文,用于开启新的话题 |
/设置类型 | 管理员指令 | /设置类型 <模型type参数> <模型model参数> | 切换使用的模型,详细的选项可以在 码本AI详情 查询 |
/切换流模式 | 用户指令 | 无需参数 | 如果机器人需要回复快速连贯,请启用流模式,如果需要规范模板(如代表多级标题的回复)则可以关闭流模式,流模式可以更快更像人一样的回复 |
/切换指令开关 | 管理员指令 | 无需参数 | 切换指令开关,如果需要机器人对接一些高级功能,如发送邮件,则需要打开此模式!此模式的关闭对模型的回复速度会稍微加快 |
/配置查询 | 用户指令 | 无需参数 | 查询当前所处空间的配置信息 |
/注册 | 用户指令 | 无需参数 | 通过Neko注册码本账号(暂时是引导到网站注册账号,后续会接入自动注册的!!) |
/管理员 | 管理员指令 | /管理员 <添加/删除/启用/禁用> <添加和删除需要填写的用户id> | 对一个用户进行管理员赋权或移除权限,同时可以设置启用或禁用管理员模式 |
/在线统计 | 用户指令 | 无需参数 | 对在线的用户进行活跃度统计,以及统计在线人数 |
4.1 什么是空间
neko 会给每一个用户或者群单独分配一个空间,用于存储共享的数据,包括但不限于配置信息,消息记录
私聊的情况下,用户单独成为一个空间
频道/群聊的区块下,群的所有用户组成一个空间,当人员发生变动的时候,neko的空间也会同步数据
4.2 关于空间中的配置
当我们执行了 /配置查询
操作的时候,neko会回复当前空间的配置信息以及对应的值,我们在这里对值进行解释
配置项目 | 数据类型 | 如何修改 | 项目的意义 |
---|---|---|---|
管理员表 | json或字符串 | /管理员 | 如果启用了管理员校验功能,则这里会显示管理员的json列表,其中key是管理员的id,value是管理员的优先级,优先级值越小,优先级越高 |
群组模式 | 布尔 | 无法修改,此值在空间初始化时已经固定 | 如果当前空间属于群聊/频道 则会初始化为 True |
模型指令 | 布尔 | /切换指令开关 | 如果为 True 代表当前启用了模型指令 |
模型型号 | 字符串 | /设置类型 | 在 码本AI详情 查询 |
数据风格 | 字符串 | /设置类型 | 在 码本AI详情 查询 |
聊天模式 | 字符串 | /切换流模式 | 如果值 包含 stream 代表当前启用了流模式 |
最后登录 | 字符串 | 启用模型指令后,通过neko登录码本账号 | 如果值是您的码本用户名,则代表您已经登录了码本账号! |
history_chat | 枚举【未找到 or 已启用 】 | 无法修改,此值由系统自动处理 | 此数值代表的就是您的消息记录是否被持久化记忆,如果是 已启用 则代表消息记录已经记忆完毕,作为用户无需关注此参数 |
5. 内置指令 - 模型指令
模型指令是神经网络中的内置功能,它会根据用户的需求来调用~ 会自动识别意图
模型指令是一直在变化的哦~ 请和机器人直接对话 小家伙,查询一下系统支持的功能和帮助信息
这类的句子,机器人会回复给您,她自身支持的功能!
下面是一个示例
6. 隐藏小功能
6.1 慰问
neko 会在您不在的时候,偷偷利用码本录的系统给您发送消息哦~
触发条件
- 您需要在私聊页面,通过 neko 登录您的码本录账号!
- 您需要在私聊页面和 neko 交流对话,让neko记住您
- 您需要等待一段时间(就是配置
comfort_interval
的值)以下的时间内,neko会偷偷给您小惊喜- 您需要确保 type 参数是
cat_neko
,当然,如果您没有使用过/设置类型
则不需要担心此问题
若您是开发者,还需要以下操作
- 您需要确保neko系统不重启,因为重启后重新等待时间
- 您需要为 neko 配置一个码本的用户名和密码,就是配置项目
codebook_lyMbl_user_name
和codebook_lyMbl_user_password
6.2 意图识别
neko 可以根据您的话语使用电脑来执行一些操作,包括但不限于 上网搜索数据,查询当前时间,持久化保存数据
6.3 none 自定义引导
当您将 neko 设置为 none
的type 的时候,您可以使用自己的话语来引导她,实现自定义角色的效果~
6.4 关于码本账号
码本账号是独立于 qq 的一套系统,由于qq不允许机器人主动发送消息之类的功能,导致可玩性大大降低,因此您可以选择通过 neko 登录码本录,实现更多有序的功能拓展
具体操作如下
6.4.1 启用模型指令
您需要调用 /切换指令开关
来将指令切换到启用状态!
6.4.2 直接和neko对话 登录码本录
下面是一个示例
7. 实机演示视频
操作记录
作者:zhao
操作时间:2025-04-06 13:46:29 星期日 【时区:UTC 8】
事件描述备注:保存/发布
中国 天津市 天津
操作记录
操作人员:zhao
操作时间:2025-04-11 18:11:41 星期五
事件描述备注:复制了源文章对应的markdown
文本!
中国 天津市 天津