Telegram

Telegram 渠道使用 BotFather 创建的机器人。先通过 /newbot 取得 token，再准备允许访问者的数值用户 ID；用户名不能替代 allowedUsers 中的 ID。

配置并启动

将下面内容合并到 settings.json；把示例 ID 和工作区换成实际值，在启动进程环境中提供 TELEGRAM_BOT_TOKEN。

{
  "channels": {
    "telegram-work": {
      "type": "telegram",
      "token": "$TELEGRAM_BOT_TOKEN",
      "privatePolicy": "allowlist",
      "allowedUsers": ["123456789"],
      "groupPolicy": "disabled",
      "sessionScope": "user",
      "cwd": "/path/to/project"
    }
  }
}

qwen channel start telegram-work

从允许的账号私聊机器人。使用 /clear 可清空当前会话；更多本地命令、审批和忙时行为见渠道调度。

接收群消息

在 BotFather 关闭 Group Privacy 后，将机器人移出群再重新加入，以更新 Telegram 缓存的权限。与此同时，Qwen Code 的 groupPolicy 也必须放行群；仅修改平台设置不会绕过本地准入。

群内默认要求 @机器人。采用 pairing 时先批准整个群，群成员默认可发起请求；若只允许部分成员，应另外配置 groups 的 senders 和 allowedUsers。共享会话的取消、清空、审批等操作还受 operators 控制，详见访问与配对。

图片、文件和回复

照片及 caption 会传入任务；理解照片要求模型支持视觉。文档作为附件下载，官方渠道指南给出的 Bot API 文件限制为 20 MB。附件拿到本地路径，不代表所有格式都能由当前模型读取。

回复把常见 Markdown 转成 Telegram HTML，支持代码块、粗体、斜体、链接和列表。超过每条 4096 字符的内容会拆成多条消息。遇到群里无响应，依次核对平台隐私设置、群准入、提及条件和成员权限。