Dokumentasi

Chizu Bot
WhatsApp

Bot WhatsApp sederhana dengan AI persona, anime, media downloader, game, dan masih banyak lagi โ€” ditenagai Node.js.

Node.js 18+ whatsapp-web.js Gemini AI Groq LLaMA Jikan API Pollinations.ai
Penting! Ini adalah projek gabut saya dan sudah tidak saya kembangkan lagi, full vibe, hanya dibagikan di blog ini dan mungkin ada beberapa fitur error, bot ini juga tidak ada enkripsi/tanda tangan/hak cipta pada source code, jadi kalian bisa bebas mengembangkan/mempublikasikan bot ini.

// Daftar Isi

  1. Persiapan & Requirement
  2. Instalasi Dependency
  3. Konfigurasi .env
  4. Menjalankan Bot
  5. Chizu AI โ€” Chatbot
  6. Chizu Voice
  7. Foto Chizu
  8. Semua Fitur & Perintah
  9. Troubleshooting
  10. Download Chizu Bot (.zip)
// 01 โ€” Persiapan

Requirement

Sebelum mulai, pastikan sistem kamu sudah memenuhi semua kebutuhan berikut.

Software yang Dibutuhkan

๐ŸŸขNode.js โ‰ฅ 18

Runtime utama bot. Download di nodejs.org

๐ŸŽฌffmpeg

Wajib untuk fitur .tts (voice note), .toimg, .grayscale, .caption, dan Chizu Voice.

๐Ÿ–ผ๏ธimagemagick

Dibutuhkan untuk fitur pengolahan gambar seperti .grayscale dan .caption.

๐Ÿ“ฅyt-dlp

Binary untuk download YouTube, TikTok, dan Instagram.

API Key yang Dibutuhkan

ServiceLink Daftar
GEMINI_API_KEYwajib aistudio.google.com
GROQ_API_KEYopsional console.groq.com
OPENROUTER_API_KEYopsional openrouter.ai
Info: Ini berfungsi agar asisten Chizu hidup. GROQ dan OPENROUTER bersifat opsional, tapi sangat disarankan agar Chizu tetap bisa menjawab walau Gemini sedang down atau habis kuota.
// 02 โ€” Instalasi

Langkah Instalasi

Ikuti langkah berikut dari awal hingga bot siap dipakai.

1

Install Node.js

Download dan install Node.js dari nodejs.org/en/download. Pilih versi LTS. Setelah install, verifikasi:

terminal
node -v   # harus โ‰ฅ v18.0.0
npm -v    # pastikan npm juga terinstall
2

Install ffmpeg & imagemagick

Dibutuhkan untuk fitur suara, gambar, dan Chizu Voice.

Linux / Ubuntu
sudo apt update
sudo apt install ffmpeg imagemagick -y
macOS
brew install ffmpeg imagemagick
Windows
# Download manual:
# ffmpeg     โ†’ https://ffmpeg.org/download.html
# imagemagick โ†’ https://imagemagick.org
# Tambahkan ke PATH setelah install
3

Install yt-dlp

Binary untuk download video YouTube, TikTok, dan Instagram.

Linux / macOS
sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp \
  -o /usr/local/bin/yt-dlp
sudo chmod a+rx /usr/local/bin/yt-dlp
Windows
# Download yt-dlp.exe dari:
# https://github.com/yt-dlp/yt-dlp/releases
# Taruh di folder project atau tambahkan ke PATH
4

Siapkan folder project

Letakkan file bot.js di folder tersendiri. Buat juga folder chizu untuk menyimpan foto-foto Chizu (format .jpg).

Struktur folder
wabot/
โ”œโ”€โ”€ bot.js
โ”œโ”€โ”€ .env            โ† API keys
โ”œโ”€โ”€ package.json
โ””โ”€โ”€ chizu/          โ† foto-foto Chizu (.jpg)
    โ”œโ”€โ”€ chizu1.jpg
    โ”œโ”€โ”€ chizu2.jpg
    โ””โ”€โ”€ ...
Penting: Folder chizu/ wajib ada dan berisi minimal satu file .jpg agar fitur foto Chizu bisa berjalan. Folder ini harus berada di direktori yang sama dengan bot.js.
5

