วิธีเชื่อมต่อ Hermes Agent กับ Telegram และจัดการงานจากโทรศัพท์

เมื่อคุณไม่อยู่หน้าคอมพิวเตอร์ คุณสามารถส่งข้อความหรือสั่งงานด้วยเสียงให้ Hermes Agent ใน Telegram จากโทรศัพท์ แล้วรับผลลัพธ์ในแชตเดิมได้ ผลลัพธ์ของงานที่ตั้งเวลาไว้จะส่งไปยังแชตที่คุณกำหนดให้เป็นแชตหลักเพียงครั้งเดียว

หากยังไม่มี Hermes ให้เริ่มจากคู่มือเรื่องเอเจนต์นี้คืออะไรและติดตั้งอย่างไร แล้วกลับมาเชื่อมต่อ Telegram

ดูคำแนะนำเพิ่มเติมได้ในเอกสารประกอบของ Ailoot

ต้องใช้อะไรบ้างเพื่อเชื่อมต่อ Hermes Agent กับ Telegram?#

คำสั่ง hermes doctor ใช้ตรวจสอบการติดตั้ง Hermes และการเชื่อมต่อโมเดล เราจะสร้างบอตในแอป Telegram และคุณต้องใช้คอมพิวเตอร์เพื่อเรียกใช้คำสั่งในเทอร์มินัล

สร้างบอตผ่าน BotFather อย่างไร?#

บอต Telegram ทุกตัวมีโทเค็น ซึ่งเป็นกุญแจลับสำหรับควบคุมบอต Telegram ออกโทเค็นนี้ผ่านบอตทางการ @BotFather

1. เปิด @BotFather

   ค้นหา @BotFather ใน Telegram หรือเปิด t.me/BotFather BotFather ตัวจริงจะมีเครื่องหมายยืนยันสีน้ำเงิน เริ่มการสนทนาโดยแตะ “Start”

2. ส่งคำสั่ง /newbot

   BotFather จะขอชื่อสองชื่อ ชื่อแรกคือชื่อที่แสดง ซึ่งตั้งเป็นอะไรก็ได้ เช่น “My Agent” ชื่อที่สองคือชื่อผู้ใช้ ซึ่งต้องไม่ซ้ำและลงท้ายด้วย bot เช่น moy_agent_bot

3. รับโทเค็น

   BotFather จะส่งข้อความแสดงความยินดีพร้อมสตริงยาวในรูปแบบ 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ นี่คือโทเค็นของบอต คัดลอกสตริงทั้งหมด

ยังมีวิธีที่รวดเร็วซึ่งไม่ต้องสนทนากับ BotFather ด้วยตนเอง ในแดชบอร์ดเว็บ Hermes (hermes dashboard) และแอปเดสก์ท็อป ที่หน้า “Messaging → Telegram” จะมีปุ่ม “Create with QR”: สแกนโค้ดด้วยโทรศัพท์ แล้ว Hermes จะสร้างบอต ตรวจพบ ID ของคุณ บันทึกโทเค็นในการตั้งค่า และเริ่มเกตเวย์ใหม่ ขั้นตอนด้านล่างเป็นวิธีทำด้วยตนเอง หากเลือกใช้ QR ให้ข้ามไปตรวจสอบการเชื่อมต่อได้เลย

หา Telegram ID ได้อย่างไร และต้องใช้ไปทำไม?#

บัญชี Telegram มีตัวระบุสองอย่าง ได้แก่ ชื่อผู้ใช้สาธารณะที่มีเครื่องหมาย @ และ ID ตัวเลขภายใน Hermes ใช้ตัวเลขนี้

วิธี “สร้างด้วย QR” อย่างรวดเร็วที่อธิบายไว้ข้างต้นจะตรวจหา ID ของคุณโดยอัตโนมัติ จดไว้ข้างโทเค็น

