สร้างบอท Matrix Echo ในภาษา Python โดยใช้ Simple-Matrix-Bot-Lib

ณ วันที่ 10 ตุลาคม 2026 PyPI แสดงรายการ Simple-Matrix-Bot-Lib เวอร์ชัน 2.13.1 ซึ่งเผยแพร่เมื่อวันที่ 29 มีนาคม 2026 แพ็กเกจนี้ต้องการ Python 3.9 หรือใหม่กว่า แต่ Python 3.9 หมดอายุการใช้งานแล้ว โปรดใช้ Python เวอร์ชันที่ได้รับการดูแลรักษาซึ่งแพ็กเกจนี้รองรับ เอกสารประกอบโครงการที่เผยแพร่บน PyPI ยังคงระบุเวอร์ชันเป็น 2.11.0 และเตือนว่าไม่มีการดูแลรักษาแล้ว ดังนั้นคู่มือนี้จึงใช้ตัวอย่าง PyPI ปัจจุบันสำหรับ API ของบอท และใช้คู่มือฉบับเก่าเฉพาะสำหรับหมายเหตุการกำหนดค่าที่ระบุไว้อย่างชัดเจนเท่านั้นตรวจสอบการเผยแพร่แพ็กเกจและข้อมูลเมตาบน PyPIอ่าน สถานะเอกสาร ประกอบโครงการ

วิธีการตั้งค่าที่รวดเร็วและน่าเชื่อถือที่สุดคือ การมีผู้ใช้ Matrix เฉพาะรายหนึ่ง สภาพแวดล้อมเสมือน Python และบอทตอบกลับขนาดเล็กที่ตอบสนอง!echoในห้องทดสอบ ตัวอย่างนี้ใช้สำหรับห้องที่ไม่ได้เข้ารหัส หากต้องการตั้งค่าห้องที่เข้ารหัสเพิ่มเติมจะต้องใช้การตั้งค่าเพิ่มเติม

คุณต้องเตรียมอะไรบ้างก่อนติดตั้งไลบรารี?

สร้างหรือขอบัญชีผู้ใช้ทั่วไปบนโฮมเซิร์ฟเวอร์ที่จะใช้รันบอท ตั้งชื่อผู้ใช้ให้ไม่ซ้ำใคร เช่นecho_bot; ไม่จำเป็นต้องมีสิทธิ์ผู้ดูแลระบบโฮมเซิร์ฟเวอร์ การลงทะเบียนอาจถูกปิดใช้งานหรือจำกัดโดยเซิร์ฟเวอร์นั้น ดังนั้นโปรดปฏิบัติตามนโยบายการสร้างบัญชีของเซิร์ฟเวอร์นั้น เชิญบัญชีดังกล่าวเข้าร่วมเฉพาะห้องทดสอบส่วนตัวที่อนุญาตให้ส่งข้อความได้เท่านั้น

ควรใช้ Python 3.11 หรือเวอร์ชัน Python อื่นที่ได้รับการสนับสนุนในปัจจุบัน แม้ว่าข้อมูลเมตาของแพ็กเกจจะยังอนุญาตให้ใช้ Python 3.9 ได้ แต่ Python.org ได้ระบุว่าเวอร์ชันนั้นจะหมดอายุการใช้งานในวันที่ 31 ตุลาคม 2025 ดังนั้นเวอร์ชันขั้นต่ำของแพ็กเกจจึงไม่ใช่คำแนะนำที่ดีสำหรับการใช้งาน ดูประกาศการสนับสนุน Python 3.9 ของ Python.org

วิธีการติดตั้ง Simple-Matrix-Bot-Lib ทำอย่างไร?

เรียกใช้คำสั่งเหล่านี้จากโฟลเดอร์โปรเจ็กต์ใหม่ สภาพแวดล้อมเสมือนจะแยกแพ็กเกจของบอทนี้ออกจากโปรเจ็กต์ Python อื่นๆ การกำหนดเวอร์ชันที่แน่นอนจะทำให้ตัวอย่างสามารถทำซ้ำได้กับเวอร์ชันล่าสุดที่ได้รับการตรวจสอบแล้วสำหรับบทความนี้ เมื่ออัปเกรด โปรดตรวจสอบเวอร์ชัน PyPI ปัจจุบันและหมายเหตุเกี่ยวกับความเข้ากันได้

