OurinAI - WhatsApp Bot

Halo! Selamat datang di OurinAI, sebuah bot WhatsApp yang dibangun dengan penuh cinta menggunakan Node.js. Bot ini dirancang untuk memudahkan kamu dalam mengelola WhatsApp, baik untuk keperluan pribadi maupun grup.

Apa yang membuat OurinAI spesial? Bot ini menggunakan sistem plugin yang modular, artinya kamu bisa dengan mudah menambah atau menghapus fitur sesuai kebutuhan. Tidak perlu jadi programmer handal untuk menggunakannya!

Daftar Isi

Sebelum mulai, ini dia peta navigasi untuk membantu kamu menemukan informasi yang dibutuhkan:

Kenapa Harus OurinAI?

Mungkin kamu bertanya-tanya, kenapa harus pakai OurinAI? Kan banyak bot WhatsApp lain di luar sana. Nah, ini beberapa alasannya:

Mudah Digunakan Tidak perlu gelar IT untuk menjalankan bot ini. Cukup ikuti panduan ini step by step, dalam hitungan menit bot kamu sudah jalan.

Modular dan Fleksibel Setiap fitur adalah file terpisah yang disebut "plugin". Mau tambah fitur? Tinggal buat file baru. Mau hapus? Tinggal delete filenya. Simpel!

Stabil dan Teruji OurinAI menggunakan library Baileys yang sudah teruji dan digunakan banyak developer. Ditambah sistem auto-reconnect, bot kamu tidak akan mudah mati.

Gratis dan Open Source Tidak ada biaya tersembunyi. Kode sumbernya terbuka, kamu bisa modifikasi sesuka hati.

Apa Saja Fiturnya?

Fitur Inti

Multi-Device Support Bot ini menggunakan teknologi WhatsApp Multi-Device. Apa artinya? Artinya bot tetap jalan meskipun HP kamu mati atau tidak ada koneksi internet. Sesi tersimpan di server/komputer, bukan di HP.

Sistem Plugin Modular Setiap command adalah file JavaScript terpisah di folder plugins/. Kamu bisa mengedit, menambah, atau menghapus plugin tanpa harus restart bot. Keren kan?

Database Otomatis OurinAI menggunakan LowDB untuk menyimpan data. Setiap perubahan langsung tersimpan secara otomatis. Data user, grup, pengaturan, semuanya aman.

Auto Backup Takut data hilang? Tenang, bot ini backup database secara otomatis setiap 24 jam. Backup lama dihapus otomatis setelah 7 hari untuk menghemat ruang.

Auto Reconnect Kalau koneksi terputus (misalnya internet mati sebentar), bot akan otomatis mencoba menyambung kembali. Tidak perlu restart manual.

Fitur Grup

Welcome Message Ketika ada member baru masuk grup, bot akan menyapa mereka dengan pesan selamat datang yang heboh. Bisa diaktifkan atau dinonaktifkan per grup.

Goodbye Message Ketika ada member yang keluar, bot akan mengirim pesan perpisahan. Sama seperti welcome, bisa di-toggle.

Sistem Keamanan

Mode Self dan Public Ada dua mode operasi:

Public: Semua orang bisa pakai bot
Self: Hanya kamu (pemilik nomor) yang bisa pakai

Anti-Spam Bot otomatis mendeteksi spam dan mengabaikannya. Tidak perlu khawatir bot kamu di-abuse.

Anti-Call Ada yang iseng nelpon? Bot otomatis menolak dan mengirim pesan bahwa bot tidak menerima panggilan.

Fitur Tambahan

Sticker Maker Kirim gambar atau video dengan caption .sticker, jadilah sticker! Tidak di-crop, gambar utuh.

Daily Limit Reset Setiap user punya limit harian untuk mencegah abuse. Limit reset otomatis jam 00:00.

Scheduled Messages Mau kirim pesan jam tertentu? Bisa! Bahkan bisa diatur repeat harian.

Sebelum Memulai

Sebelum kita mulai instalasi, pastikan komputer atau server kamu sudah memenuhi persyaratan berikut.

Yang Wajib Ada

Node.js versi 18 atau lebih baru Node.js adalah "mesin" yang menjalankan bot ini. Tanpa Node.js, bot tidak bisa jalan.

Cara cek apakah sudah terinstall:

node --version

Hasilnya harus v18.0.0 atau lebih tinggi.

NPM (Node Package Manager) NPM biasanya sudah terinstall otomatis bersama Node.js. NPM digunakan untuk menginstall library yang dibutuhkan bot.

Cara cek:

npm --version

Git (Opsional tapi Disarankan) Git digunakan untuk mendownload dan mengupdate bot. Sebenarnya bisa juga download manual, tapi dengan Git lebih mudah.

Cara cek:

git --version