มอบโทเค็นให้ Hermes Agent และเริ่มเกตเวย์อย่างไร?#

1. เรียกใช้ตัวช่วยตั้งค่า

   hermes gateway setup
   

   เรียกใช้คำสั่งบนเครื่องที่ติดตั้ง Hermes ตัวช่วยจะแสดงรายชื่อแอปส่งข้อความให้เลือก

2. เลือก Telegram และกรอกรายละเอียด

   ตัวช่วยจะขอโทเค็นของบอตและ ID ที่อนุญาต (ป้อนได้หลายรายการโดยคั่นด้วยจุลภาค) แล้วบันทึกทุกอย่างไว้ในการตั้งค่าโดยตรง

3. เริ่มเกตเวย์

   hermes gateway
   

   เกตเวย์จะเริ่มทำงานและเชื่อมต่อกับ Telegram หลังจากนั้นไม่กี่วินาที ให้ส่งข้อความอะไรก็ได้ถึงบอตจากแอป หาก Hermes ตอบกลับ แสดงว่าการเชื่อมต่อพร้อมแล้ว

วิธีทำด้วยตนเองแทนการใช้ตัวช่วยมีดังนี้: เปิดไฟล์ ~/.hermes/.env แล้วเพิ่มสองบรรทัด โดยแทนที่ด้วยโทเค็นจาก BotFather และ ID ตัวเลขของคุณ:

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789

บรรทัดที่สองอนุญาตคนเหล่านั้นในแชตส่วนตัวและกลุ่ม แต่การให้สิทธิ์ทั้งแชตกลุ่มแยกก็เปิดสิทธิ์เพิ่มได้ คั่นชื่อหลายคนด้วยจุลภาค หลังบันทึกไฟล์แล้ว ให้เริ่มเกตเวย์ด้วยคำสั่งเดิม hermes gateway

หากบอตเงียบแม้แต่ในแชตส่วนตัว ให้ตรวจสอบบันทึกการทำงานของเกตเวย์ในเทอร์มินัลเดียวกัน และตรวจสอบก่อนว่าโทเค็นกับ ID ในรายชื่อผู้ที่มีสิทธิ์เข้าถึงถูกต้องหรือไม่ ข้อผิดพลาดอื่น ๆ อธิบายไว้ในตารางท้ายบทความ

บอต Telegram ทำอะไรบนโทรศัพท์ได้บ้าง?#

มีความสามารถห้าอย่างที่คุณน่าจะใช้บ่อยที่สุดบนโทรศัพท์

ข้อความและข้อความเสียง เขียนงานเป็นข้อความหรือพูดเป็นข้อความเสียง หากตั้งค่าระบบรู้จำเสียงพูดไว้ Hermes จะถอดเสียงและทำความเข้าใจ หากใช้ผู้ให้บริการในเครื่อง ก็ไม่ต้องใช้คีย์ ทุกอย่างจะประมวลผลบนเครื่องที่เอเจนต์ทำงานอยู่

ไฟล์และรูปภาพ คุณส่งต่อเอกสาร สเปรดชีต หรือภาพหน้าจอให้บอตได้ เอเจนต์จะได้รับเป็นไฟล์แนบ และยังส่งไฟล์ที่สร้างขึ้นกลับมาได้ด้วย: ขอรายงาน แล้วเอเจนต์จะส่งเป็นไฟล์ในแชต

การยืนยันก่อนทำสิ่งที่เป็นอันตราย เมื่อเอเจนต์กำลังจะทำสิ่งที่เสี่ยง เช่น ลบไฟล์ เอเจนต์จะถามในแชตก่อน: ตอบ “yes” หรือ “y” เพื่อให้ดำเนินการ หรือตอบ “no” หรือ “n” เพื่อยกเลิก

