QQ 机器人
配置扫码或应用凭据、群提及、媒体输入和连接恢复。
This page has not been translated into English yet. The original Chinese version is shown below.
QQ 渠道可以在首次启动时扫码，也可使用既有 AppID/AppSecret。没有配置应用凭据时，启动流程显示二维码；已保存的凭据会在以后复用。
配置方式
{
"channels": {
"qq-work": {
"type": "qq",
"privatePolicy": "pairing",
"groupPolicy": "disabled",
"sessionScope": "user",
"cwd": "/path/to/project"
}
}
}qwen channel start qq-work手动配置时，在渠道对象加入 appID 和 appSecret，注意 appID 的大写 ID；appSecret 可以写 $QQ_APP_SECRET 引用环境变量。sandbox 默认 false，设为 true 使用 QQ 的 sandbox.api.sgroup.qq.com 测试 API，与 agent Shell 沙箱无关。
私聊与群
私聊遵循通用访问策略。群需要另外开启准入，且 QQ API v2 只投递 @机器人消息；即使 requireMention 设为 false，也不能让平台发送所有普通群聊。
回复使用 msg_type 2 的 Markdown。平台拒绝 Markdown 时会尝试纯文本；长内容大约按 2000 字符分块。这是格式回退，不保证所有平台发送失败都能恢复。
图片和视频
入站图片既可送给视觉模型，也保存为临时文件。模型不支持图片时，输入会说明已保存的路径。视频仅提供本地路径，不直接作为模型视频输入。caption 会保留，不另外补造 image/video 占位正文。
图片上限 8 MB、视频上限 20 MB，每条最多处理 5 个；跳过信息写入 stderr。下载文件不会由渠道立即删除，后续清理由系统临时目录策略决定。当前不支持发送图片或视频回复。
如果已知支持图片的模型未被识别，可在对应 provider 模型条目的 generationConfig.modalities.image 设置 true。不要把它误写到无关的顶层 model 字段；也不能借此让本不支持视觉的模型理解图片。
断线与凭据
access token 通常有效约 2 小时，在寿命约 80% 时刷新；刷新失败约 60 秒后重试。WebSocket 断线最多尝试重连 20 次，退避上限 30 秒，并处理会话恢复、心跳确认和重复消息。这些机制不能保证平台长时间故障时持续可用。
AppSecret 失效时更新配置，或停止渠道后移除对应 ~/.qwen/channels/