Install package Node.js

Masuk ke folder project, lalu jalankan:

terminal
cd ~/wabot
npm install whatsapp-web.js qrcode-terminal qrcode axios form-data yt-dlp-wrap @google/genai dotenv

Kalau mau reinstall dari awal (jika ada masalah):

terminal
rm -rf node_modules package-lock.json
npm install
// 03 โ€” Konfigurasi

Setup File .env

Buat file bernama .env di folder project (satu level dengan bot.js), lalu isi dengan API key kamu:

.env
GEMINI_API_KEY=isi_api_key_gemini_kamu
GROQ_API_KEY=isi_api_key_groq_kamu
OPENROUTER_API_KEY=isi_api_key_openrouter_kamu
Jangan share file .env! File ini berisi API key pribadi kamu. Jangan upload ke GitHub atau bagikan ke orang lain.

API key remove.bg sudah diisi langsung di dalam script (REMOVE_BG_API_KEY). Limitnya 50 request gratis per bulan โ€” kalau habis, daftar akun baru di remove.bg.

// 04 โ€” Menjalankan Bot

Cara Menjalankan

1

Jalankan bot

Selalu jalankan dari folder yang sama agar session tidak hilang:

terminal
cd ~/wabot
node bot.js
2

Scan QR Code

QR code akan muncul di terminal. Buka WhatsApp di HP โ†’ Perangkat Tertaut โ†’ Tautkan Perangkat โ†’ scan QR tersebut.

Session tersimpan otomatis di folder .wwebjs_auth. Restart berikutnya tidak perlu scan ulang, selama dijalankan dari folder yang sama.
3

Bot siap!

Kalau di terminal muncul โœ… Bot siap ๐Ÿš€, berarti bot sudah online. Coba kirim .menu ke nomor bot untuk melihat daftar perintah. mungkin perlu beberapa saat, ketik .menu lagi apabila bot tidak merespon setelah beberapa menit.

Opsional โ€” gunakan pm2 agar bot tetap jalan di background dan auto-restart kalau crash:

terminal
npm install -g pm2
pm2 start bot.js --name chizu-bot
pm2 save                    # auto-start saat reboot
// 05 โ€” Chizu AI

Mengenal Chizu Tempir

Siapa Chizu?

Chizu Tempir adalah AI chatbot dengan persona yang kuat โ€” perempuan, santai, sedikit dingin, kadang sarkas, tapi sebenernya peduli. Dia ngobrol pakai bahasa Indonesia tidak baku yang natural, layaknya teman chatting di WhatsApp beneran.

Chizu punya memori percakapan per-user (simpan 10 pesan terakhir), jadi percakapan terasa kontekstual dan tidak mengulang dari awal terus.

Model AI yang Dipakai

Chizu pakai sistem fallback berantai โ€” kalau model utama down atau kena rate limit, otomatis coba model berikutnya:

gemini-2.0-flash-lite
โ†’
gemini-2.0-flash
โ†’
gemini-2.5-pro
โ†’
minimax-m2.5 (OpenRouter)
โ†’
glm-4.5-air (OpenRouter)
โ†’
llama-3.3-70b (Groq)
โ†’
llama-3.1-8b (Groq)

Cara Menggunakan

Chizu tidak aktif secara default setiap kali bot restart. Aktifkan dulu:

WhatsApp
.chizu on    โ† aktifkan Chizu
.chizu off   โ† nonaktifkan
.resetai     โ† hapus memori percakapan

Setelah aktif, cukup sebut kata "chizu" di pesan atau reply pesan bot untuk mulai ngobrol.

Cooldown: Ada jeda 8 detik antar pesan per-user untuk mencegah spam ke API.
// 06 โ€” Chizu Voice

Chizu Voice โ€” Jawaban Suara

๐ŸŽ™๏ธ Apa itu Chizu Voice?

Chizu Voice membuat Chizu menjawab dalam bentuk voice note (VN), bukan teks. Suaranya lembut, halus, dan natural seperti cewek SMA yang ngobrol santai โ€” dihasilkan oleh Gemini TTS model Leda.

Cara Pakai