ใช้ปุ่มแทนการพิมพ์ตอบ เมื่อเอเจนต์ต้องการคำชี้แจง จะส่งคำถามพร้อมปุ่มตัวเลือกแบบอินไลน์ แตะตัวเลือกหนึ่ง แล้วเอเจนต์จะทำงานต่อ คำสั่ง /model เมื่อไม่มีอาร์กิวเมนต์จะแสดงเมนูเลือกโมเดลที่มีปุ่มแบบเดียวกัน

การแจ้งเตือนแบบเงียบ โดยค่าเริ่มต้น โทรศัพท์จะดังเฉพาะคำตอบสุดท้าย คำขอให้ยืนยัน และการยืนยันคำสั่ง การแจ้งเตือนบริการ เช่น “calling a tool” และ “compressing context” จะเข้ามาแบบไม่มีเสียง โทรศัพท์จึงไม่ดังทุกขั้นตอน หากต้องการให้มีเสียงแจ้งเตือนทุกขั้นตอน ให้เปลี่ยนโหมดในการตั้งค่า

รับผลลัพธ์ของงานเบื้องหลังในแชตอย่างไร?#

แชตหลักสำหรับงานที่ตั้งเวลาไว้ Hermes รองรับงานที่ตั้งเวลาไว้ เช่น “ทุกเช้าตอน 7:43 ช่วยทำสรุปให้ฉัน” ระบบจะส่งผลลัพธ์ไปยังแชตหลัก ซึ่งคุณกำหนดครั้งเดียวได้โดยส่งคำสั่ง /sethome โดยตรงในการสนทนากับบอต ตราบใดที่เกตเวย์ทำงานอยู่ สรุปจะมาถึงโดยอัตโนมัติ

งานเบื้องหลัง คุณส่งงานยาวให้ทำในเบื้องหลังแล้วไปทำอย่างอื่นได้ บอตจะแจ้งเมื่อทำเสร็จ งานที่เริ่มจากหัวข้อจะส่งคำตอบกลับไปยังหัวข้อเดิม จึงไม่มีอะไรสูญหาย

ข้อจำกัดสำคัญ: บอตจะตอบเฉพาะตอนที่เกตเวย์ทำงานอยู่ หากปิดคอมพิวเตอร์ที่ใช้ Hermes หรือให้เครื่องเข้าสู่โหมดพัก บอตจะไม่ตอบจนกว่าเครื่องจะกลับมาทำงานอีกครั้ง หากต้องการให้บอตออนไลน์ตลอดเวลา ให้ย้ายเอเจนต์ไปยังเซิร์ฟเวอร์: เรามีคู่มือแยกเรื่องวิธีให้ Hermes Agent ทำงานตลอดเวลา โดยค่าเริ่มต้น เกตเวย์จะคอยตรวจสอบข้อความใหม่ใน Telegram สำหรับแพลตฟอร์มคลาวด์ที่เข้าสู่โหมดพักเมื่อไม่มีทราฟฟิกขาเข้า เอกสารประกอบเสนอให้ใช้โหมด webhook ซึ่งกลับทิศทางการเชื่อมต่อเพื่อให้ Telegram ส่งคำขอไปยังบอตเอง

ป้องกันคนแปลกหน้าไม่ให้เข้าถึงบอตอย่างไร?#

คนอื่นสามารถค้นหาบอตของคุณใน Telegram ด้วยชื่อผู้ใช้ได้ ดังนั้นการป้องกันจึงอาศัยสองอย่าง ได้แก่ รายชื่อผู้ที่มีสิทธิ์เข้าถึงและการเก็บโทเค็นเป็นความลับ

ขั้นแรกตั้งสิทธิ์ผู้ส่งด้วย TELEGRAM_ALLOWED_USERS สำหรับกลุ่มให้ตรวจ TELEGRAM_GROUP_ALLOWED_CHATS ด้วย การใส่ chat ที่นี่อนุญาตสมาชิกทุกคน แม้ sender ID ไม่อยู่ allowlist ส่วนตัว ดังนั้นรายชื่อส่วนตัวว่างเพียงอย่างเดียวไม่พิสูจน์ว่าทุกกลุ่มปิด