python3 --version
python3 -m venv .venv
source .venv/bin/activate
python -m pip install "simplematrixbotlib==2.13.1"

ใน Windows PowerShell ให้เปิดใช้งานสภาพแวดล้อมโดย ใช้คำสั่ง `git config` .venv\Scripts\Activate.ps1แทน คำสั่ง `git config` sourceจากนั้นสร้างไฟล์ชื่อbot.py`.py` หน้าโครงการของ PyPI จะอธิบายชื่อแพ็กเกจและคำสั่งติดตั้ง และตัวอย่างที่เผยแพร่จะใช้ `python`, `python` Creds, Botตัวรับฟังข้อความ และMessageMatch`python` ดูตัวอย่างการใช้งาน PyPI ปัจจุบันได้ที่นี่

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

จะเชื่อมต่อบัญชีบอทและเพิ่มคำสั่งได้อย่างไร?

บันทึกข้อความต่อไปนี้เป็นbot.py. ระบบจะขอรหัสผ่านบอทเมื่อเริ่มต้นทำงาน ดังนั้นรหัสผ่านจึงไม่ได้ถูกเขียนลงในไฟล์ต้นฉบับ สำหรับการใช้งานบริการแบบอัตโนมัติ ให้ดึงข้อมูลลับจากตัวจัดการข้อมูลลับของระบบปฏิบัติการหรือตัวแปรสภาพแวดล้อมที่ได้รับการป้องกันแทนที่จะเขียนลงในโค้ดโดยตรง ควรเก็บรักษาข้อมูลเซสชันหรือโทเค็นการเข้าถึงที่สร้างโดยไลบรารีไว้เป็นข้อมูลประจำตัว: เก็บไว้เป็นส่วนตัวและอย่าให้รวมอยู่ในระบบควบคุมเวอร์ชัน

import getpass
import simplematrixbotlib as botlib

creds = botlib.Creds(
    homeserver="https://matrix.example.org",
    username="echo_bot",
    password=getpass.getpass("Bot password: "),
)
bot = botlib.Bot(creds)
PREFIX = "!"

@bot.listener.on_message_event
async def echo(room, message):
    match = botlib.MessageMatch(room, message, bot, PREFIX)
    if (match.is_not_from_this_bot()
            and match.prefix()
            and match.command("echo")):
        text = " ".join(match.args())
        reply = text or "Usage: !echo <text>"
        await bot.api.send_text_message(room.room_id, reply)

bot.run()

แทนที่ URL ของโฮมเซิร์ฟเวอร์ตัวอย่างด้วย URL หลักของเซิร์ฟเวอร์ของคุณ และใช้ชื่อผู้ใช้และรหัสผ่านบัญชีของบอท ตัวรับฟังจะรับข้อความในห้อง ตรวจสอบMessageMatchให้แน่ใจว่าได้ละเว้นข้อความของตัวเองและจัดการเฉพาะ!echoคำสั่งเท่านั้น การเรียก API จะส่งคำที่เหลือกลับไปยังห้องเดิม ชื่อและการเรียกใช้เมธอดเหล่านี้เป็นไปตามตัวอย่างที่เผยแพร่บน PyPI ของไลบรารี เปรียบเทียบกับคู่มือเริ่มต้นใช้ งานฉบับย่อของ Simple-Matrix-Bot-Lib

หน้าต่างแก้ไข Python แสดงการนำเข้า ข้อความแจ้งขอรหัสผ่าน ข้อมูลรับรองของ Matrix homeserver และ echo_bot และการเริ่มต้นใช้งานบอท
ส่วนที่ใช้ตรวจสอบข้อมูลประจำตัวจะใช้บัญชีเฉพาะและแจ้งให้ป้อนรหัสผ่านแทนที่จะเก็บข้อมูลลับไว้ในไฟล์
ตัวอย่างโค้ด Python ที่แสดงตัวรับฟังเหตุการณ์ on_message_event, การตรวจสอบ MessageMatch และการเรียกใช้ send_text_message
ตัวจัดการจะเพิกเฉยต่อข้อความของบอทเอง จับคู่คำสั่ง !echo และส่งอาร์กิวเมนต์ของคำสั่งนั้นกลับไปยังห้องสนทนา

