📚 เอกสาร
ทุกฟีเจอร์ ทุกการตั้งค่า
ทุกสิ่งที่แอปทำและทุกการตั้งค่าที่มี — เขียนขึ้นสำหรับเวอร์ชันที่คุณใช้อยู่ ตั้งแต่แถบเมนูจนถึงคลังสกิล นี่คือคู่มือฉบับสมบูรณ์
ในหน้านี้
เริ่มต้นด่วน แอปแถบเมนู การตั้งค่า อธิบายไว้ แท็บโมเดล แท็บ Telegram หน้าต่อบอท แท็บแอป สกิลและฟีเจอร์ คลังสกิล อัปเดต ข้อมูล & ความเป็นส่วนตัว การแก้ไขปัญหาเริ่มต้นด่วน
- ติดตั้ง. ดาวน์โหลดไฟล์ .dmg ลาก Telebot AI ไปที่ Applications บิลด์ยังไม่ผ่านการ notarize ดังนั้นถ้า macOS แสดงคำเตือน ให้คลิกขวา (Control-click) ที่แอปแล้วเลือก เปิด — แค่ครั้งเดียว
- สร้างบอท. ส่งข้อความหา @BotFather บน Telegram รัน /newbot แล้วคัดลอกโทเคน หนึ่งโทเคนต่อหนึ่งบอท — รันได้หลายตัว
- เพิ่มโทเคน. เปิด Telebot AI จากแถบเมนู เปิดการตั้งค่า แล้ววางโทเคนลงในช่อง โทเคน ของบอท มันถูกบันทึกทันทีที่คุณพิมพ์ — ไม่มีปุ่มบันทึก
- เชื่อมต่อสมอง. ในแท็บ โมเดล ตั้ง URL เซิร์ฟเวอร์ (http://localhost:11234 สำหรับ mlx-serve, http://localhost:11434 สำหรับ Ollama) และชื่อโมเดล หรือใช้ API คลาวด์ที่รองรับ OpenAI ตัวใดก็ได้ กด ทดสอบ เพื่อตรวจสอบการเชื่อมต่อ
- เริ่มบอท. กลับไปที่แถบเมนู เลือก เริ่มบอท ส่งข้อความหาบอทของคุณบน Telegram — มันจะตอบตั้งแต่นั้นเป็นต้นไป
เพิ่งเริ่มใช้โมเดลโลคัล? อ่านคู่มือ — ครอบคลุม mlx-serve, Ollama และ LM Studio และแต่ละโมเดลต้องใช้ RAM เท่าไหร่
แอปแถบเมนู
Telebot AI อาศัยอยู่ในแถบเมนูของคุณ (ไอคอน ⌘) เมนูให้คุณ:
- เริ่ม / หยุด / รีสตาร์ท — ทีละบอทหรือทั้งหมดพร้อมกัน บอทรันเป็น LaunchAgents: เปิดตลอดเวลา ไม่กวนคุณ
- เปิดการตั้งค่า — หน้าต่างการตั้งค่า
- บันทึก — ดูบันทึกของบอทแบบเรียลไทม์เพื่อดูว่ามันกำลังทำอะไรหรือแก้ไขปัญหา
- ออก — หยุดทุกอย่าง (และปิดการใช้งาน LaunchAgents จนกว่าจะเริ่มใหม่)
การตั้งค่า อธิบายไว้
หน้าต่างการตั้งค่ามีแถบด้านข้างพร้อมหน้าสองประเภท:
- ค่าเริ่มต้น — โมเดล, Telegram, แอป, สกิลและฟีเจอร์, คลังสกิล, เกี่ยวกับ, อัปเดต ค่าที่ทุกบอทสืบทอด
- บอท — หนึ่งหน้าต่อหนึ่งบอท ทุกช่องแสดงสิ่งที่บอท นี้ ใช้จริง: ค่าที่ตั้งจะแทนที่ค่าเริ่มต้น ช่องว่างจะสืบทอดค่าเริ่มต้น (คำอธิบายใต้แต่ละแถวบอกไว้) นั่นคือเหตุผลที่ไม่มีช่องทำเครื่องหมาย "ใช้แบบทั่วโลก" — ช่องว่าง คือ "ใช้แบบทั่วโลก"
ทุกอย่างบันทึกอัตโนมัติขณะที่คุณพิมพ์หรือสลับ การตั้งค่าอยู่ใน ~/.mlx-serve/config.json
ค่าเริ่มต้น → โมเดล
| การตั้งค่า | มันทำอะไร |
|---|---|
| URL เซิร์ฟเวอร์ | ปลายทางที่รองรับ OpenAI เซิร์ฟเวอร์โลคัลไม่ต้องใช้คีย์ |
| คีย์ API | เว้นว่างสำหรับเซิร์ฟเวอร์โลคัล (mlx-serve, Ollama, LM Studio) ปุ่มรูปตาแสดงหรือซ่อนมัน |
| ชื่อโมเดล | โมเดลตัวไหนบนเซิร์ฟเวอร์นั้น เช่น deepseek-v4-flash-free |
| ทดสอบ | ตรวจสอบการเชื่อมต่อด้วยค่าปัจจุบัน — มีประโยชน์ก่อนบันทึกอะไรก็ตาม |
| โมเดลสำรอง | ลองตามลำดับเมื่อตัวหลักล้มเหลวหรือถูกจำกัด แต่ละตัวมีชื่อเล่น URL คีย์และโมเดลของตัวเอง พร้อมทดสอบ จัดเรียงและลบ ปุ่มเพิ่มจะถูกปิดจนกว่าแถวสุดท้ายจะสมบูรณ์ |
ค่าเริ่มต้น → Telegram
| การตั้งค่า | มันทำอะไร |
|---|---|
| ID แชทที่อนุญาต | ID ผู้ใช้/กลุ่มคั่นด้วยเครื่องหมายจุลภาคที่คุยกับบอทได้ ว่าง = ใครก็ได้ |
| เวลารายงานย่อยรายวัน | เวลาที่บอทส่งรายงานย่อยรายวัน — เมนูเลือกชั่วโมง/นาทีแบบ 24 ชั่วโมง (เช่น 08:00) |
| พรอมต์รายงานย่อย | สิ่งที่รายงานย่อยควรครอบคลุม — เช่น "สภาพอากาศ การเตือนของฉันวันนี้ และการแจ้งเตือนราคาใดๆ" |
| โทเคนตอบสูงสุด | เพดานความปลอดภัยสำหรับคำตอบ; คำตอบยาวจะแบ่งเป็นหลายข้อความ |
| บริบทต่อแชท | จำนวนข้อความล่าสุดที่บอทเก็บต่อแชทเป็นบริบท |
| ความทรงจำต่อผู้ใช้ | ความทรงจำระยะยาวที่ดึงต่อผู้ใช้ ต่อข้อความที่บอทตอบ |
| ขนาดฐานข้อมูลความทรงจำ (ต่อผู้ใช้) | ความทรงจำที่เก็บได้สูงสุดต่อผู้ใช้; เก่าที่สุดจะถูกลบเมื่อเกินนี้ |
| โทเคนรายงานวิจัย | งบประมาณรายงาน /research และ /insiders |
| หมดเวลา API (วินาที) | วินาทีก่อนปล่อยผู้ให้บริการที่ช้า — คิวฟรีอาจค้างเกินหนึ่งนาที |
| ไฟล์ Soul | บุคลิกที่บอทใช้ ไฟล์ .md ในโฟลเดอร์นี้ (soul*.md, *persona*.md) จะปรากฏในเมนู Soul ของทุกบอท |
| คำเรียกบอท | คำคั่นด้วยจุลภาคที่ทำให้บอทตอบในกลุ่ม (นอกเหนือจาก @mention การตอบ หรือคำสั่ง) — เช่น "momo, jarvis, hey bot" |
| คำเรียกคลิปวิดีโอ/เสียง | คำที่ทำให้บอทนำวิดีโอหรือเสียงที่แนบมาเป็นคลิป — เช่น "clip this, save this" |
หน้าต่อบอท
แต่ละบอทในแถบด้านข้างมีหน้าของตัวเอง ช่องว่างจะสืบทอดค่าเริ่มต้น; คำอธิบายใต้แต่ละแถวระบุว่าสืบทอดอะไร
| การตั้งค่า | มันทำอะไร |
|---|---|
| โทเคน | โทเคน @BotFather ของบอท (ปุ่มตาเพื่อแสดง) การเปลี่ยนจะเปลี่ยนชื่อรายการในแถบด้านข้างของบอท |
| ชื่อเล่น | ใช้ในสถานะ บันทึกและแถบด้านข้าง — เช่น "Trading" |
| ID แชทที่อนุญาต / คำเรียก / คำสำหรับคลิป | การแทนที่ค่าเริ่มต้นที่ตรงกันของบอทนี้ |
| URL เซิร์ฟเวอร์, คีย์ API, โมเดล | เมนูเลือกเสนอผู้ให้บริการที่ตั้งค่าไว้ใน ค่าเริ่มต้น → โมเดล รวมถึงค่าที่กำหนดเองใดๆ เพิ่มโมเดลสำรองของตัวเองต่อบอทได้ |
| เวลารายงานย่อยรายวัน / พรอมต์รายงานย่อย | รายงานย่อยต่อบอทพร้อมปุ่ม "ใช้แบบทั่วโลก" ที่ล้างการแทนที่ |
| โหมด | นักวิจัย, ผู้ช่วย, นักเขียนโค้ด, เชฟ หรือไม่มี — ว่าง = ใช้โหมดเริ่มต้น |
| ไฟล์ Soul | การแทนที่บุคลิกของบอทนี้ เลือกจากไฟล์ soul/persona ที่พบในดิสก์ |
| สกิล | เปิดแผ่นสกิลต่อบอท — ปิดสกิลสำหรับบอทนี้เพิ่มจากค่าเริ่มต้น หรือคืนค่าเริ่มต้น |
ค่าเริ่มต้น → แอป
| การตั้งค่า | มันทำอะไร |
|---|---|
| แสดงใน Dock | แอปแถบเมนูจะปรากฏใน Dock ด้วยหรือไม่ |
| เปิดเมื่อเข้าสู่ระบบ | เริ่ม Telebot AI เมื่อคุณเข้าสู่ระบบ |
| ไดเรกทอรีข้อมูล | ที่เก็บการตั้งค่า ความทรงจำ การเตือนและบันทึก (ค่าเริ่มต้น ~/.mlx-serve) |
| เปิดบันทึก / เปิดโฟลเดอร์ข้อมูล | ข้ามไปยังไฟล์บันทึกหรือโฟลเดอร์ข้อมูลใน Finder ทันที |
| ส่งออกการตั้งค่า | บันทึกการตั้งค่าทั้งหมด (รวมคีย์ API) ลงไฟล์ — สำหรับสำรองหรือย้ายเครื่อง Mac |
| นำเข้าการตั้งค่า | โหลดไฟล์การตั้งค่าและนำไปใช้ทันที |
สกิลและฟีเจอร์
ความสามารถของบอทคือสกิลที่ขับเคลื่อนด้วยโมเดล — คำสั่งธรรมดาที่โมเดลทำตามด้วยเครื่องมือของมัน คุณจึงอธิบายสิ่งที่ต้องการเป็นภาษาธรรมดาแทนการท่องจำคำสั่ง แต่ละกลุ่มมีสวิตช์หลัก; เปิดหรือปิดสกิลรายตัวได้
| กลุ่ม | สกิล | ลองพูดว่า |
|---|---|---|
| วิจัย | stock-research, stocks-crypto, insider-trading, currency | "research TSLA", "price of BTC", "insider trades for AAPL", "how much is 50 USD in CAD?" |
| รายวัน | briefing, digest, reminders, habits, review, pomodoro, bookmarks, expenses | "/briefing", "digest this chat", "remind me at 5pm", "mark today's habit done", "weekly review", "/pomodoro 25", "track 25 lunch" |
| สื่อ | media, voice, translation, feeds | "analyze this video", "read this aloud", "translate this to Chinese", "what's new in my feeds?" |
| เครื่องมือ | memory | "what did we talk about yesterday?" |
| จากคลัง | สกิลที่คุณติดตั้งจากคลัง | — |
คลังสกิล
แท็บคลังสกิลให้คุณติดตั้งสกิลสำเร็จรูปจากแคตตาล็อกสาธารณะ anthropics/skills — จัดการ PDF และเอกสาร สเปรดชีต งานนำเสนอ ทดสอบเว็บแอป สร้าง MCP server ศิลปะและอื่นๆ โหลดแคตตาล็อก เลือกสกิล แล้วมันจะปรากฏในแท็บสกิลและฟีเจอร์เหมือนสกิลอื่นๆ
อัปเดต
แท็บอัปเดตตรวจสอบ manifest ของเว็บไซต์เทียบกับเวอร์ชันที่ติดตั้งและแสดงเวอร์ชันล่าสุดพร้อมลิงก์ดาวน์โหลด การตรวจสอบเงียบ — ออฟไลน์หรือเข้าถึงไม่ได้ก็แค่หมายถึง "เป็นเวอร์ชันล่าสุด" วิธีอัปเดต: ดาวน์โหลด .dmg ใหม่แล้วลากทับแอปเก่าใน Applications การตั้งค่า บอทและความทรงจำอาศัยอยู่นอกแอป จึงถูกส่งต่อโดยไม่ถูกแตะต้อง
ข้อมูล & ความเป็นส่วนตัว
- สิ่งต่างๆ อยู่ที่ไหน: การตั้งค่า ความทรงจำแชท การเตือน สกิลและบันทึกทั้งหมดอยู่ในไดเรกทอรีข้อมูลของคุณ (ค่าเริ่มต้น ~/.mlx-serve)
- อะไรออกจาก Mac ของคุณ: API ของ Telegram เอง เซิร์ฟเวอร์โมเดลที่คุณชี้ให้บอทเชื่อมต่อ และสถิติการใช้งานแบบไม่ระบุตัวตน (การเปิดแอปและการกระทำในเมนู) ไม่มีเนื้อหาแชท ไม่มีโทเคน ไม่มีข้อมูลส่วนบุคคล
การแก้ไขปัญหา
- "Apple cannot check it for malicious software" — เป็นเรื่องปกติ: คลิกขวา (Control-click) ที่แอปใน Applications → เปิด → เปิด อีกครั้ง แค่ครั้งเดียว จากนั้นก็รันได้ตามปกติ
- บอทไม่ตอบ. เปิดการตั้งค่า → หน้าของบอท: โทเคนถูกต้องไหม? จากนั้น ค่าเริ่มต้น → โมเดล → ทดสอบ ผู้ให้บริการ แล้วตรวจสอบบันทึก (แถบเมนู → บันทึก หรือแท็บแอป → เปิดบันทึก)
- คำตอบช้าหรือบอทเงียบไป. ผู้ให้บริการฟรีอาจค้างเกินหนึ่งนาที — เพิ่มหมดเวลา API และเพิ่มโมเดลสำรองเพื่อให้บอทสลับไปใช้เมื่อตัวหลักถูกจำกัด
- เซิร์ฟเวอร์โลคัลไม่ตอบสนอง. ตรวจสอบว่าเซิร์ฟเวอร์รันจริง (mlx-serve, Ollama…) ก่อนทดสอบในแท็บโมเดล
- อัปเดตบอก "เป็นเวอร์ชันล่าสุด" แปลกๆ. การตรวจสอบเงียบโดยการออกแบบ — ถ้าเข้าถึง manifest ไม่ได้ก็จะรายงานว่าเป็นเวอร์ชันล่าสุด
- มีปัญหาอื่นหรือ? ส่งข้อเสนอแนะ — ทุกข้อความส่งตรงถึง Telegram ของนักพัฒนาและได้รับคำตอบจริง
ดาวน์โหลด Telebot AI · ชอบไหม? เลี้ยงกาแฟฉันหน่อย ☕