Spesifikasi Komputer

Bot ini cukup ringan, tapi tetap ada minimum spesifikasi:

RAM: Minimal 512 MB (1 GB lebih baik)
Storage: Minimal 500 MB ruang kosong
Internet: Harus stabil, upload 1 Mbps cukup
OS: Windows 10/11, Linux (Ubuntu/Debian), macOS, bahkan Android (Termux)

Cara Instalasi

Oke, mari kita mulai! Ikuti langkah-langkah berikut dengan teliti.

Langkah 1: Install Node.js

Untuk Pengguna Windows

Buka browser, pergi ke https://nodejs.org/
Kamu akan lihat dua tombol download. Pilih yang bertuliskan "LTS" (biasanya warna hijau) karena ini versi stabil
Setelah download selesai, buka file installer-nya
Klik Next, Next, Next sampai selesai (biarkan default)
Buka Command Prompt (tekan Windows + R, ketik cmd, Enter)
Ketik node --version dan tekan Enter
Kalau muncul versi seperti v18.17.0, berarti berhasil!

Untuk Pengguna Linux (Ubuntu/Debian)

Buka terminal dan jalankan perintah berikut:

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs

Tunggu prosesnya selesai, lalu cek dengan:

node --version
npm --version

Untuk Pengguna Termux (Android)

pkg update && pkg upgrade
pkg install nodejs git

Langkah 2: Download OurinAI

Cara 1: Menggunakan Git (Disarankan)

Buka terminal atau Command Prompt, lalu jalankan:

git clone https://github.com/LuckyArchz/Ourin-MD.git

Perintah ini akan membuat folder baru bernama Ourin-MD yang berisi semua file bot.

Setelah selesai, masuk ke folder:

cd Ourin-MD

Cara 2: Download Manual

Kalau tidak mau pakai Git, bisa download manual:

Buka https://github.com/LuckyArchz/Ourin-MD
Klik tombol hijau "Code" di pojok kanan atas
Pilih "Download ZIP"
Extract file ZIP tersebut
Buka terminal di folder hasil extract

Langkah 3: Install Dependencies

Dependencies adalah library-library yang dibutuhkan bot untuk berjalan. Ini seperti bahan-bahan yang diperlukan untuk memasak.

Jalankan perintah berikut di dalam folder Ourin-MD:

npm install

Proses ini akan menginstall sekitar 50+ package. Biasanya memakan waktu 2-5 menit tergantung kecepatan internet kamu.

Kalau muncul warning berwarna kuning, biasanya tidak apa-apa. Yang penting tidak ada error berwarna merah.

Mengatur Bot

Sekarang bagian yang sangat penting: mengatur konfigurasi bot.

Buka file config.js menggunakan text editor apapun (Notepad, VS Code, dll).

Yang Wajib Diubah

Nomor Owner

Cari bagian ini:

owner: {
    name: 'Owner',
    number: ['628xxxxxxxxxx']
}

Ganti 628xxxxxxxxxx dengan nomor WhatsApp kamu. Format nomor:

Diawali dengan kode negara (62 untuk Indonesia)
Tidak pakai tanda + atau 0 di depan
Contoh: 6281234567890

Kalau mau lebih dari satu owner:

number: ['6281234567890', '6289876543210']

Mode Bot

Cari bagian ini:

mode: 'public'

Pilihan:

'public' = Semua orang bisa pakai bot
'self' = Hanya kamu yang bisa pakai

Untuk testing awal, disarankan pakai 'self' dulu.

Yang Bisa Diubah (Opsional)

Nama Bot

bot: {
    name: 'Ourin-AI'
}

Prefix Command

command: {
    prefix: '.'
}

Ubah ke '!' kalau mau command jadi !menu, !ping, dll.

Limit Harian

limits: {
    default: 25,
    premium: 100,
    owner: -1
}

Sticker Metadata

sticker: {
    packname: 'Ourin-AI',
    author: 'Bot'
}

Setelah selesai mengedit, simpan file (Ctrl + S).

Menjalankan Bot

Akhirnya kita sampai di tahap yang ditunggu-tunggu!

Start Bot

Jalankan perintah berikut:

npm start

atau

node index.js

Proses Pairing

Karena ini pertama kali, bot perlu dipasangkan dengan WhatsApp kamu. Kamu akan melihat kode pairing di terminal seperti ini:

╔════════════════════════════════════╗
║         PAIRING CODE               ║
║                                    ║
║         1234-5678                  ║
║                                    ║
╚════════════════════════════════════╝

Sekarang buka WhatsApp di HP:

Ketuk ikon titik tiga (⋮) di pojok kanan atas
Pilih "Perangkat tertaut" atau "Linked Devices"
Ketuk "Tautkan perangkat" atau "Link a Device"
Pilih "Tautkan dengan nomor telepon" atau "Link with Phone Number"
Masukkan kode pairing yang muncul di terminal