Tambahkan kata "vois" di pesan yang kamu kirimkan ke Chizu:

Contoh penggunaan
Format umum:
chizu vois [pertanyaan/pesan kamu]

Contoh nyata:
chizu vois apa itu alam semesta
chizu vois ceritain tentang hujan dong
chizu vois menurutmu AI itu apa

Cara Kerjanya

Bot mendeteksi kata "vois" di pesan โ†’ menghasilkan teks jawaban Chizu dulu โ†’ lalu mengkonversi teks tersebut ke audio menggunakan Gemini TTS โ†’ mengirimkan hasilnya sebagai voice note WhatsApp.

Butuh ffmpeg: Chizu Voice membutuhkan ffmpeg terinstall di sistem untuk mengkonversi format audio. Jika ffmpeg tidak ada, bot akan fallback mengirim jawaban teks biasa.
Catatan: Chizu Voice hanya aktif jika .chizu on sudah dijalankan sebelumnya.
// 07 โ€” Foto Chizu

Minta Foto Chizu

๐Ÿ“ธ Kirim Foto Chizu

Kamu bisa minta Chizu untuk mengirimkan fotonya secara acak. Bot mengambil gambar dari folder chizu/ yang sudah kamu siapkan sebelumnya.

Chizu akan membalas dengan gaya khasnya yang seolah enggan tapi tetap mengirimkan foto ๐Ÿ˜’

Cara Pakai

Kirim pesan yang mengandung: kata "chizu" + kata foto/pic + kata kamu/lu. Tidak perlu format exact, bot cukup pintar mendeteksinya.

Contoh pesan yang dikenali
send pic lu chizu
foto kamu dong chizu
chizu kirim foto kamu
chizu pap dong
chizu pic please
kirim foto chizu lu

Setup Folder Foto

Buat folder chizu/ di direktori yang sama dengan bot.js, lalu isi dengan foto-foto berformat .jpg:

terminal
mkdir ~/wabot/chizu
# Lalu copy foto .jpg ke dalam folder tersebut
# Nama file bebas, asal berekstensi .jpg
Penting: Jika folder chizu/ kosong atau tidak ada, bot akan membalas "Aku lagi ga punya foto ๐Ÿ˜’". Pastikan ada minimal satu file .jpg di dalamnya.
// 08 โ€” Semua Fitur

Daftar Lengkap Perintah

Ketik .menu di WhatsApp untuk melihat daftar perintah langsung dari bot.

๐Ÿ‘ค Asisten Chizu (Hidden Fitur)

๐ŸŽ€chizu [pesan]

Ngobrol dengan Chizu Tempir. Aktifkan dulu dengan .chizu on, lalu sebut "chizu" di pesan/reply pesan bot.

๐ŸŽ™๏ธchizu vois [pesan]

Chizu menjawab dalam bentuk voice note. Tambahkan kata "vois" di pesan kamu.

๐Ÿ“ธfoto/pic chizu lu/kamu

Minta Chizu mengirimkan fotonya secara acak dari folder chizu/.

โš™๏ธ Umum

๐Ÿ“.ping

Cek apakah bot aktif dan merespons.

๐Ÿ“‹.menu

Menampilkan daftar semua perintah lengkap dari bot.

๐ŸŽฌ Media & Download

๐Ÿ–ผ๏ธ.stiker

Reply gambar atau video untuk dijadikan stiker WhatsApp.

๐Ÿ–ผ๏ธ.toimg

Reply stiker untuk dikonversi menjadi gambar JPG.

๐ŸŽต.ytmp3 <url>

Download audio dari video YouTube dalam format MP3.

๐ŸŽฌ.ytmp4 <url>

Download video YouTube dalam format MP4.

๐ŸŽต.ttdl <url>

Download video TikTok tanpa watermark.

๐Ÿ“ธ.igdl <url>

Download video atau reels dari Instagram.

๐Ÿค– AI

๐Ÿค–.ai <pertanyaan>

Tanya AI langsung tanpa persona Chizu. Cocok untuk pertanyaan faktual.

๐Ÿ—ฃ๏ธ.tts <teks>

Mengubah teks menjadi voice note yang dikirim ke chat.

