Channels 消息渠道
从聊天、代码平台或邮箱向 Qwen Code 发起任务,选择连接与运行模式。
Channels 把外部消息送到 Qwen Code,再将响应交还原聊天目标。除 IM 机器人,还支持代码平台、DingTalk Workspace 账号和专用邮箱。它会在配置的 cwd 中运行 agent,不是只转发通知的消息服务。
通用配置
配置位于 settings.json 的 channels,键是实例名,type 选择适配器。一个类型可以配置多个实例;token 等秘密可用环境变量引用。
{
"channels": {
"team-bot": {
"type": "telegram",
"token": "$TELEGRAM_BOT_TOKEN",
"privatePolicy": "allowlist",
"allowedUsers": ["123456789"],
"groupPolicy": "disabled",
"sessionScope": "user",
"cwd": "/path/to/project"
}
}
}示例 ID、路径需替换,实际 token 在启动进程环境提供。model 可覆盖默认模型;instructions 加到每个会话首条消息前。approvalMode 作用于该渠道全部会话,不只某一触发方式。
先读这些规则
- 访问与配对:私聊、群、成员和共享操作员分别授权。
- 会话、路由与命名任务:区分对话分区、共享工作区与后台结果归属。
- 渠道记忆:明确存储、确认和共享范围。
- 运行与恢复:独立 ACP 服务和 daemon worker 的区别。
- 调度与输出:忙时消息、持久任务和输出策略。
- Webhook 与联系人:无人值守入口及可观察目标。
- 自定义插件:通过扩展注册新适配器。
文本和附件
图片可作为视觉输入,要求当前模型支持图像;文件先下载成临时路径,再由工具读取。文件传输成功不保证文本模型能理解每种 PDF、视频或二进制内容。
格式、附件限额、群消息可见性与主动投递能力由适配器决定。通用配置中的某个能力存在,不等于所有平台实现它;例如当前 outputMode 只有 DingTalk 接入。
平台接入
本节文档
- 渠道访问、配对与操作员分开控制私聊、群准入、群成员和共享会话管理权限。
- 消息路由与命名任务设置会话范围、前缀路由、持久轮换及单聊天多任务。
- 渠道记忆的作用域与确认按稳定 ID 管理聊天事实,处理自然引用歧义和持久恢复。
- 渠道运行、Daemon 与恢复选择独立 ACP 服务或工作区 worker,核对自动恢复与租约状态。
- 忙时消息、定时任务与输出选择 steering、合并跟进或逐条排队,理解持久 Channel loops。
- 渠道 Webhook 与已观察联系人用独立秘密触发无人值守任务,核对目标身份与投递完成。
- 自定义渠道插件通过扩展注册适配器,并复用准入、会话和命令流程。
- Telegram配置 BotFather 机器人、数值用户 ID、群消息权限和附件输入。
- 飞书与 Lark创建应用、开通事件和权限,配置长连接、卡片回复及媒体下载。
- 钉钉机器人配置 Stream 机器人、连接管理、交互卡片与消息附件。
- 钉钉输出与后台任务比较按轮次、响应和任务发送的策略,识别等待、取消与部分结果。
- DingTalk Workspace通过已登录 DWS 账号接收私聊、群提及和文档评论通知。
- DWS 待办与投递启用原生待办触发,区分 IM 重试队列和评论发送策略。
- Email 邮件渠道通过只读 IMAP 收取任务、SMTP 回复,配置发信人限制与邮件容量。
- 邮件中断与恢复核对待执行 UID 和 SMTP 未知结果,避免重跑不确定的邮件任务。
- GitHub 通知渠道轮询通知触发 Issue 和 PR 任务,配置账号授权与持久恢复。
- GitLab Todos 渠道配置事件模板与项目权限,理解游标、失败及公开回复的限制。
- QQ 机器人配置扫码或应用凭据、群提及、媒体输入和连接恢复。
- 企业微信智能机器人使用 API 模式 BotID 与 Secret,处理群提及、附件和图片回复。
- 微信 iLink扫码登录官方 iLink Bot,配置私聊准入并处理登录过期。