Dari nol sampai Merlin bekerja untukmu — instalasi di Windows & Linux, setup pertama, perintah harian, hemat token, dan solusi masalah umum.
Update terakhir: Oktober 2026 · berlaku untuk Merlin Agent versi public main
Merlin adalah AI agent yang jalan di terminal — bisa membaca/menulis file, menjalankan perintah, mencari di web, mengingat konteks antar sesi, dan belajar lewat sistem skill. Satu agent, banyak platform: terminal (CLI/TUI), Telegram, Discord, dan lainnya.
Yang membedakannya dari chatbot biasa: Merlin bekerja (memakai tools), bukan cuma menjawab.
irm https://epinoiahorizon.com/install.ps1 | iex
Installer memasang Python + dependensi, launcher merlin, dan home di %LOCALAPPDATA%\merlin. Setelah selesai, tutup dan buka ulang terminal, lalu cek:
merlin --version
merlin tidak dikenali → tutup semua jendela terminal, buka lagi; masih belum → jalankan installer sekali lagi (dia memperbaiki PATH non-admin). Anti-virus memblokir → beri izin; installer berasal dari repo publik epinoiahorizon/Merlin-Agent.curl -fsSL https://epinoiahorizon.com/install.sh | bash
source ~/.bashrc # atau buka terminal baru
merlin --version
wsl --install dari PowerShell, restart, lalu jalankan installer Linux di dalam WSL. Merlin native-Windows dan Merlin di WSL hidup berdampingan (home terpisah).Prasyarat: Python 3.10+ (dipasang otomatis bila tidak ada) + internet. Dependensi lain diurus installer.
merlin setup
Wizard menanyakan provider & model (Z.AI, OpenRouter, Anthropic, Ollama lokal, dll) lalu API key — disimpan di ~/.merlin/.env (Windows: %LOCALAPPDATA%\merlin\.env), tidak pernah dikirim ke mana pun selain provider-mu.
merlin doctor # cek kesehatan instalasi
merlin model # ganti model kapan pun
merlin # mode chat interaktif (keluar: /exit atau Ctrl+C)
merlin chat -q "jelaskan port 443 dalam satu paragraf" # tanya cepat, tanpa sesi
merlin --continue # lanjutkan sesi terakhir
merlin --resume <session-id> # lanjut sesi spesifik
Perintah penting di dalam sesi:
| Perintah | Fungsi |
|---|---|
| /help | daftar semua perintah |
| /model | ganti model di tengah sesi |
| /compact | padatkan context saat sesi berat (hemat token) |
| /sessions | lihat sesi-sesi lama |
| /skills | daftar skill yang bisa dimuat |
| /skin | ganti tema tampilan |
| /exit | keluar |
Coding — "review app.py, cari bug, perbaiki, jalankan test": Merlin membaca, mengedit, mengeksekusi test, lalu melaporkan hasilnya.
Riset web — "cari dokumentasi resmi X, rangkum 5 poin + link" (toolset web aktif).
Otomasi — pasang cron job dari dalam sesi, misal pengecekan integritas data tiap pagi.
Ingatan permanen — "ingat: repo utama saya di Y" — tersimpan dan dipakai di sesi berikutnya.
Skills — kemampuan tambahan on-demand; contoh skill caveman membuat jawaban super hemat token.
| Kebiasaan | Efek |
|---|---|
| Sesi baru per topik | paling besar — sesi panjang mengirim ulang seluruh history tiap giliran |
| /compact | padatkan sesi panjang yang wajib lanjut |
| Model pas kebutuhan | model kecil/flash untuk rutinitas, model besar untuk kerja berat |
| Skill caveman | jawaban terkompresi (angka/path/kode tetap utuh) |
| Cron no-agent | tugas terjadwal tanpa LLM = nol token |
| Apa | Linux / WSL | Windows |
|---|---|---|
| Config | ~/.merlin/config.yaml | %LOCALAPPDATA%\merlin\config.yaml |
| API keys | ~/.merlin/.env | %LOCALAPPDATA%\merlin\.env |
| Skills | ~/.merlin/skills/ | %LOCALAPPDATA%\merlin\skills\ |
| Memory | ~/.merlin/memories/ | %LOCALAPPDATA%\merlin\memories\ |
| Riwayat sesi | ~/.merlin/state.db | %LOCALAPPDATA%\merlin\state.db |
merlin config set <key> <value>. Update Merlin: merlin update.# 1) buat bot via @BotFather di Telegram, simpan token-nya
merlin config set channels.telegram.token <TOKEN>
merlin config set channels.telegram.enabled true
merlin gateway run
Butuh mesin yang menyala terus (VPS atau PC sendiri). Panduan lengkap: docs resmi.
| Gejala | Solusi |
|---|---|
command not found: merlin | buka terminal baru; Linux: pastikan ~/.local/bin ada di PATH |
| 401/403 dari provider | API key salah/expired → ulang merlin setup |
| 429 rate limit | kuota habis — tunggu, ganti model, atau upgrade plan |
| Chat terasa "lupa" | sesi terlalu panjang → /compact atau sesi baru |
| Emoji/tampilan rusak | pakai Windows Terminal / font Nerd Font |
Lapor bug / minta fitur: github.com/epinoiahorizon/Merlin-Agent/issues