📚 Tài liệu
Mọi tính năng, mọi cài đặt.
Mọi thứ ứng dụng làm được và mọi cài đặt nó có — viết cho phiên bản bạn đang chạy. Từ thanh menu đến kho kỹ năng, đây là toàn bộ sách hướng dẫn.
Trong trang này
Bắt đầu nhanh Ứng dụng thanh menu Cài đặt, được giải thích Tab Mô hình Tab Telegram Trang của từng bot Tab Ứng dụng Kỹ năng & Tính năng Kho kỹ năng Cập nhật Dữ liệu & quyền riêng tư Xử lý sự cốBắt đầu nhanh
- Cài đặt. Tải tệp .dmg, kéo Telebot AI vào Applications. Bản build chưa được notarized, nên nếu macOS hiện cảnh báo, hãy bấm chuột phải (Control-click) vào ứng dụng và chọn Open — một lần duy nhất.
- Tạo bot. Nhắn @BotFather trên Telegram, chạy /newbot, và sao chép token. Một token cho mỗi bot — bạn có thể chạy nhiều bot.
- Thêm token. Mở Telebot AI từ thanh menu, mở Cài đặt, và dán token vào trường Token của bot. Token được lưu ngay khi bạn gõ — không có nút Lưu.
- Kết nối bộ não. Trong tab Mô hình, đặt URL máy chủ (http://localhost:11234 cho mlx-serve, http://localhost:11434 cho Ollama) và tên mô hình, hoặc dùng bất kỳ API đám mây tương thích OpenAI nào. Bấm Kiểm tra để kiểm tra kết nối.
- Bắt đầu bot. Quay lại thanh menu, chọn Bắt đầu bot. Nhắn cho bot của bạn trên Telegram — từ lúc đó nó sẽ trả lời.
Mới dùng mô hình cục bộ? Đọc hướng dẫn — hướng dẫn này trình bày mlx-serve, Ollama và LM Studio, cùng lượng RAM mỗi mô hình cần.
Ứng dụng thanh menu
Telebot AI sống trong thanh menu của bạn (biểu tượng ⌘). Trình đơn cung cấp cho bạn:
- Bắt đầu / Dừng / Khởi động lại — cho từng bot và tất cả cùng lúc. Bot chạy như các LaunchAgent: luôn bật, không cản trở bạn.
- Mở Cài đặt — cửa sổ cài đặt.
- Nhật ký — xem nhật ký của bot để biết nó đang làm gì hoặc gỡ lỗi sự cố.
- Thoát — dừng mọi thứ (và vô hiệu hóa các LaunchAgent cho đến khi bạn bắt đầu lại).
Cài đặt, được giải thích
Cửa sổ cài đặt có thanh bên với hai loại trang:
- Mặc định — Mô hình, Telegram, Ứng dụng, Kỹ năng & Tính năng, Kho kỹ năng, Giới thiệu, Cập nhật. Giá trị mọi bot kế thừa.
- Bot — mỗi bot một trang. Mỗi trường hiển thị thứ bot này thực sự dùng: một giá trị ghi đè mặc định, một trường trống kế thừa mặc định (phần giải thích dưới mỗi hàng nói rõ điều đó). Đó là lý do không có hộp kiểm "Dùng chung toàn cục" — một trường trống chính là "dùng chung toàn cục".
Mọi thứ tự lưu khi bạn gõ hoặc bật/tắt. Cài đặt nằm trong ~/.mlx-serve/config.json.
Mặc định → Mô hình
| Thiết lập | Tác dụng |
|---|---|
| URL máy chủ | Điểm cuối tương thích OpenAI. Máy chủ cục bộ không cần khóa. |
| Khóa API | Để trống cho máy chủ cục bộ (mlx-serve, Ollama, LM Studio). Nút con mắt hiện hoặc ẩn nó. |
| Tên mô hình | Mô hình nào trên máy chủ đó, vd: deepseek-v4-flash-free. |
| Kiểm tra | Kiểm tra kết nối với các giá trị hiện tại — hữu ích trước khi lưu bất cứ thứ gì. |
| Mô hình dự phòng | Được thử theo thứ tự khi nhà cung cấp chính lỗi hoặc bị giới hạn. Mỗi mô hình có biệt danh, URL, khóa và mô hình riêng, cùng với Kiểm tra, sắp xếp lại và xóa. Nút Thêm bị khóa cho đến khi hàng cuối hoàn chỉnh. |
Mặc định → Telegram
| Thiết lập | Tác dụng |
|---|---|
| ID cuộc trò chuyện được phép | ID người dùng/nhóm phân cách bằng dấu phẩy được phép trò chuyện với bot. Để trống = mọi người. |
| Giờ tóm tắt hàng ngày | Thời điểm bot gửi bản tóm tắt hàng ngày — trình đơn thả xuống giờ/phút theo định dạng 24 giờ (vd: 08:00). |
| Nội dung tóm tắt | Bản tóm tắt nên bao gồm những gì — vd: "thời tiết, lời nhắc hôm nay của tôi, và mọi cảnh báo giá". |
| Token trả lời tối đa | Trần an toàn cho câu trả lời; câu dài được chia thành nhiều tin nhắn. |
| Ngữ cảnh mỗi cuộc trò chuyện | Số tin nhắn gần đây bot giữ mỗi cuộc trò chuyện làm ngữ cảnh. |
| Ký ức mỗi người dùng | Ký ức dài hạn được truy hồi cho mỗi người dùng, cho mỗi tin nhắn bot trả lời. |
| Kích thước cơ sở dữ liệu ký ức (mỗi người dùng) | Số ký ức tối đa lưu mỗi người dùng; bản cũ nhất bị xóa khi vượt quá. |
| Token báo cáo nghiên cứu | Ngân sách cho báo cáo /research và /insiders. |
| Thời gian chờ API (giây) | Số giây trước khi bỏ nhà cung cấp chậm — hàng đợi gói miễn phí có thể kẹt hơn một phút. |
| Tệp Soul | Persona mà bot chạy cùng. Các tệp .md trong thư mục này (soul*.md, *persona*.md) xuất hiện trong trình đơn Soul của mỗi bot. |
| Từ kích hoạt của bot | Các từ phân cách bằng dấu phẩy khiến bot trả lời trong nhóm (ngoài @đề cập, trả lời hoặc lệnh) — vd: "momo, jarvis, hey bot". |
| Từ kích hoạt clip video/âm thanh | Các từ khiến bot coi video hoặc âm thanh đính kèm là clip — vd: "clip this, save this". |
Trang của từng bot
Mỗi bot trong thanh bên có trang riêng. Trường trống kế thừa mặc định; phần giải thích dưới mỗi hàng nêu rõ nó kế thừa gì.
| Thiết lập | Tác dụng |
|---|---|
| Token | Token @BotFather của bot (nút con mắt để hiện). Đổi token sẽ đổi tên mục của bot trong thanh bên. |
| Biệt danh | Được dùng trong trạng thái, nhật ký và thanh bên — vd: "Trading". |
| ID cuộc trò chuyện được phép / Từ kích hoạt / Từ tạo clip | Phần ghi đè của bot này lên các mặc định tương ứng. |
| URL máy chủ, Khóa API, Mô hình | Trình đơn thả xuống đưa ra các nhà cung cấp được cấu hình trong Mặc định → Mô hình, cùng với mọi giá trị tùy chỉnh. Có thể thêm mô hình dự phòng riêng cho từng bot. |
| Giờ tóm tắt hàng ngày / Nội dung tóm tắt | Bản tóm tắt riêng cho từng bot với nút "Dùng chung toàn cục" để xóa phần ghi đè. |
| Chế độ | Nhà nghiên cứu, Trợ lý, Lập trình viên, Đầu bếp hoặc Không — để trống sẽ dùng chế độ mặc định. |
| Tệp Soul | Phần ghi đè persona của bot này, chọn từ các tệp soul/persona tìm thấy trên đĩa. |
| Kỹ năng | Mở bảng kỹ năng của bot — tắt kỹ năng cho bot này ngoài mặc định, hoặc khôi phục mặc định. |
Mặc định → Ứng dụng
| Thiết lập | Tác dụng |
|---|---|
| Hiển thị trong Dock | Ứng dụng thanh menu có xuất hiện trong Dock hay không. |
| Khởi động khi đăng nhập | Khởi động Telebot AI khi bạn đăng nhập. |
| Thư mục dữ liệu | Nơi lưu cấu hình, ký ức, lời nhắc và nhật ký (mặc định ~/.mlx-serve). |
| Mở nhật ký / Mở thư mục dữ liệu | Đi thẳng tới tệp nhật ký hoặc thư mục dữ liệu trong Finder. |
| Xuất cài đặt | Lưu toàn bộ cấu hình (bao gồm khóa API) vào một tệp — để sao lưu hoặc chuyển Mac. |
| Nhập cài đặt | Tải một tệp cấu hình và áp dụng ngay lập tức. |
Kỹ năng & Tính năng
Khả năng của bot là những kỹ năng do mô hình điều khiển — các chỉ dẫn đơn giản mà mô hình làm theo bằng công cụ của nó, nên bạn có thể mô tả điều mình muốn bằng ngôn ngữ thường thay vì nhớ lệnh. Mỗi nhóm có một công tắc chính; từng kỹ năng có thể bật hoặc tắt riêng.
| Nhóm | Kỹ năng | Hãy thử nói |
|---|---|---|
| Nghiên cứu | stock-research, stocks-crypto, insider-trading, currency | "nghiên cứu TSLA", "giá BTC", "giao dịch nội gián AAPL", "50 USD là bao nhiêu CAD?" |
| Hằng ngày | briefing, digest, reminders, habits, review, pomodoro, bookmarks, expenses | "/briefing", "tóm tắt cuộc trò chuyện này", "nhắc tôi lúc 5 giờ chiều", "đánh dấu thói quen hôm nay xong", "đánh giá hàng tuần", "/pomodoro 25", "ghi bữa trưa 25" |
| Phương tiện | media, voice, translation, feeds | "phân tích video này", "đọc to cái này", "dịch cái này sang tiếng Trung", "có gì mới trong nguồn tin của tôi?" |
| Công cụ | memory | "hôm qua chúng ta nói gì nhỉ?" |
| Từ kho lưu trữ | Kỹ năng bạn cài từ kho lưu trữ | — |
Kho kỹ năng
Tab kho lưu trữ cho phép bạn cài các kỹ năng làm sẵn từ danh mục công khai anthropics/skills — xử lý PDF và tài liệu, bảng tính, bài thuyết trình, kiểm thử ứng dụng web, xây dựng máy chủ MCP, nghệ thuật và nhiều hơn nữa. Tải danh mục, chọn một kỹ năng, và nó xuất hiện trong tab Kỹ năng & Tính năng như mọi kỹ năng khác.
Cập nhật
Tab Cập nhật kiểm tra manifest của trang web so với phiên bản đã cài và hiển thị bản phát hành mới nhất kèm liên kết tải xuống. Việc kiểm tra diễn ra âm thầm — ngoại tuyến hoặc không truy cập được chỉ có nghĩa là "đã có phiên bản mới nhất". Để cập nhật: tải tệp .dmg mới và kéo đè lên ứng dụng cũ trong Applications. Cài đặt, bot và ký ức nằm ngoài ứng dụng, nên chúng được giữ nguyên vẹn.
Dữ liệu & quyền riêng tư
- Mọi thứ nằm ở đâu: cấu hình, ký ức trò chuyện, lời nhắc, kỹ năng và nhật ký đều nằm trong thư mục dữ liệu của bạn (mặc định ~/.mlx-serve).
- Những gì rời khỏi Mac của bạn: chính API Telegram, máy chủ mô hình bạn trỏ bot tới, và thống kê sử dụng ẩn danh (số lần khởi động ứng dụng và thao tác trình đơn). Không có nội dung trò chuyện, không token, không dữ liệu cá nhân.
Xử lý sự cố
- "Apple cannot check it for malicious software" — điều bình thường: bấm chuột phải (Control-click) vào ứng dụng trong Applications → Open → Open lần nữa. Một lần duy nhất, sau đó nó chạy bình thường.
- Bot không trả lời. Mở Cài đặt → trang của bot: token có đúng không? Sau đó Mặc định → Mô hình → Kiểm tra nhà cung cấp. Rồi kiểm tra nhật ký (thanh menu → Nhật ký, hoặc tab Ứng dụng → Mở nhật ký).
- Trả lời chậm hoặc bot im lặng. Nhà cung cấp gói miễn phí có thể kẹt hơn một phút — hãy tăng thời gian chờ API, và thêm mô hình dự phòng để bot chuyển sang khi nhà cung cấp chính bị giới hạn.
- Máy chủ cục bộ không phản hồi. Hãy chắc chắn máy chủ thực sự đang chạy (mlx-serve, Ollama…) trước khi kiểm tra trong tab Mô hình.
- Cập nhật báo "đã có phiên bản mới nhất" một cách lạ. Việc kiểm tra âm thầm là có chủ đích — nếu không truy cập được manifest, nó báo đã có phiên bản mới nhất.
- Gì đó khác? Gửi phản hồi — mọi tin nhắn đều vào thẳng Telegram của nhà phát triển và nhận được câu trả lời thật.
Tải xuống Telebot AI · Bạn thích nó chứ? Mời tôi cà phê ☕