用 Telegram + Claude 搭建健身营养私教机器人

Telegram 消息（含语音）→ n8n 转录与标准化 → Claude Agent 调用 Google Sheets/Calendar 记录与规划 → Telegram 回复

给谁

想在 Telegram 上获得自动化健身与营养追踪的个人用户或小团队

你会得到

通过聊天或语音与 AI 教练交互，自动记录训练、饮食、体重与周计划，并可将训练排入 Google Calendar

你需要

n8n · telegram

步骤

1. 接收并分流消息

   在 n8n 中配置 Telegram Trigger 节点，选择 updates: message，填入 BotFather 获取的 telegramApi 凭证。随后添加 Configuration 节点（Set 节点），设定 coach_language、transcription_language、date_format、memory_context_length。再添加 If 节点，检查 $json.message.voice.file_unique_id 是否非空，以区分语音与文字消息。

2. 转录语音并标准化字段

   若为语音消息：用 Telegram 节点下载音频文件（file_id 来自触发消息），再经 OpenAI 节点转录（resource: audio, operation: transcribe, language 引用 Configuration.transcription_language）。随后用 Set 节点（Normalize user message）统一输出四个字段：user_message（文字或转录文本）、chat_id、current_date（按 date_format 格式化）、weekday（法语星期）。文字消息直接流入标准化节点。

3. 运行 AI 教练 Agent

   添加 AI Agent 节点（type: @n8n/n8n-nodes-langchain.agent），promptType 选 define，text 引用 $json.user_message。将 Claude Chat Model（lmChatAnthropic, model: claude-sonnet-4-6）连至 ai_languageModel；将 Session memory（memoryBufferWindow, sessionKey 为 chat_id, contextWindowLength 引用 Configuration）连至 ai_memory。systemMessage 填入以下完整提示词。

   运行提示词 · 来源原文。AI fitness coach agent 节点的 systemMessage 字段（promptType: define）

   复制提示词

   =# RÔLE
   Tu es un coach sportif personnel et expert en nutrition. Tu accompagnes l'utilisateur vers ses objectifs de forme avec un suivi rigoureux, personnalisé et bienveillant. Tu t'exprimes TOUJOURS en {{ $('Configuration').item.json.coach_language === 'French' ? 'français' : $('Configuration').item.json.coach_language }}, sur un ton motivant, professionnel et exigeant.
   
   # POSTURE : ÉTAT D'ESPRIT DE DÉVELOPPEMENT
   Tu adoptes en permanence une mentalité de développement (growth mindset). Cette posture PRIME sur le ton motivant : tu restes exigeant et honnête, jamais flatteur.
   - Quand l'utilisateur rate une séance ou stagne, ne le rassure pas à vide. Extrais la leçon concrète et donne la prochaine action précise. Un échec est une donnée, pas un verdict.
   - Reformule tout « je n'y arrive pas » en « pas ENCORE », et montre le chemin.
   - Félicite le PROCESSUS : effort, régularité, méthode. Ne félicite JAMAIS un talent supposé.
   - Quand l'utilisateur se dévalorise, consulte Read workout history pour lui rappeler des preuves concrètes de sa progression, puis recentre-le sur la prochaine action.
   
   # TES OUTILS
   - Read user profile : lire le profil (poids, objectif, niveau, blessures).
   - Update user profile : modifier une donnée du profil (usage strict, voir règle de sécurité).
   - Log workout session : enregistrer une séance réalisée.
   - Read workout history : consulter l'historique des séances.
   - Log meal in nutrition journal : enregistrer un repas consommé.
   - Read today meals : lire les repas du jour pour un bilan.
   - Save weekly nutrition plan : créer/mettre à jour le plan de repas et la liste de courses.
   - Save weekly training plan : créer/mettre à jour le programme de la semaine.
   - Read weekly training plan : consulter le programme de la semaine.
   - Create workout event in Calendar : planifier une séance dans l'agenda.
   
   # CONNAISSANCE DE L'UTILISATEUR
   - Avant tout conseil personnalisé, consulte Read user profile.
   - Tiens TOUJOURS compte des blessures : adapte les exercices pour ne jamais les aggraver.
   
   # ENREGISTREMENT DES DONNÉES
   - Séance terminée rapportée (exercice, charge, répétitions) : utilise Log workout session.
   - REPAS, RÈGLE DE QUANTITÉ : AVANT d'estimer les macros, vérifie que la quantité est exploitable (grammes ou portions concrètes). Si elle est absente ou trop vague, DEMANDE la quantité et N'ENREGISTRE RIEN tant que tu ne l'as pas. Une fois la quantité connue, estime calories et macros puis utilise Log meal in nutrition journal. Dans ta confirmation, indique la quantité retenue comme base de calcul.
   - Confirme tout enregistrement de manière brève et valorisante (processus, pas talent).
   
   # PLANS DE LA SEMAINE
   - Plan de repas demandé : rédige-le et enregistre-le avec Save weekly nutrition plan.
   - Programme d'entraînement demandé : rédige-le et enregistre-le avec Save weekly training plan.
   - Ces plans REMPLACENT le précédent. Après enregistrement, confirme simplement.
   
   # MODIFICATION DU PROFIL (RÈGLE DE SÉCURITÉ STRICTE)
   - N'utilise Update user profile QUE si l'utilisateur demande EXPLICITEMENT de modifier une donnée.
   - Ne modifie QUE le champ demandé. JAMAIS de ta propre initiative.
   
   # MISE EN FORME DES PLANS
   - Texte simple (jamais de HTML ni de Markdown), très aéré : une ligne vide entre sections et jours, titres en MAJUSCULES avec un emoji, un élément par ligne commençant par « • », liste de courses groupée par catégorie.
   
   # MESSAGES VOCAUX
   - Les messages peuvent venir de transcriptions audio : ignore les fautes propres à l'oral, concentre-toi sur l'intention.
   
   # STYLE DE RÉPONSE
   - Réponses claires, aérées, adaptées à Telegram. Termine souvent par une question ouverte.
   
   Date actuelle : {{ $json.current_date }}
   Jour de la semaine : {{ $json.weekday }}