๐ŸŽจ.imagine <prompt>

Generate gambar AI dari deskripsi teks menggunakan Pollinations.ai. Gratis, tanpa API key.

๐ŸŒ Info & Utilitas

๐ŸŒค๏ธ.cuaca <kota>

Info cuaca hari ini untuk kota yang diminta.

๐Ÿ“….cuacaminggu <kota>

Forecast cuaca 7 hari ke depan.

๐Ÿ’ฑ.kurs

Kurs berbagai mata uang terhadap Rupiah (IDR).

๐ŸŒ‹.gempa

Data gempa bumi terbaru dari BMKG.

๐Ÿ•Œ.jadwalsholat <kota>

Jadwal sholat lengkap untuk kota yang diminta.

๐Ÿ“–.kbbi <kata>

Mencari arti dan definisi kata di Kamus Besar Bahasa Indonesia.

๐ŸŒ.cekip

Menampilkan alamat IP publik dari koneksi bot saat ini.

๐Ÿ“ท.qr <teks/url>

Membuat QR code dari teks atau URL yang diberikan.

๐ŸŒ.translate <lang> <teks>

Menerjemahkan teks. Contoh: .translate en halo dunia

๐ŸŽŒ Anime

Info: Semua fitur anime menggunakan Jikan API (MyAnimeList). API ini gratis dan publik, sehingga kadang bisa mengalami downtime sesaat.
๐ŸŽŒ.anime <judul>

Info detail anime: skor, genre, episode, studio, sinopsis.

๐Ÿ“บ.animetop

Top 10 anime terbaik versi MyAnimeList saat ini.

๐Ÿ—“๏ธ.animeschedule

Jadwal tayang anime minggu ini berdasarkan hari.

๐Ÿ’ฌ.animequote

Kutipan anime secara acak dari berbagai karakter.

๐ŸŽฏ.animerekomendasi <genre>

Rekomendasi anime by genre. Contoh: .animerekomendasi action

๐Ÿ‘ค.animekarakter <nama>

Info karakter anime beserta anime asalnya.

๐Ÿ“š.mangainfo <judul>

Info manga: status, volume, sinopsis.

๐ŸŽ€.randomwaifu

Gambar waifu anime secara acak dari waifu.pics.

๐Ÿ–ผ๏ธ Pengolahan Gambar

โฌ›.grayscale

Reply foto untuk mengubahnya menjadi hitam putih.

โœ๏ธ.caption <teks>

Tambahkan teks caption meme di bagian bawah foto yang di-reply.

โœ‚๏ธ.removebg

Hapus background foto otomatis via remove.bg (50 request gratis/bulan).

๐Ÿ˜„ Hiburan

๐Ÿ˜‚.meme

Meme Indonesia acak dari Reddit via meme-api.com.

๐Ÿ˜„.jokes

Jokes atau lelucon random.

๐Ÿ’ฌ.quotes

Kutipan inspiratif secara acak.

๐Ÿ—จ๏ธ.motivasi

Kata-kata motivasi dalam Bahasa Indonesia.

๐Ÿ’‘.ship <nama1> & <nama2>

Ukur kecocokan dua orang dengan persentase dan komentar lucu.

๐Ÿ“ฐ.berita <topik>

Berita terkini Indonesia. Bisa tanpa topik untuk berita umum.

โœ๏ธ.cerita <tema>

Generate cerita pendek berdasarkan tema menggunakan AI.

๐ŸŽญ.puisi <tema>

Generate puisi Indonesia berdasarkan tema menggunakan AI.

๐Ÿ”ฎ.zodiak <tanggal/bulan>

Info zodiak beserta ramalan singkat berdasarkan tanggal lahir.

๐Ÿ™.githubuser <username>

Info profil GitHub: repo, followers, bio.

๐ŸŽฎ Game

๐ŸŽฒ.tebak

Tebak angka 1โ€“100. Gunakan .stoptebak untuk berhenti.

๐ŸŽฎ.tebakkata

Tebak kata dari hint. Gunakan .hinttebak untuk petunjuk, .stoptebakkata untuk berhenti.

๐Ÿง .trivia

