一个以游戏角色亚托莉为原型的QQ聊天机器人,使用NapCatQQ作为QQ机器人框架,阿里千练(通义千问)作为AI模型服务。
托利亚是一个温柔、自然、有感情的QQ聊天机器人,能够理解用户的情感需求,并以亚托莉的性格特点进行回应,为用户提供真实的陪伴体验。
- 🤖 自然对话:基于大语言模型,生成自然流畅的对话
- 💝 情感陪伴:理解用户情感,提供温柔贴心的回应
- 🎭 角色一致性:保持亚托莉的角色人设和说话风格
- 💬 多场景支持:支持私聊和群聊
- 📝 对话记忆:保存对话历史,支持多轮对话
- QQ机器人框架:NapCatQQ
- AI模型服务:阿里云通义千问(千练)
- 开发语言:Node.js
- 数据库:SQLite
- 日志系统:Winston
托利亚项目/
├── config/ # 配置文件
├── src/
│ ├── bot/ # 机器人核心
│ ├── ai/ # AI模型集成
│ ├── character/ # 角色人设
│ ├── database/ # 数据库
│ └── utils/ # 工具函数
├── data/ # 数据目录
├── logs/ # 日志目录
└── package.json
git clone <项目地址>
cd 亚托利npm install复制 .env.example 为 .env 并填写配置:
cp .env.example .env编辑 .env 文件:
# NapCatQQ配置
NAPCAT_WS_URL=ws://localhost:3000
# 阿里千练配置(DashScope)
# 获取API Key:访问 https://dashscope.console.aliyun.com/api-key_management
QWEN_API_KEY=你的API_KEY
QWEN_MODEL=qwen-turbo
# 数据库配置
DB_TYPE=sqlite
DB_PATH=./data/database.db
# 其他配置
LOG_LEVEL=info
MAX_CONVERSATION_HISTORY=20- 下载并启动NapCatQQ服务
- 配置NapCatQQ的WebSocket地址
- 确保NapCatQQ正常运行
- 注册阿里云账号
- 开通通义千问服务
- 获取API Key和Secret
- 将密钥填入
.env文件
npm startnpm run dev在 config/config.js 中可以配置:
- 机器人名称和触发关键词
- 是否启用群聊/私聊
- AI模型参数(temperature、maxTokens等)
- 对话历史长度限制
在 src/character/character.js 中可以调整:
- 角色性格特点
- 说话风格
- 系统提示词
- 降级回复模板
- 在对应的模块中添加功能代码
- 更新配置文件(如需要)
- 添加日志记录
- 测试功能
日志文件保存在 logs/ 目录:
combined.log- 所有日志error.log- 错误日志
- NapCatQQ配置:确保NapCatQQ服务正常运行,WebSocket地址正确
- API密钥:妥善保管API密钥,不要泄露
- 成本控制:注意API调用量,避免产生过多费用
- 合规使用:遵守QQ平台使用规范
A: 检查NapCatQQ服务是否启动,WebSocket地址是否正确。
A: 检查API密钥是否正确,网络是否正常,查看日志文件获取详细错误信息。
A: 编辑 src/character/character.js 中的角色设定和系统提示词。
MIT License
欢迎提交Issue和Pull Request!
托利亚 - 温柔陪伴你的AI助手 💝