TL;DR
OpenClaw adalah gateway yang di-host sendiri yang menghubungkan WhatsApp, Telegram, Discord, dan iMessage ke agen coding AI. Anda menjalankan satu proses Gateway di mesin Anda, dan itu menjadi jembatan antara aplikasi pesan Anda dan asisten AI yang Anda kendalikan. Tanpa ketergantungan cloud, tanpa berbagi data, hanya AI Anda sesuai keinginan Anda.
Mengapa AI Multi-Saluran Penting
Anda sedang di WhatsApp ketika seorang klien bertanya tentang endpoint API. Anda beralih ke Telegram untuk memeriksa dengan tim Anda. Lalu Discord berbunyi dengan laporan bug. Setiap platform memiliki konteksnya sendiri, riwayat percakapannya sendiri, dan Anda menangani tiga asisten AI yang berbeda.
Fragmentasi ini menghabiskan waktu. Pengembang membuang 23% dari hari kerja mereka untuk beralih antar alat, menurut studi tahun 2024 oleh University of California. Itu hampir 2 jam hilang setiap hari karena perpindahan konteks.
OpenClaw memecahkan masalah ini. Ini adalah gateway yang di-host sendiri yang menghubungkan semua platform pesan Anda ke satu asisten AI. Satu pengaturan, banyak saluran, nol keterikatan vendor. Anda mengontrol data, Anda memilih model AI, dan Anda memutuskan pesan mana yang akan dikirim ke mana.
button
Panduan ini menunjukkan cara mengatur OpenClaw, menghubungkan beberapa platform pesan, dan mengkonfigurasi perutean multi-agen. Pada akhirnya, Anda akan memiliki asisten AI pribadi yang berfungsi di mana pun Anda berada.
Apa itu OpenClaw?
OpenClaw adalah gateway sumber terbuka yang berada di antara aplikasi pesan Anda dan agen AI. Bayangkan ini sebagai penerjemah universal untuk percakapan AI.
Inilah yang membedakannya:
Dihosting sendiri (Self-hosted): Anda menjalankannya di perangkat keras Anda. Tidak ada server pihak ketiga yang melihat pesan Anda.
Multi-saluran: Satu proses Gateway menangani WhatsApp, Telegram, Discord, iMessage, dan lainnya secara bersamaan.
Natif Agen: Dibangun untuk agen coding dengan penggunaan alat, sesi, memori, dan perutean multi-agen.
Sumber terbuka (Open source): Berlisensi MIT. Anda dapat meng-forknya, memodifikasinya, atau berkontribusi kembali.
Arsitekturnya lugas. Gateway berjalan sebagai proses Node.js. Ini mempertahankan koneksi persisten ke platform pesan Anda dan merutekan pesan ke penyedia AI seperti Anthropic, OpenAI, atau model lokal. Setiap percakapan mendapatkan sesinya sendiri dengan memori yang terisolasi.
Cara Kerjanya
- Anda mengirim pesan di WhatsApp
- OpenClaw menerimanya melalui saluran WhatsApp
- Gateway merutekannya ke agen AI yang Anda konfigurasikan
- Agen memproses pesan dan menghasilkan respons
- OpenClaw mengirimkan respons kembali ke WhatsApp
Alur yang sama berfungsi untuk Telegram, Discord, atau saluran lain yang terhubung. Gateway menangani otentikasi, manajemen sesi, dan pemformatan pesan secara otomatis.
Kemampuan Utama
Gateway multi-saluran: Hubungkan WhatsApp, Telegram, Discord, dan iMessage dengan satu proses Gateway. Setiap saluran berjalan secara independen, jadi jika satu gagal, yang lain tetap berfungsi.
Saluran plugin: Tambahkan Mattermost dan platform lainnya dengan paket ekstensi. Sistem plugin memungkinkan Anda menulis adaptor saluran kustom tanpa memodifikasi kode inti.
Perutean multi-agen: Rutekan pesan ke agen AI yang berbeda berdasarkan pengirim, saluran, atau konten. Anda dapat memiliki satu agen untuk pertanyaan kode, satu lagi untuk dokumentasi, dan yang ketiga untuk obrolan umum.
Dukungan media: Kirim dan terima gambar, audio, dan dokumen. Gateway menangani unggah file, unduh, dan konversi format secara otomatis.
UI Kontrol Web: Dasbor peramban untuk obrolan, konfigurasi, sesi, dan node. Anda dapat memantau semua percakapan, menyesuaikan aturan perutean, dan men-debug masalah dari satu antarmuka.
Node seluler: Pasangkan perangkat iOS dan Android untuk Canvas, tangkapan kamera/layar, dan alur kerja yang diaktifkan suara. Ponsel Anda menjadi ekstensi dari Gateway.
Menyiapkan Gateway Pertama Anda
Anda memerlukan Node.js 22 atau lebih baru, kunci API dari penyedia AI Anda, dan 5 menit. Saya akan menggunakan Claude dari Anthropic sebagai contoh, tetapi proses ini berfungsi untuk penyedia mana pun.
Instalasi
Instal OpenClaw secara global:
npm install -g openclaw@latest
Ini menambahkan perintah openclaw ke PATH Anda. Anda sekarang dapat menjalankannya dari direktori mana pun.
Orientasi (Onboarding)
Jalankan wizard orientasi:
openclaw onboard --install-daemon
Wizard akan menanyakan:
- Penyedia AI: Pilih dari Anthropic, OpenAI, atau endpoint kustom
- Kunci API: Tempelkan kunci Anda (disimpan secara lokal di
~/.openclaw/config.json) - Model default: Pilih model yang ingin Anda gunakan (misalnya,
claude-sonnet-4-6) - Pengaturan Daemon: Apakah akan menjalankan OpenClaw sebagai layanan latar belakang
Flag --install-daemon mengatur OpenClaw untuk memulai secara otomatis saat sistem Anda boot. Jika Anda lebih suka kontrol manual, lewati flag ini.
Koneksi saluran pertama
Hubungkan WhatsApp:
openclaw channels login
Ini membuka kode QR di terminal Anda. Pindai dengan WhatsApp di ponsel Anda, sama seperti Anda akan melakukan untuk WhatsApp Web. OpenClaw menggunakan protokol yang sama, jadi ini seaman klien resmi.
Setelah terhubung, WhatsApp muncul di daftar saluran Anda:
openclaw channels list
Keluaran:
Active channels:
- whatsapp (connected)
Mulai Gateway
Luncurkan Gateway:
openclaw gateway --port 18789
Gateway dimulai dan mendengarkan di port 18789. Anda akan melihat:
OpenClaw Gateway v1.0.0
Listening on http://localhost:18789
Channels: whatsapp (connected)
Agents: default (claude-sonnet-4-6)
Buka http://localhost:18789 di peramban Anda. UI Kontrol menunjukkan saluran aktif Anda, agen yang terhubung, dan pesan terbaru.
Uji Coba
Kirim pesan ke nomor WhatsApp Anda dari perangkat lain. Tanyakan sesuatu seperti "Bagaimana cuaca?" atau "Jelaskan async/await di JavaScript."
Gateway menerima pesan, merutekannya ke Claude, dan mengirimkan respons kembali ke WhatsApp. Anda akan melihat balasan dalam hitungan detik.
Periksa UI Kontrol. Ini menunjukkan percakapan lengkap, termasuk data pesan mentah dan keputusan perutean.
Menghubungkan Banyak Saluran
Sekarang setelah WhatsApp berfungsi, mari tambahkan Telegram dan Discord.
Penyiapan Telegram
Buat bot Telegram:
- Buka Telegram dan cari @BotFather
- Kirim
/newbotdan ikuti petunjuknya - Salin token bot (terlihat seperti
123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11)
Tambahkan bot ke OpenClaw:
openclaw channels add telegram --token YOUR_BOT_TOKEN
Bot muncul di daftar saluran Anda. Mulai percakapan dengannya di Telegram. Kirim pesan, dan OpenClaw merutekannya ke agen AI yang sama yang menangani WhatsApp.
Penyiapan Discord
Buat bot Discord:
- Buka Discord Developer Portal
- Klik "New Application" dan berikan nama
- Buka tab "Bot" dan klik "Add Bot"
- Salin token bot
- Aktifkan "Message Content Intent" di bawah Privileged Gateway Intents
Tambahkan bot ke OpenClaw:
openclaw channels add discord --token YOUR_BOT_TOKEN
Undang bot ke server Discord Anda menggunakan URL OAuth2 dari Developer Portal. Pastikan untuk memberinya izin "Send Messages" dan "Read Message History".
Penyiapan iMessage (khusus macOS)
iMessage memerlukan Mac karena menggunakan API pribadi aplikasi Pesan. OpenClaw menjalankan jembatan lokal yang mencegat pesan.
Aktifkan iMessage:
openclaw channels add imessage
Berikan izin aksesibilitas kepada OpenClaw saat macOS meminta. Jembatan dimulai secara otomatis dan memantau aplikasi Pesan Anda.
Kirim pesan ke diri sendiri atau kontak uji. OpenClaw mengambilnya dan merutekannya ke agen AI Anda.
Status saluran
Periksa semua saluran yang terhubung:
openclaw channels list
Keluaran:
Active channels:
- whatsapp (connected)
- telegram (connected)
- discord (connected)
- imessage (connected, macOS only)
Setiap saluran berjalan secara independen. Jika satu terputus, yang lain tetap berfungsi. Gateway mencatat masalah koneksi dan mencoba menyambungkan kembali secara otomatis.
Penjelasan Perutean Multi-Agen
Perutean multi-agen memungkinkan Anda mengirim pesan ke agen AI yang berbeda berdasarkan aturan. Anda dapat merutekan berdasarkan pengirim, saluran, kata kunci, atau logika kustom.
Mengapa menggunakan banyak agen?
Tugas yang berbeda memerlukan model yang berbeda. Pertanyaan kode mendapat manfaat dari model yang dilatih untuk pemrograman. Obrolan umum berfungsi lebih baik dengan model percakapan. Kueri dokumentasi memerlukan model dengan jendela konteks besar.
Anda juga dapat menggunakan penyedia yang berbeda. Rutekan data sensitif ke model lokal yang berjalan di mesin Anda. Kirim semuanya ke penyedia cloud untuk kecepatan.
Perutean default
Secara default, semua pesan masuk ke agen yang Anda konfigurasikan selama orientasi. Ini berfungsi baik untuk pengaturan sederhana, tetapi Anda akan menginginkan lebih banyak kontrol saat Anda menambahkan saluran.
Rutekan berdasarkan saluran
Kirim pesan WhatsApp ke satu agen dan pesan Telegram ke agen lain:
openclaw routing add --channel whatsapp --agent code-assistant
openclaw routing add --channel telegram --agent general-chat
Sekarang percakapan WhatsApp menggunakan agen code-assistant, sementara Telegram menggunakan general-chat.
Rutekan berdasarkan pengirim
Rutekan pesan dari pengguna tertentu ke agen khusus:
openclaw routing add --sender +1234567890 --agent client-support
Pesan dari nomor telepon tersebut selalu masuk ke agen client-support, terlepas dari salurannya.
Rutekan berdasarkan kata kunci
Picu agen tertentu berdasarkan konten pesan:
openclaw routing add --keyword "debug" --agent debugging-specialist
openclaw routing add --keyword "docs" --agent documentation-writer
Jika pesan berisi "debug", itu masuk ke agen debugging-specialist. Pesan dengan "docs" masuk ke documentation-writer.
Rutekan berdasarkan prioritas
Aturan memiliki prioritas. Aturan prioritas lebih tinggi cocok terlebih dahulu:
openclaw routing add --channel whatsapp --agent default --priority 1
openclaw routing add --sender +1234567890 --agent vip --priority 10
Pesan dari +1234567890 di WhatsApp masuk ke agen vip karena prioritas 10 mengalahkan prioritas 1.
Logika perutean kustom
Untuk skenario yang kompleks, tulis fungsi perutean dalam JavaScript:
// ~/.openclaw/routing.js
module.exports = function route(message) {
// Route based on time of day
const hour = new Date().getHours();
if (hour >= 9 && hour < 17) {
return 'work-agent';
}
return 'personal-agent';
};
Aktifkan perutean kustom:
openclaw routing set-custom ~/.openclaw/routing.js
Gateway memanggil fungsi Anda untuk setiap pesan. Kembalikan nama agen, dan OpenClaw merutekan sesuai.
Isolasi sesi
Setiap agen mendapatkan sesinya sendiri. Percakapan dengan agen code-assistant tidak bocor ke general-chat. Memori, konteks, dan status alat tetap terpisah.
Anda dapat berbagi sesi di antara agen jika diperlukan:
openclaw routing add --channel whatsapp --agent code-assistant --shared-session
Sekarang semua percakapan WhatsApp berbagi satu sesi, bahkan jika mereka merutekan ke agen yang berbeda.
Konfigurasi Lanjut
Variabel lingkungan
OpenClaw membaca konfigurasi dari variabel lingkungan. Atur di ~/.openclaw/.env:
# AI provider settings
ANTHROPIC_API_KEY=your_key_here
OPENAI_API_KEY=your_key_here
# Gateway settings
GATEWAY_PORT=18789
GATEWAY_HOST=0.0.0.0
# Logging
LOG_LEVEL=info
LOG_FILE=~/.openclaw/gateway.log
# Session settings
SESSION_TIMEOUT=3600
MAX_CONTEXT_LENGTH=100000
Mulai ulang Gateway setelah mengubah konfigurasi:
openclaw gateway restart
Penyedia AI Kustom
Tambahkan penyedia kustom:
openclaw providers add custom \
--endpoint https://your-api.com/v1/chat \
--auth-header "Authorization: Bearer YOUR_TOKEN" \
--model your-model-name
Gunakan dalam perutean:
openclaw routing add --channel discord --agent custom-agent --provider custom
Webhook
Kirim pesan ke layanan eksternal:
openclaw webhooks add \
--url https://your-service.com/webhook \
--event message.received \
--channel whatsapp
Setiap pesan WhatsApp memicu permintaan POST ke webhook Anda dengan data pesan.
Pembatasan kecepatan (Rate Limiting)
Lindungi kuota API Anda:
openclaw limits set --agent code-assistant --max-requests 100 --window 3600
Ini membatasi agen code-assistant menjadi 100 permintaan per jam. Permintaan berlebih akan diantrekan atau ditolak berdasarkan konfigurasi Anda.
Cadangkan dan pulihkan
Ekspor konfigurasi Anda:
openclaw config export > openclaw-backup.json
Pulihkan nanti:
openclaw config import openclaw-backup.json
Ini termasuk saluran, aturan perutean, agen, dan webhook. Kunci API tidak diekspor untuk keamanan.
Kasus Penggunaan Dunia Nyata
Pengembang lepas
Sarah menjalankan bisnis pengembangan lepas. Klien menghubunginya di WhatsApp, timnya menggunakan Telegram, dan dia memantau Discord untuk proyek sumber terbuka.
Dia menyiapkan OpenClaw dengan tiga agen:
client-support: Menangani pertanyaan klien, merutekan ke Claude Opus untuk akurasiteam-chat: Menjawab pertanyaan tim, menggunakan Claude Sonnet untuk kecepatanoss-helper: Memantau Discord, menggunakan model Llama lokal untuk privasi
Aturan perutean:
openclaw routing add --channel whatsapp --agent client-support
openclaw routing add --channel telegram --agent team-chat
openclaw routing add --channel discord --agent oss-helper
Sekarang dia mendapatkan respons yang peka konteks di setiap platform tanpa beralih alat.
Tim pengujian API
Sebuah tim di perusahaan fintech menguji API di berbagai lingkungan. Mereka menggunakan Telegram untuk obrolan internal dan Discord untuk komunikasi dengan vendor.
Mereka mengkonfigurasi OpenClaw untuk merutekan pertanyaan terkait API ke agen yang memiliki akses ke dokumentasi API mereka:
openclaw routing add --keyword "api" --agent api-specialist
openclaw routing add --keyword "endpoint" --agent api-specialist
Agen api-specialist memiliki alat yang mengkueri katalog API internal mereka dan menghasilkan kasus uji. Anggota tim mengajukan pertanyaan seperti "Bagaimana cara mengotentikasi dengan API pembayaran?" dan mendapatkan jawaban instan, akurat dengan contoh kode.
Koordinasi tim jarak jauh
Sebuah tim terdistribusi menggunakan WhatsApp untuk masalah mendesak, Telegram untuk daily standup, dan Discord untuk diskusi teknis.
Mereka mengatur perutean berdasarkan waktu:
// ~/.openclaw/routing.js
// Rutekan pesan mendesak ke agen berprioritas tinggi selama jam kerja
module.exports = function route(message) {
const hour = new Date().getHours();
const isWorkHours = hour >= 9 && hour < 18;
if (message.channel === 'whatsapp' && isWorkHours) {
return 'urgent-agent';
}
if (message.channel === 'telegram') {
return 'standup-agent';
}
return 'general-agent';
};
Agen urgent-agent menggunakan Claude Opus untuk akurasi. Agen standup-agent menggunakan Claude Sonnet untuk kecepatan. Agen general-agent menggunakan model lokal untuk menghemat biaya.
Pemecahan Masalah Umum
WhatsApp sering terputus
Protokol WhatsApp sensitif terhadap perubahan jaringan. Jika Anda menggunakan laptop yang beralih antar jaringan WiFi, pemutusan koneksi terjadi.
Perbaikan:
- Gunakan koneksi jaringan yang stabil
- Jalankan OpenClaw di server alih-alih laptop
- Aktifkan sambung ulang otomatis:
openclaw channels config whatsapp --auto-reconnect true
Bot Telegram tidak merespons
Periksa izin bot. Bot memerlukan "Send Messages" dan "Read Message History" di obrolan grup.
Verifikasi token:
openclaw channels test telegram
Jika gagal, buat ulang token dari @BotFather dan perbarui OpenClaw:
openclaw channels update telegram --token NEW_TOKEN
Bot Discord offline
Bot Discord memerlukan "Message Content Intent" diaktifkan. Buka Developer Portal, pilih aplikasi Anda, buka tab Bot, dan aktifkan di bawah Privileged Gateway Intents.
Mulai ulang Gateway setelah mengaktifkan:
openclaw gateway restart
Biaya API tinggi
Periksa penggunaan Anda:
openclaw stats --agent code-assistant --period 7d
Ini menunjukkan jumlah permintaan, penggunaan token, dan perkiraan biaya selama 7 hari terakhir.
Kurangi biaya:
- Gunakan model yang lebih murah untuk kueri sederhana
- Aktifkan pembatasan kecepatan
- Rutekan pesan non-kritis ke model lokal
Pesan tertunda
Gateway mengantrekan pesan ketika penyedia AI lambat. Periksa status antrean:
openclaw queue status
Jika antrean bertambah, Anda memiliki dua opsi:
- Tingkatkan konkurensi:
openclaw config set --max-concurrent-requests 10
- Tambahkan lebih banyak agen untuk mendistribusikan beban:
openclaw agents add backup-agent --provider openai --model gpt-4
openclaw routing add --fallback backup-agent
Masalah memori sesi
Sesi bertambah seiring waktu. Jika respons menjadi lambat atau tidak relevan, bersihkan sesi lama:
openclaw sessions clear --older-than 7d
Ini menghapus sesi yang tidak aktif selama lebih dari 7 hari.
Sesuaikan batas waktu sesi:
openclaw config set --session-timeout 1800
Sesi sekarang berakhir setelah 30 menit tidak aktif.
FAQ
Bisakah saya menjalankan OpenClaw di Raspberry Pi?
Ya, tetapi kinerja tergantung pada penyedia AI Anda. Jika Anda menggunakan API cloud seperti Anthropic atau OpenAI, Raspberry Pi 4 dengan RAM 4GB berfungsi dengan baik. Jika Anda menjalankan model lokal, Anda memerlukan perangkat keras yang lebih kuat.
Apakah OpenClaw mendukung pesan suara?
Ya. Gateway menangani pesan suara dari WhatsApp dan Telegram. Ini menyalinnya menggunakan penyedia `speech-to-text` yang Anda konfigurasikan (Whisper, Google Speech, atau kustom) dan mengirimkan teks ke agen AI Anda.
Bisakah saya menggunakan beberapa penyedia AI secara bersamaan?
Ya. Konfigurasi agen yang berbeda dengan penyedia yang berbeda:
openclaw agents add anthropic-agent --provider anthropic --model claude-sonnet-4-6
openclaw agents add openai-agent --provider openai --model gpt-4
Rutekan pesan berdasarkan kebutuhan Anda.
Apakah data saya aman?
OpenClaw berjalan di perangkat keras Anda. Pesan tidak pernah menyentuh server pihak ketiga kecuali ketika dikirim ke penyedia AI Anda. Jika Anda menggunakan model lokal, semuanya tetap ada di mesin Anda.
Untuk keamanan ekstra, aktifkan enkripsi:
openclaw config set --encrypt-sessions true
Ini mengenkripsi data sesi saat tidak aktif menggunakan AES-256.
Bisakah saya berkontribusi pada OpenClaw?
Ya. OpenClaw berlisensi MIT dan di-host di GitHub. Fork repo, buat perubahan, dan kirimkan `pull request`. Maintainer meninjau kontribusi setiap minggu.
Apa yang terjadi jika Gateway crash?
Gateway menyimpan status sesi setiap 30 detik. Jika crash, mulai ulang:
openclaw gateway start
Sesi dilanjutkan dari titik pemeriksaan terakhir. Anda mungkin kehilangan percakapan 30 detik terakhir, tetapi yang lainnya tetap ada.
Bisakah saya menjalankan beberapa Gateway?
Ya. Jalankan satu Gateway per mesin atau lingkungan. Setiap Gateway memiliki konfigurasi, saluran, dan agennya sendiri. Mereka tidak berbagi status kecuali Anda menyiapkan database bersama.
Bagaimana cara memperbarui OpenClaw?
Perbarui ke versi terbaru:
npm update -g openclaw
Mulai ulang Gateway:
openclaw gateway restart
Periksa `changelog` untuk perubahan yang merusak sebelum memperbarui.
Kesimpulan
OpenClaw memberi Anda satu asisten AI yang berfungsi di mana pun. Anda mengaturnya sekali, menghubungkan platform pesan Anda, dan mengkonfigurasi aturan perutean. Setelah itu, ia berjalan di latar belakang dan menangani percakapan secara otomatis.
Poin-poin penting:
- Dihosting sendiri berarti Anda mengontrol data Anda
- Dukungan multi-saluran menghilangkan perpindahan konteks
- Perutean multi-agen memungkinkan Anda menggunakan model yang tepat untuk setiap tugas
- Sumber terbuka berarti tidak ada keterikatan vendor
Mulailah dengan satu saluran dan satu agen. Tambahkan lebih banyak sesuai kebutuhan Anda. Gateway ini skalabel dari penggunaan pribadi hingga deployment tim tanpa mengubah arsitektur.
Jika Anda membangun API atau menguji integrasi di berbagai platform, lihat Apidog untuk desain API dan alur kerja pengujian. Ini sangat cocok dengan OpenClaw untuk tim yang membutuhkan AI percakapan dan manajemen API terstruktur.
button
Langkah selanjutnya:
- Instal OpenClaw:
npm install -g openclaw@latest - Jalankan wizard orientasi:
openclaw onboard - Hubungkan saluran pertama Anda:
openclaw channels login - Mulai Gateway:
openclaw gateway --port 18789
Baca dokumentasi resmi untuk fitur lanjutan seperti plugin kustom, integrasi webhook, dan panduan deployment.
Bergabunglah dengan komunitas OpenClaw di Discord untuk berbagi pengaturan, bertanya, dan berkontribusi pada proyek.