Tunggu beberapa detik...

Berhasil!

Kalau berhasil, di terminal akan muncul:

✓ Terhubung ke WhatsApp!
✓ Bot: Ourin-AI
✓ Ready to receive messages!

Selamat! Bot kamu sudah jalan!

Coba kirim .ping ke nomor bot untuk memastikan semuanya berjalan lancar.

Daftar Perintah

Berikut daftar lengkap perintah yang tersedia di OurinAI.

Perintah Utama

Perintah	Kegunaan
`.menu`	Menampilkan daftar semua perintah yang tersedia
`.ping`	Mengecek apakah bot masih aktif dan berapa response time-nya
`.runtime`	Melihat sudah berapa lama bot berjalan tanpa restart
`.infobot`	Menampilkan informasi detail tentang bot

Perintah Owner

Perintah ini hanya bisa digunakan oleh owner yang terdaftar di config.

Perintah	Kegunaan
`.self on`	Mengaktifkan mode self (hanya owner yang bisa pakai)
`.self off`	Menonaktifkan mode self (semua bisa pakai)
`.broadcast teks`	Mengirim pesan ke semua chat
`.listowner`	Melihat daftar owner yang terdaftar
`.listprem`	Melihat daftar user premium

Perintah Scheduler

Perintah	Kegunaan
`.schedule add 08:00 nomor Pesan`	Menambah pesan terjadwal
`.schedule list`	Melihat semua jadwal yang aktif
`.schedule del id`	Menghapus jadwal tertentu
`.schedule status`	Melihat status scheduler

Perintah Grup

Perintah	Kegunaan
`.welcome on`	Mengaktifkan pesan selamat datang
`.welcome off`	Menonaktifkan pesan selamat datang
`.goodbye on`	Mengaktifkan pesan perpisahan
`.goodbye off`	Menonaktifkan pesan perpisahan

Perintah Utility

Perintah	Kegunaan
`.sticker`	Mengubah gambar atau video menjadi sticker
`.profile`	Melihat informasi profile user

Perintah Fun

Perintah	Kegunaan
`.dice`	Melempar dadu virtual (hasil 1-6)
`.flip`	Melempar koin virtual (heads atau tails)

Membuat Plugin Sendiri

Salah satu kelebihan OurinAI adalah kemudahan dalam membuat plugin. Kamu tidak perlu jadi programmer handal untuk ini!

Konsep Dasar

Plugin adalah file JavaScript yang berisi satu command. File ini disimpan di folder plugins/ dan dikelompokkan berdasarkan kategori (main, owner, utility, fun, dll).

Struktur Plugin

Setiap plugin punya dua bagian utama:

Config: Pengaturan plugin (nama, deskripsi, permission, dll)
Handler: Fungsi yang dijalankan ketika command dipanggil

Contoh Plugin Sederhana

Buat file baru plugins/fun/sapa.js:

const pluginConfig = {
    name: 'sapa',
    alias: ['hi', 'hello'],
    category: 'fun',
    description: 'Menyapa bot',
    usage: '.sapa',
    isOwner: false,
    cooldown: 5,
    limit: 1,
    isEnabled: true
}

async function handler(m) {
    const responses = [
        'Halo! Apa kabar?',
        'Hai! Senang bertemu denganmu!',
        'Yoo! Ada yang bisa dibantu?'
    ]
    
    const randomResponse = responses[Math.floor(Math.random() * responses.length)]
    await m.reply(randomResponse)
}

module.exports = {
    config: pluginConfig,
    handler
}

Simpan, dan plugin langsung aktif! Coba kirim .sapa ke bot.

Penjelasan Config

Property	Tipe	Keterangan
`name`	String	Nama command utama
`alias`	Array	Nama alternatif untuk command
`category`	String	Kategori di menu
`description`	String	Deskripsi singkat
`usage`	String	Cara penggunaan
`isOwner`	Boolean	True jika khusus owner
`cooldown`	Number	Jeda antar penggunaan (detik)
`limit`	Number	Berapa limit yang dikurangi
`isEnabled`	Boolean	True untuk mengaktifkan

Struktur Folder

Berikut penjelasan setiap folder dan file penting:

