📚 Dokumentasi
Setiap fitur, setiap pengaturan.
Semua yang dilakukan aplikasi dan setiap pengaturan yang dimilikinya — ditulis untuk versi yang Anda jalankan. Dari bilah menu hingga registry skill, inilah seluruh buku panduannya.
Di halaman ini
Mulai cepat Aplikasi bilah menu Pengaturan, dijelaskan Tab Model Tab Telegram Halaman per bot Tab Aplikasi Skill & Fitur Registry Skill Pembaruan Data & privasi Pemecahan masalahMulai cepat
- Pasang. Unduh file .dmg, seret Telebot AI ke Applications. Build belum ternotarisasi, jadi jika macOS menampilkan peringatan, klik kanan (Control-klik) aplikasinya dan pilih Buka — sekali saja.
- Buat bot. Kirim pesan ke @BotFather di Telegram, jalankan /newbot, dan salin tokennya. Satu token per bot — Anda bisa menjalankan beberapa.
- Tambahkan token. Buka Telebot AI dari bilah menu, buka Pengaturan, dan tempel token ke kolom Token bot. Token tersimpan begitu Anda mengetik — tidak ada tombol Simpan.
- Hubungkan otak. Di tab Model, atur URL server (http://localhost:11234 untuk mlx-serve, http://localhost:11434 untuk Ollama) dan nama model, atau pakai API cloud apa pun yang kompatibel OpenAI. Tekan Uji untuk memeriksa koneksi.
- Mulai bot. Kembali ke bilah menu, pilih Mulai bot. Kirim pesan ke bot Anda di Telegram — bot menjawab sejak saat itu.
Baru dengan model lokal? Baca panduannya — panduan ini membahas mlx-serve, Ollama, dan LM Studio, serta berapa banyak RAM yang dibutuhkan setiap model.
Aplikasi bilah menu
Telebot AI tinggal di bilah menu Anda (ikon ⌘). Menu ini memberi Anda:
- Mulai / Hentikan / Mulai ulang — per bot dan sekaligus. Bot berjalan sebagai LaunchAgent: selalu aktif, tak menghalangi.
- Buka Pengaturan — jendela pengaturan.
- Log — pantau log bot untuk melihat apa yang dilakukannya atau men-debug masalah.
- Keluar — menghentikan semuanya (dan menonaktifkan LaunchAgent sampai Anda mulai lagi).
Pengaturan, dijelaskan
Jendela pengaturan memiliki bilah sisi dengan dua jenis halaman:
- Bawaan — Model, Telegram, Aplikasi, Skill & Fitur, Registry Skill, Tentang, Pembaruan. Nilai yang diwarisi setiap bot.
- Bot — satu halaman per bot. Setiap kolom menunjukkan apa yang sebenarnya dipakai bot ini: nilai menimpa bawaan, kolom kosong mewarisinya (penjelasan di bawah tiap baris menyebutkannya). Itulah sebabnya tidak ada kotak centang "Gunakan global" — kolom kosong adalah "gunakan global".
Semua tersimpan otomatis saat Anda mengetik atau mengalihkan. Pengaturan tersimpan di ~/.mlx-serve/config.json.
Bawaan → Model
| Pengaturan | Fungsinya |
|---|---|
| URL server | Endpoint yang kompatibel OpenAI. Server lokal tidak butuh kunci. |
| Kunci API | Kosongkan untuk server lokal (mlx-serve, Ollama, LM Studio). Tombol mata menampilkan atau menyembunyikannya. |
| Nama model | Model mana di server itu, mis. deepseek-v4-flash-free. |
| Uji | Memeriksa koneksi dengan nilai saat ini — berguna sebelum menyimpan apa pun. |
| Model cadangan | Dicoba berurutan saat penyedia utama gagal atau membatasi. Masing-masing punya nama panggilan, URL, kunci, dan model sendiri, plus Uji, urut ulang, dan hapus. Tambah dinonaktifkan sampai baris terakhir lengkap. |
Bawaan → Telegram
| Pengaturan | Fungsinya |
|---|---|
| ID chat yang diizinkan | ID pengguna/grup dipisah koma yang boleh bicara dengan bot. Kosong = siapa saja. |
| Waktu briefing harian | Kapan bot mengirim briefing hariannya — dropdown jam/menit 24 jam (mis. 08:00). |
| Prompt briefing | Apa yang harus dicakup briefing — mis. "cuaca, pengingat saya hari ini, dan peringatan harga apa pun". |
| Token jawaban maks. | Batas aman untuk jawaban; jawaban panjang dipecah menjadi beberapa pesan. |
| Konteks per chat | Berapa pesan terbaru yang disimpan bot per chat sebagai konteks. |
| Memori per pengguna | Memori jangka panjang yang dipanggil per pengguna, per pesan yang dijawab bot. |
| Ukuran basis data memori (per pengguna) | Maks. memori yang tersimpan per pengguna; yang terlama dibuang jika melampaui ini. |
| Token laporan riset | Anggaran untuk laporan /research dan /insiders. |
| Batas waktu API (dtk) | Detik sebelum penyedia lambat ditinggalkan — antrean tier gratis bisa macet satu menit lebih. |
| File Soul | Persona yang dipakai bot. File .md di folder ini (soul*.md, *persona*.md) muncul di menu tarik-turun Soul setiap bot. |
| Kata pemicu bot | Kata dipisah koma yang membuat bot menjawab di grup (selain @sebutan, balasan, atau perintah) — mis. "momo, jarvis, hey bot". |
| Kata pemicu klip video/audio | Kata yang membuat bot mengambil video atau audio terlampir sebagai klip — mis. "clip this, save this". |
Halaman per bot
Setiap bot di bilah sisi punya halamannya sendiri. Kolom kosong mewarisi bawaan; penjelasan di bawah tiap baris menyatakan apa yang diwarisinya.
| Pengaturan | Fungsinya |
|---|---|
| Token | Token @BotFather bot (tombol mata untuk menampilkan). Mengubahnya mengganti nama entri bot di bilah sisi. |
| Nama panggilan | Dipakai di status, log, dan bilah sisi — mis. "Trading". |
| ID chat yang diizinkan / Kata pemicu / Kata klip | Timpaan bot ini atas bawaan yang bersesuaian. |
| URL server, Kunci API, Model | Dropdown menawarkan penyedia yang dikonfigurasi di Bawaan → Model, plus nilai kustom apa pun. Model cadangan sendiri bisa ditambahkan per bot. |
| Waktu briefing harian / Prompt briefing | Briefing per bot dengan tombol "Gunakan global" yang menghapus timpaan. |
| Mode | Peneliti, Asisten, Koder, Koki, atau Tidak ada — kosong memakai mode bawaan. |
| File Soul | Timpaan persona bot ini, dipilih dari file soul/persona yang ditemukan di disk. |
| Skill | Membuka lembar skill per bot — nonaktifkan skill untuk bot ini di atas bawaan, atau kembalikan ke bawaan. |
Bawaan → Aplikasi
| Pengaturan | Fungsinya |
|---|---|
| Tampilkan di Dock | Apakah aplikasi bilah menu juga muncul di Dock. |
| Jalankan saat masuk | Mulai Telebot AI saat Anda masuk. |
| Direktori data | Tempat konfigurasi, memori, pengingat, dan log tersimpan (bawaan ~/.mlx-serve). |
| Buka log / Buka folder data | Langsung ke file log atau folder data di Finder. |
| Ekspor pengaturan | Simpan konfigurasi lengkap (termasuk kunci API) ke file — untuk cadangan atau pindah Mac. |
| Impor pengaturan | Muat file konfigurasi dan terapkan langsung. |
Skill & Fitur
Kemampuan bot adalah skill yang digerakkan model — instruksi sederhana yang diikuti model dengan alatnya, jadi Anda bisa menjelaskan apa yang Anda inginkan dengan bahasa biasa alih-alih menghafal perintah. Setiap grup punya saklar utama; skill individual bisa dinyalakan atau dimatikan.
| Grup | Skill | Coba katakan |
|---|---|---|
| Riset | stock-research, stocks-crypto, insider-trading, currency | "riset TSLA", "harga BTC", "transaksi insider untuk AAPL", "berapa 50 USD dalam CAD?" |
| Harian | briefing, digest, reminders, habits, review, pomodoro, bookmarks, expenses | "/briefing", "ringkas chat ini", "ingatkan saya jam 5 sore", "tandai kebiasaan hari ini selesai", "ulasan mingguan", "/pomodoro 25", "catat makan siang 25" |
| Media | media, voice, translation, feeds | "analisis video ini", "bacakan ini dengan suara", "terjemahkan ini ke bahasa Mandarin", "apa yang baru di feed saya?" |
| Alat | memory | "kita ngomongin apa kemarin?" |
| Dari registry | Skill yang Anda pasang dari registry | — |
Registry Skill
Tab registry memungkinkan Anda memasang skill siap pakai dari katalog publik anthropics/skills — penanganan PDF dan dokumen, spreadsheet, presentasi, pengujian aplikasi web, pembuatan server MCP, seni, dan lainnya. Muat katalognya, pilih skill, dan skill itu muncul di tab Skill & Fitur seperti lainnya.
Pembaruan
Tab Pembaruan memeriksa manifes situs terhadap versi terpasang Anda dan menampilkan rilis terbaru dengan tautan unduhan. Pemeriksaan berjalan senyap — offline atau tak terjangkau hanya berarti "sudah terbaru". Untuk memperbarui: unduh .dmg baru dan seret ke aplikasi lama di Applications. Pengaturan, bot, dan memori tersimpan di luar aplikasi, jadi semuanya terbawa tanpa berubah.
Data & privasi
- Tempat semuanya tersimpan: konfigurasi, memori chat, pengingat, skill, dan log semuanya tinggal di direktori data Anda (bawaan ~/.mlx-serve).
- Apa yang meninggalkan Mac Anda: API Telegram itu sendiri, server model apa pun yang Anda arahkan ke bot, dan statistik penggunaan anonim (peluncuran aplikasi dan aksi menu). Tidak ada konten chat, tidak ada token, tidak ada data pribadi.
Pemecahan masalah
- "Apple tidak dapat memeriksa apakah perangkat lunak ini berisi malware" — wajar: klik kanan (Control-klik) aplikasi di Applications → Buka → Buka lagi. Sekali saja, lalu berjalan normal.
- Bot tidak menjawab. Buka Pengaturan → halaman bot: apakah tokennya benar? Lalu Bawaan → Model → Uji penyedianya. Lalu periksa log (bilah menu → Log, atau tab Aplikasi → Buka log).
- Balasan lambat atau bot tiba-tiba diam. Penyedia tier gratis bisa macet satu menit lebih — naikkan batas waktu API, dan tambahkan model cadangan agar bot beralih saat penyedia utama membatasi.
- Server lokal tidak merespons. Pastikan server benar-benar berjalan (mlx-serve, Ollama…) sebelum menguji di tab Model.
- Pembaruan bilang "sudah terbaru" dengan aneh. Pemeriksaan memang senyap — jika manifes tak terjangkau, ia melaporkan sudah terbaru.
- Ada masalah lain? Kirim masukan — setiap pesan masuk ke Telegram pengembang dan mendapat jawaban nyata.
Unduh Telebot AI · Suka aplikasinya? Belikan saya kopi ☕