อย่างที่สองคือโทเค็น ต้องไม่ปรากฏในภาพหน้าจอ ข้อความที่ส่งต่อ หรือคลังเก็บโค้ด หากโทเค็นรั่วไหล ให้เพิกถอนด้วยคำสั่ง /revoke ใน BotFather จากนั้นป้อนโทเค็นใหม่ในการตั้งค่าและเริ่มเกตเวย์ใหม่

สำหรับกลุ่ม สิทธิ์ผู้ส่งแยกจากสิทธิ์ chat สมาชิกกลุ่มที่อนุญาตผ่าน TELEGRAM_GROUP_ALLOWED_CHATS ใช้บอตได้แม้ ID ไม่อยู่ TELEGRAM_ALLOWED_USERS หากต้องจำกัดรายบุคคล อย่าให้สิทธิ์ทั้งกลุ่ม ให้ตั้งและตรวจข้อจำกัดผู้ส่งสำหรับรุ่นติดตั้ง หากต้องการให้บอตตอบในกลุ่มเฉพาะเมื่อมีคนเรียกใช้ ให้ตั้งค่า telegram.require_mention จากนั้นบอตจะตอบเมื่อมีการกล่าวถึง @ มีคนตอบกลับข้อความของบอต มีคำสั่งอย่าง /command@yourbot หรือข้อความตรงกับรูปแบบใน telegram.mention_patterns และจะเพิกเฉยต่อข้อความทั่วไปในกลุ่ม

ทำไมบอตจึงเงียบในกลุ่ม และแก้ไขอย่างไร?#

บอต Telegram ที่สร้างใหม่จะเปิดโหมดความเป็นส่วนตัวไว้โดยค่าเริ่มต้น เอกสาร Hermes ระบุว่านี่เป็นสาเหตุที่ทำให้เกิดความสับสนกับบอตในกลุ่มบ่อยที่สุด ในโหมดนี้ บอตจะได้รับเฉพาะข้อความที่เริ่มด้วยคำสั่ง / การตอบกลับข้อความของตัวเอง และการแจ้งเตือนบริการเท่านั้น บอตจะไม่ได้รับข้อความทั่วไปในกลุ่ม เพราะ Telegram ไม่ได้ส่งข้อความเหล่านั้นให้ และการตั้งค่าใด ๆ ของเอเจนต์ก็แก้เรื่องนี้ไม่ได้

วิธีแก้:

1. เปิด @BotFather แล้วส่ง /mybots
2. เลือกบอตของคุณ
3. เปิด “Bot Settings” → “Group Privacy” → “Turn off”
4. นำบอตออกจากกลุ่มแล้วเพิ่มกลับเข้าไปใหม่

หลายคนมักพลาดขั้นตอนที่สี่ แล้วบอตก็ “ยังคงเงียบอยู่” Telegram จดจำการตั้งค่าความเป็นส่วนตัวตอนที่บอตเข้ากลุ่ม และจะไม่อัปเดตจนกว่าจะนำบอตออกจากกลุ่มแล้วเพิ่มกลับเข้าไปใหม่

หากไม่ต้องการปิดความเป็นส่วนตัวโดยรวม ยังมีทางเลือกที่สอง: กำหนดให้บอตเป็นผู้ดูแลกลุ่ม บอตที่เป็นผู้ดูแลจะได้รับข้อความทั้งหมดไม่ว่าจะใช้โหมดความเป็นส่วนตัวแบบใด

ข้อผิดพลาดในการเชื่อมต่อที่พบบ่อยและวิธีแก้#

ผู้คนถามอะไรอีกเกี่ยวกับ Hermes Agent ใน Telegram?#

เมื่อพร้อมแล้ว มาทำความรู้จักกับ Ailoot