Ourin-MD/
│
├── index.js           # File utama yang dijalankan
├── config.js          # Semua pengaturan bot
├── package.json       # Info project dan dependencies
├── CHANGELOG.md       # Catatan perubahan setiap versi
├── README.md          # Dokumentasi (file ini)
│
├── src/
│   ├── connection.js  # Kode untuk koneksi WhatsApp
│   ├── handler.js     # Handler untuk pesan masuk
│   │
│   └── lib/
│       ├── backup.js      # Sistem backup otomatis
│       ├── colors.js      # Logger dan warna console
│       ├── database.js    # Database LowDB
│       ├── exif.js        # Metadata sticker
│       ├── lidHelper.js   # Bantuan konversi LID
│       ├── plugins.js     # Loader plugin
│       ├── reconnect.js   # Sistem auto reconnect
│       ├── scheduler.js   # Penjadwalan
│       └── serialize.js   # Serializer pesan
│
├── plugins/
│   ├── main/          # Command utama
│   ├── owner/         # Command khusus owner
│   ├── utility/       # Command utility
│   ├── group/         # Command grup
│   └── fun/           # Command hiburan
│
├── sessions/          # Data sesi WhatsApp
├── backups/           # Backup database
└── tmp/               # File temporary

Kalau Ada Masalah

Kadang ada masalah yang muncul. Berikut beberapa masalah umum dan cara mengatasinya.

Bot tidak merespon setelah pairing

Ini masalah yang paling sering terjadi. Penyebabnya biasanya sesi yang corrupt.

Solusi:

Stop bot (tekan Ctrl + C)
Hapus folder sessions/
Jalankan lagi npm start
Lakukan pairing ulang

Error "Module not found"

Ini berarti ada dependency yang belum terinstall.

Solusi:

npm install

Error "ECONNREFUSED"

Ini masalah koneksi internet atau server WhatsApp sedang maintenance.

Solusi:

Cek koneksi internet
Tunggu beberapa menit
Coba jalankan ulang

Bot crash terus-menerus

Kemungkinan ada plugin yang error atau memory penuh.

Solusi:

Cek log error untuk mengetahui plugin mana yang bermasalah
Hapus atau perbaiki plugin tersebut
Restart bot

Sticker tidak jadi

Ini biasanya masalah FFmpeg.

Solusi:

npm uninstall @ffmpeg-installer/ffmpeg
npm install @ffmpeg-installer/ffmpeg

Pertanyaan Umum

Apakah bot ini aman? Selama kamu tidak membagikan folder sessions/ ke orang lain, bot ini aman. Folder tersebut berisi kredensial WhatsApp kamu.

Apakah bisa kena banned? Bisa, kalau kamu menggunakan bot untuk spam atau melanggar ketentuan WhatsApp. Gunakan dengan bijak!

Bagaimana cara update bot?

git pull origin main
npm install
npm start

Bisa jalan di HP langsung? Bisa, menggunakan Termux di Android. Tapi untuk performa terbaik, gunakan VPS atau komputer.

Apa itu limit? Limit adalah batas penggunaan command per hari untuk mencegah abuse. Reset otomatis jam 00:00.

Bagaimana cara jadi premium user? Owner bisa menambahkan nomor ke array premiumUsers di config.js.

Bot bisa untuk multi-nomor? Saat ini satu folder hanya untuk satu nomor. Kalau mau multi-nomor, buat folder terpisah untuk setiap nomor.

Penutup

Terima kasih sudah menggunakan OurinAI! Kalau kamu suka dengan project ini, jangan lupa kasih bintang di GitHub.

Punya pertanyaan atau saran? Silakan buat issue di repository GitHub.

Selamat menggunakan! 🚀

Dibuat dengan ❤️ oleh Lucky Archz

Name		Name	Last commit message	Last commit date
Latest commit History 6 Commits
assets/images		assets/images
backups		backups
plugins		plugins
src		src
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
README.md		README.md
RELEASE_NOTES.md		RELEASE_NOTES.md
config.js		config.js
index.js		index.js
package.json		package.json

LuckyArch/Ourin-MD

Folders and files

Latest commit

History

Repository files navigation

OurinAI - WhatsApp Bot

Daftar Isi

Kenapa Harus OurinAI?

Apa Saja Fiturnya?

Fitur Inti

Fitur Grup

Sistem Keamanan

Fitur Tambahan

Sebelum Memulai

Yang Wajib Ada

Spesifikasi Komputer

Cara Instalasi

Langkah 1: Install Node.js

Langkah 2: Download OurinAI

Langkah 3: Install Dependencies

Mengatur Bot

Yang Wajib Diubah

Yang Bisa Diubah (Opsional)

Menjalankan Bot

Start Bot

Proses Pairing

Berhasil!

Daftar Perintah

Perintah Utama

Perintah Owner

Perintah Scheduler

Perintah Grup

Perintah Utility

Perintah Fun

Membuat Plugin Sendiri

Konsep Dasar

Struktur Plugin

Contoh Plugin Sederhana

Penjelasan Config

Struktur Folder

Kalau Ada Masalah

Bot tidak merespon setelah pairing

Error "Module not found"

Error "ECONNREFUSED"

Bot crash terus-menerus

Sticker tidak jadi

Pertanyaan Umum

Penutup

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases 2

Languages