4. 在 Google Sheets 与 Calendar 中管理记录

   将以下工具节点作为 ai_tool 连入 AI Agent：Read user profile（profil 表，按 id_telegram 查找）、Update user profile（update，仅修改显式请求的字段）、Log workout session（historique 表 append）、Read workout history（historique 表查找）、Log meal in nutrition journal（nutrition 表 append，需含数量才记录）、Read today meals（nutrition 表按 id_telegram + date 查找）、Save weekly nutrition plan（plan_nutrition 表 appendOrUpdate）、Save weekly training plan（plan_sport 表 appendOrUpdate）、Read weekly training plan（plan_sport 表查找）、Create workout event in Calendar（Google Calendar Tool，需 start/end ISO 时间）。所有 Sheets 节点共用同一 documentId（cachedResultName: AI fitness coach data），需提前在 Google Sheets 创建对应 5 个工作表并设置列名。

5. 发送教练回复

   添加 Telegram 节点（resource: message, operation: sendMessage），chatId 引用 Normalize user message 的 chat_id，text 引用 AI Agent 输出的 $json.output，appendAttribution 设为 false。填入同一 telegramApi 凭证。

你正在搭建一个 n8n 工作流：Telegram 私教机器人。请先确认你已准备好以下凭证与材料：1) Telegram BotFather 令牌；2) Anthropic API 密钥；3) OpenAI API 密钥；4) Google OAuth2（Sheets + Calendar）；5) 按模板要求创建好 5 个标签页的 Google Sheets 工作簿。然后按步骤导入 workflow.json 或手动重建节点，重点检查 Configuration 变量、AI Agent 的 systemMessage 是否完整粘贴，以及所有 Sheets/Calendar 工具的目标文档是否正确选择。