💬 QQ 接入
👤 适合谁：希望在 QQ 中使用 AI 助手的所有用户
⏱️ 阅读时长：约 5 分钟
💡 一句话：让 YingClaw 成为你 QQ 里的智能助手，随时响应，按需发声。
将 YingClaw 接入 QQ，让它在私聊和群聊中成为一个随时可用的 AI 助手。
接入概览
YingClaw 通过 QQ 开放平台的 WebSocket 连接收发消息，支持文本、图片、@ 提及等消息类型。
| 场景 | 说明 |
|---|---|
| 🤖 私聊助手 | 一对一对话，随时提问 |
| 👥 群聊响应 | 群内 @ 提及时主动回应 |
| 📢 通知推送 | 定时任务结果推送到 QQ |
配置步骤
1. 获取 QQ 开放平台凭证
前往 QQ 开放平台 注册应用，获取：
- App ID：应用唯一标识
- App Secret：应用密钥
2. 在 YingClaw 中配置
登录 YingClaw Web 控制台，进入「通信频道」页面，打开 QQ 开关，填写配置：
| 参数 | 说明 |
|---|---|
app_id | QQ 开放平台分配的 App ID |
app_secret | QQ 开放平台分配的 App Secret |
allowed_users | 允许使用 Bot 的用户白名单，* 表示所有用户 |
3. 启动通道
保存配置后，YingClaw 会自动连接 QQ WebSocket 并开始接收消息。
消息交互
私聊场景
用户直接向 Bot 发送私聊消息，YingClaw 实时响应。支持：
- 💬 自然语言对话
- 📄 文件读写和编辑
- 🔍 信息查询和 Web 搜索
- ⏰ 任务安排和提醒
群聊场景
YingClaw 在群聊中建议配置为仅在 @ 提及时响应，避免打扰正常聊天。
白名单控制
通过 allowed_users 配置控制哪些 QQ 用户可以触发 Bot：
channels:
qq:
allowed_users:
- "123456789" # 仅允许特定 QQ 号
# - "*" # 允许所有用户
注意事项
- 使用专用 QQ 号接入，避免影响个人使用
- 群聊中建议仅 @ 时响应，保护群聊体验
- 定期检查消息记录，确保无异常访问