คุณจะเรียกใช้บอทและตรวจสอบว่ามันทำงานได้อย่างไร?

จากสภาพแวดล้อมเสมือนที่เปิดใช้งานแล้ว ให้เรียกใช้คำสั่ง:

python bot.py

ป้อนรหัสผ่านบัญชีบอทเมื่อได้รับแจ้ง ในห้องทดสอบ ให้ส่งข้อความ!echo helloบอทพื้นฐานที่ใช้งานได้จะตอบกลับhelloหากบอทเงียบ ให้ตรวจสอบว่าบัญชีบอทได้เข้าร่วมห้องนั้นแล้ว ผู้ใช้มีสิทธิ์ส่งข้อความในห้องนั้น URL ของโฮมเซิร์ฟเวอร์ถูกต้อง และข้อความเริ่มต้นด้วยคำนำหน้าที่ถูกต้อง!ปล่อยให้กระบวนการทำงานต่อไป การปิดเทอร์มินัลจะหยุดการทำงานของการใช้งานแบบง่ายๆ นี้

ห้องทดสอบแบบเมทริกซ์ที่แสดงข้อความ @you:example.org ส่ง !echo hello และ @echo_bot:example.org ตอบกลับ hello
ตัวอย่างบทสนทนาในห้องสนทนาแสดงให้เห็นถึงคำขอและคำตอบที่คาดหวังสำหรับคำสั่ง echo ซึ่งเป็นเพียงภาพประกอบ ไม่ใช่ผลการทดสอบจริง

ตัวอย่างนี้ไม่ได้ประมวลผลข้อความห้องประชุมที่เข้ารหัสแบบ end-to-end (E2EE) ไลบรารีโฆษณาว่ารองรับ E2EE แต่คู่มือที่เผยแพร่ในปัจจุบันมีหมายเลขเวอร์ชัน 2.11.0 และอาจล้าสมัย คู่มือดังกล่าวอธิบายถึงmatrix-nio[e2e]ส่วนประกอบเพิ่มเติมและConfig.encryption_enabledการตั้งค่าบางอย่าง โปรดตรวจสอบขั้นตอนการติดตั้งและการตรวจสอบที่ถูกต้องสำหรับเวอร์ชันที่คุณติดตั้งก่อนเปิดใช้งานการเข้ารหัส เอกสารเก่าๆ ยังมีการjoin_on_inviteตั้งค่าอีกด้วย เชิญบอทเฉพาะในห้องที่ควรเข้าถึงได้ และตรวจสอบการตั้งค่าดังกล่าวหากการใช้งานของคุณต้องควบคุมการเข้าร่วมห้องอัตโนมัติ โปรดตรวจสอบคู่มือ E2EE และการกำหนดค่าของไลบรารี

การตั้งค่าจะเสร็จสมบูรณ์เมื่อบอทยังคงล็อกอินอยู่ เป็นสมาชิกของห้องทดสอบ และตอบกลับ!echo helloด้วยข้อความhello. สำหรับการใช้งานจริง ให้รันบอทภายใต้ตัวจัดการกระบวนการ และปกป้องรหัสผ่านและข้อมูลเซสชันของบอท

ฝากความเห็น

เพิ่มขีดจำกัดไฟล์ Systemd ของ Synapse โดยไม่ต้องคาดเดา

เพิ่มขีดจำกัดไฟล์ Systemd ของ Synapse โดยไม่ต้องคาดเดา

ตรวจสอบว่า Synapse ถึงขีดจำกัดการเปิดไฟล์ต่อกระบวนการแล้วหรือไม่ ตั้งค่า systemd drop-in สำหรับบริการหรือ worker ที่ถูกต้อง และตรวจสอบขีดจำกัดแบบเรียลไทม์

หากพบข้อความ “ถอดรหัสไม่สำเร็จ” ให้กู้คืนรหัสห้องที่หายไป

หากพบข้อความ “ถอดรหัสไม่สำเร็จ” ให้กู้คืนรหัสห้องที่หายไป

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

ล้างข้อความและไฟล์มีเดียเก่าๆ ของ Synapse โดยไม่สูญเสียข้อมูล

