1. KiraAI v1.6.6 部署全流程解析
作为一个长期关注AI应用落地的开发者,最近在测试KiraAI这个开源项目时发现其1.6.6版本在部署流程上有不少值得分享的细节。这个基于NapCatQQ框架的AI对话系统,通过模块化设计实现了记忆管理、表情调用等特色功能。下面我将结合自己的部署经验,详细拆解每个关键环节。
1.1 环境准备与前置依赖
部署前需要确保系统已安装以下组件:
- Python 3.8+(推荐3.9)
- Git版本控制工具
- Redis 5.0+(用于会话缓存)
- FFmpeg(多媒体处理)
建议使用conda创建独立环境:
bash复制conda create -n kiraai python=3.9
conda activate kiraai
注意:NapCatQQ 4.14.13是必须的前置组件,其WebUI端口6099将作为KiraAI的数据通道。如果遇到端口冲突,需要提前修改NapCat的配置文件config.ini中的web_port参数。
1.2 核心组件部署步骤
- 获取NapCatQQ二进制包:
bash复制wget https://github.com/NapNeko/NapCatQQ/releases/download/v4.14.13/NapCatQQ-v4.14.13-linux-x64.zip
unzip NapCatQQ-v4.14.13-linux-x64.zip
- 克隆KiraAI仓库:
bash复制git clone https://github.com/xxynet/KiraAI.git
cd KiraAI
git checkout v1.6.6
- 安装Python依赖:
bash复制pip install -r requirements.txt
- 配置文件初始化:
复制示例配置并修改关键参数:
bash复制cp config.example.yaml config.yaml
需要特别关注的配置项:
yaml复制napcat:
webui_url: "http://127.0.0.1:6099" # 必须与NapCat实际端口一致
api_key: "your_napcat_api_key" # 在NapCatWebUI的密钥管理中获取
memory:
max_length: 15 # 会话记忆最大保存轮次
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 系统启动与验证
2.1 启动顺序与端口说明
正确的启动顺序应该是:
- 先启动NapCatQQ主程序
- 再启动KiraAI服务
两个核心服务的默认端口:
- NapCat WebUI:6099(文件管理和基础API)
- KiraAI Admin:5267(记忆管理和系统监控)
启动命令示例:
`
