Channels 消息渠道
从聊天、代码平台或邮箱向 Qwen Code 发起任务,选择连接与运行模式。
This page has not been translated into English yet. The original Chinese version is shown below.
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 接入。
平台接入
In this section
- 渠道访问、配对与操作员分开控制私聊、群准入、群成员和共享会话管理权限。
- 消息路由与命名任务设置会话范围、前缀路由、持久轮换及单聊天多任务。
- 渠道记忆的作用域与确认按稳定 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,配置私聊准入并处理登录过期。