一个跑在本地机器上的个人 QQ 助手。
功能: 基于openclaw和python的 个人助手 + 扮演群聊群友 + 轻量agent + 乐鑫VoCat喵伴终端
- QQ 通-> NapCat -> 本地抓取日志
- 本地 Python 服务接 webhook
- 根据内容做分流
- 能本地处理的直接处理
- 不确定的再交给模型
QQ → NapCat → webhook → bridge → routing → QQ / 设备 / 任务
实践功能:
- 私聊收发
- 群聊按规则触发(白名单 / 艾特 / 全局)
- 每个群可以单独配置行为
- 判断消息类型 -> 决定路径
- 天气 / 提醒 / 课程这类直接本地处理
- 其他交给模型(Kimi / OCAI)
- 私聊里添加提醒
- 到时间自动发 QQ
- 每日固定任务(睡觉 / 明日课程)
设备侧作为终端:
- 语音输入 → 本机处理
- 本机结果 → QQ + 设备播报
- 表情(EAF)+ TTS
- 本机命令队列(poll / ack)
使用方式:
对设备说话 → 本机处理 → QQ收到 + 设备播报
QQ发命令 → 设备直接执行
- 所有行为写入 bridge.log
- 群聊 / 私聊 / vocat / scheduler / skill 可区分
- web控制台: 'http://127.0.0.1:5000/admin/groups': 包含日志中心、群聊规则配置、VoCat调试、私聊调试
candace-ai-agent/
├── qq-ai-bridge/ 核心逻辑:webhook / routing / scheduler
├── pc-agent/ 桌面自动化相关
├── docs/ 文档(MkDocs)
├── requirements.txt
└── README.md
私聊:
QQ 私聊
→ webhook
→ routing
→ 本地逻辑 / 模型
→ 回复 QQ
群聊:
群消息
→ 判断是否触发
→ routing
→ 回复 / 表情 / 忽略
VoCat:
语音
→ ASR
→ 本机 webhook
→ bridge 处理
→ 返回文本 + 表情
→ 播报 + 切表情
scheduler:
定时任务
→ 本地触发
→ 发 QQ
→ 可同步设备播报
最短启动路径:
git clone
cd candace-ai-agent
python3 -m pip install -r requirements.txt
runai
前提:
- NapCat 已配置 webhook
- QQ 已登录
- 环境变量已设置
📖 完整安装指南:
https://candacezcc.github.io/candace-ai-agent/