ใช้ API สำหรับล้างประวัติและสื่อของ Synapse หรือการตั้งค่าการเก็บรักษาข้อมูลเพื่อลบข้อมูลที่ล้าสมัยอย่างปลอดภัย จากนั้นตรวจสอบความสมบูรณ์และการกู้คืนพื้นที่ดิสก์

สร้างบอท Matrix Echo ในภาษา Python โดยใช้ Simple-Matrix-Bot-Lib

สร้างบอท Matrix Echo ในภาษา Python โดยใช้ Simple-Matrix-Bot-Lib

ติดตั้งไลบรารีเวอร์ชันปัจจุบัน เชื่อมต่อบัญชี Matrix เฉพาะ และเรียกใช้บอท !echo ขนาดเล็กที่มีการจัดการข้อมูลประจำตัวที่ปลอดภัยยิ่งขึ้นและการทดสอบที่ชัดเจน

เชื่อมต่อ Matrix กับ WhatsApp, Telegram และ Discord ด้วยบริดจ์แยกต่างหาก

เชื่อมต่อ Matrix กับ WhatsApp, Telegram และ Discord ด้วยบริดจ์แยกต่างหาก

ตั้งค่าบริดจ์ Mautrix สามตัว โดยแยกการลงทะเบียน การเข้าสู่ระบบ และการทดสอบออกจากกัน เพื่อหลีกเลี่ยงปัญหาที่อาจเกิดขึ้นจากการเชื่อมต่อเครือข่าย Docker นโยบายบัญชี และการซิงค์ข้อมูล

เรียกคืนพื้นที่ดิสก์ Synapse Media โดยไม่ทำให้ไฟล์ที่แชร์เสียหาย

ค้นหาสิ่งที่กำลังทำให้พื้นที่เก็บข้อมูลของ Synapse เต็ม ตั้งค่าการเก็บรักษาข้อมูลสื่ออย่างปลอดภัย และล้างแคชระยะไกลโดยไม่ต้องลบไฟล์โดยตรงจากดิสก์

ปิดใช้งานผู้ใช้ Matrix ที่ไม่ได้ใช้งานโดยไม่ต้องลบประวัติห้อง

ปิดใช้งานผู้ใช้ Matrix ที่ไม่ได้ใช้งานโดยไม่ต้องลบประวัติห้อง

ตรวจสอบกิจกรรมของอุปกรณ์ ปิดใช้งานบัญชี Synapse ที่ได้รับการยืนยันว่าไม่ได้ใช้งานผ่านทาง Admin API และเรียนรู้ว่าตัวเลือก "ลบข้อมูล" นั้นลบอะไรออกไปบ้าง

ลดภาระการใช้หน่วยความจำของ PostgreSQL ใน Matrix Synapse

ตรวจสอบว่าหน่วยความจำของ PostgreSQL มาจากงานประมวลผลคำสั่งค้นหา บัฟเฟอร์ที่ใช้ร่วมกัน การเชื่อมต่อ หรือการบำรุงรักษา จากนั้นทำการเปลี่ยนแปลงที่ปลอดภัยต่อการใช้งาน Synapse ตามเป้าหมาย

เหตุใดการเข้าร่วมห้องสนทนา Matrix Synapse จึงช้า และควรตรวจสอบอะไรบ้าง

เหตุใดการเข้าร่วมห้องสนทนา Matrix Synapse จึงช้า และควรตรวจสอบอะไรบ้าง

ตรวจสอบการเข้าร่วมห้อง Matrix ที่ช้าไปยังโฮมเซิร์ฟเวอร์ระยะไกลเครื่องใดเครื่องหนึ่ง การหน่วงเวลาของเฟเดอเรชัน การโหลดฐานข้อมูลภายใน หรือคิวผู้ส่งขาออก ก่อนที่จะเปลี่ยนการตั้งค่า Synapse

ปิดการลงทะเบียนผ่าน Matrix หรือกำหนดให้ต้องใช้โทเค็นเชิญบน Synapse

หยุดการสร้างบัญชีแบบเปิดบนเซิร์ฟเวอร์ Synapse ที่โฮสต์เอง หรือจำกัดการลงทะเบียนเฉพาะผู้ได้รับเชิญเท่านั้น โดยใช้โทเค็นการลงทะเบียนที่มีจำนวนการใช้งานจำกัด