用 n8n 搭建支持文本与语音的 Telegram AI 对话机器人

Telegram 消息触发 → 文本/语音分流处理 → AI Agent 生成回复 → 返回 Telegram

给谁

需要在 Telegram 上快速部署 AI 对话机器人的运营者或开发者

你会得到

获得一个能同时处理文本和语音消息、带打字指示器的 Telegram 机器人，默认使用 GPT-4o

你需要

n8n · telegram

步骤

1. 准备凭证与 Bot

   在 Telegram 中联系 @BotFather 创建机器人并获取 bot token。在 n8n 的 Credentials 中添加 telegramApi 凭证（填入 bot token）和 openAiApi 凭证（填入 OpenAI API Key）。如需语音转录，额外准备语音转录服务的凭证（模板默认使用 OpenAI Transcribe）。

2. 导入工作流并配置节点

   从模板导入 workflow.json。检查以下关键节点配置： - **Telegram Trigger**：确认 updates 包含 message，选择已创建的 telegramApi 凭证。 - **Text Or Voice (Switch)**：保持默认分支条件——上分支检测 `{{ $json.message.text }}` 存在（文本消息），下分支检测 `{{ $json.message.voice.file_id }}` 存在（语音消息）。 - **OpenAI Chat Model**：默认模型为 gpt-4o，可点击切换为 gpt-4 或其他可用模型。 - **Simple Memory**：sessionKey 设为 `={{ $json.sessionId }}`，contextWindowLength 为 10。 - **AI Agent**：promptType 为 define，text 输入为 `{{ $json.message.text }}`；options.systemMessage 见下一步提示词。 - **Send Response To Telegram**：text 为 `{{ $json.output }}`，chatId 引用 Telegram Trigger 的 chat.id，additionalFields.appendAttribution 设为 false。 所有凭证节点需更新为实际凭证，不可保留 credential-id 占位。

   运行提示词 · 来源原文。AI Agent 节点的 options.systemMessage 字段

   复制提示词

   =# Overview
   You are a personal assistant that helps user to fulfill their request.
   
   When you are asked to perform a task on the current date, please use the current time and date: {{$now}}
   
   ## Output
   You should output the result and don't include any link. Just mentioned where you added it to.

3. 配置 Telegram Webhook 与公网访问

   确保 Telegram 能回调到你的 n8n 实例： - 若使用 n8n Cloud，webhook 通常自动配置。 - 若自托管，需通过反向代理或隧道工具（如 ngrok）暴露 n8n 的 webhook URL，并在 Telegram 设置 webhook（可用 `https://api.telegram.org/bot<TOKEN>/setWebhook?url=<WEBHOOK_URL>`）。 Telegram Trigger 的 webhookId 在导入后由 n8n 自动生成，通常无需手动修改。

4. 测试工作流

   激活工作流。在 Telegram 中向你的机器人发送： 1. 一条文本消息，观察是否收到 AI 回复； 2. 一条语音消息，观察是否先转录再收到文本回复； 3. 检查回复前是否出现"正在输入…"指示器。 若语音分支未正常工作，检查 Get Voice 节点是否正确获取 file_id，以及 Transcribe The Voice 节点的 openAiApi 凭证是否有效。

你正在协助复现一个 n8n 模板：Telegram AI 对话机器人。请先确认用户已具备以下条件再开始：可公网访问的 n8n 实例、Telegram bot token、OpenAI API Key。然后按步骤指导导入 workflow.json、更新凭证、配置 webhook，并解释 AI Agent 的系统提示词用途。不要替用户执行敏感操作（如暴露 token）。