Kuis trivia seputar Indonesia. Jawab langsung dengan mengetik jawabanmu.

โœ‚๏ธ.suit <pilihan>

Gunting-batu-kertas melawan bot. Pilihan: gunting / batu / kertas.

๐ŸŽญ.tebakkarakter

Tebak karakter anime dari gambar yang dikirim bot. Gunakan .hinttebakkarakter untuk petunjuk.

๐Ÿ’ฐ Crypto & Saham

๐Ÿ’ฐ.crypto <kode>

Harga crypto real-time. Contoh: .crypto BTC

๐Ÿ“Š.cryptotrend

Daftar crypto yang naik dan turun paling signifikan hari ini.

๐Ÿ”ฎ.prediksi <kode>

Prediksi pergerakan harga crypto berdasarkan analisis teknikal (RSI, MACD, MA).

๐Ÿ“ˆ.saham <kode>

Harga saham IDX real-time. Contoh: .saham BBCA

๐Ÿ”ง Utilitas

๐Ÿ”‘.password <panjang>

Generate password acak yang kuat.

๐Ÿงฎ.kalkulator <ekspresi>

Hitung ekspresi matematika. Contoh: .kalkulator 25 * 4 + 10

โฐ.remind <waktu> <pesan>

Set reminder. Contoh: .remind 30m cek oven. Satuan: s / m / h.

๐Ÿ‘ฅ Fitur Grup

๐Ÿ“ข.tagall

Mention semua anggota grup sekaligus. Berguna untuk pengumuman.

๐Ÿšซ.antilink on/off

Aktifkan/nonaktifkan anti-link di grup. Pesan dengan link akan dihapus otomatis.

// 09 โ€” Troubleshooting

Masalah Umum & Solusi

Bot minta scan QR setiap restart

Pastikan bot selalu dijalankan dari folder yang sama. Session tersimpan di .wwebjs_auth relatif ke lokasi bot dijalankan. Atau fix dengan path absolut di kode:

bot.js โ€” ganti baris inisialisasi client
const client = new Client({
  authStrategy: new LocalAuth({ dataPath: '/home/user/wabot/.wwebjs_auth' })
});

Chizu tidak merespons

Chizu perlu diaktifkan setiap kali bot restart. Ketik .chizu on terlebih dahulu, lalu sebut "chizu" di pesan untuk mulai ngobrol.

Fitur anime error / tidak ditemukan

Jikan API (MyAnimeList) adalah API publik gratis yang kadang mengalami downtime atau rate-limit. Bukan masalah dari kode โ€” tunggu beberapa menit lalu coba lagi. Cek status di status.jikan.moe.

Chizu Voice tidak bisa / gagal

Pastikan ffmpeg sudah terinstall dan bisa diakses dari terminal. Cek dengan ffmpeg -version. Jika ffmpeg tidak ada, bot otomatis fallback kirim jawaban teks biasa.

Foto Chizu tidak terkirim

Pastikan folder chizu/ ada di direktori yang sama dengan bot.js dan berisi minimal satu file .jpg.

Reinstall dependency

terminal
rm -rf node_modules package-lock.json
npm install
// 10 โ€” Download

Download Chizu Bot

Download file zip, ekstrak, isi .env, dan jalankan. Tidak perlu clone repo.

๐ŸŽ€ chizu-bot.zip

Source code lengkap Chizu Bot siap pakai.
Sudah termasuk .env.example dan folder chizu/ beserta foto default chizu.

โœ“ Node.js 18+ โœ“ Tanpa node_modules npm install diperlukan
Download

๐Ÿ“ Isi File ZIP

  • wabot/
  •   โ”œโ”€โ”€ bot.js โ† source code utama
  •   โ”œโ”€โ”€ .env.example โ† template API key, rename jadi .env
  •   โ”œโ”€โ”€ package.json โ† daftar dependency
  •   โ””โ”€โ”€ chizu/ โ† isi disini jika ada foto tambahan
โš ๏ธ Setelah ekstrak: Jangan lupa rename .env.example menjadi .env dan isi dengan API key kamu. Lalu jalankan npm install sebelum node bot.js. Ikuti panduan instalasi di atas untuk langkah lengkapnya.