Self-host OpenClaw: hubungkan asisten AI pribadi Anda ke Telegram, Slack, dan Discord (plus perbandingan Hermes Agent)

Menjalankan asisten AI pribadi di laptop memang praktis sampai Anda menutup layar laptop lalu mencoba mengirim pesan lewat Telegram atau Discord dari ponsel. OpenClaw mengubah asisten Anda menjadi gateway yang selalu aktif: Anda mengatur penyedia model dan kanal obrolan di Control UI berbasis browser, lalu mengajak asisten berbicara kapan saja dari Telegram, Slack, Discord, dan aplikasi chat lainnya.

Panduan ini menggunakan template OpenClaw di Zenavo untuk menjalankannya 24/7 di server Linux yang Anda sewa atau miliki, menjelaskan cara menghubungkannya ke gateway model self-hosted, serta membandingkannya dengan Hermes Agent. Server, Zenavo, dan API model upstream ditagih secara terpisah.

1. Sebelum deploy: siapkan domain Anda

Saat pertama kali dijalankan, OpenClaw menulis alamat HTTPS publik Anda ke file konfigurasinya (publicOrigin dan controlUi.allowedOrigins) untuk memvalidasi permintaan Control UI dan membuat URL callback.

1. Tambahkan record DNS A yang mengarahkan subdomain Anda (misalnya assistant.example.com) ke IP server.
2. Hubungkan server Linux ke Zenavo (template menyarankan memori minimal 2 GB).
3. Buka template OpenClaw, masukkan alamat HTTPS lengkap pada Public URL (SITE_URL) tanpa garis miring di akhir (seperti https://assistant.example.com), pilih server Anda, lalu deploy.

Template ini menyiapkan:

Pengaturan	Nilai atau fungsi
Image	ghcr.io/openclaw/openclaw:2026.11.3
Port HTTP	18789
Volume state & konfigurasi	/home/node/.openclaw (menyimpan openclaw.json dan direktori workspace)
Volume autentikasi	/home/node/.config/openclaw
OPENCLAW_GATEWAY_TOKEN	Dibuat otomatis saat proyek dibuat; digunakan untuk login ke Control UI
SITE_URL	URL HTTPS publik Anda, ditulis ke openclaw.json saat pertama kali dijalankan

2. Pasang domain dan login ke Control UI

Setelah selesai di-deploy:

1. Buka tab Networking pada layanan openclaw, pasang domain yang sama persis (assistant.example.com) ke port 18789, lalu tunggu sertifikat HTTPS terbit. Lihat Domain & HTTPS.
2. Buka tab Variable pada layanan openclaw dan salin nilai OPENCLAW_GATEWAY_TOKEN.
3. Buka https://assistant.example.com di browser, lalu tempelkan OPENCLAW_GATEWAY_TOKEN untuk masuk ke Control UI.

Catatan: Siapa pun yang memegang OPENCLAW_GATEWAY_TOKEN dapat memakai model dan bot chat yang terhubung. Simpan token ini di pengelola kata sandi (seperti Vaultwarden self-hosted) dan jangan bagikan di obrolan atau tangkapan layar.

3. Hubungkan penyedia model atau gateway self-hosted

Setelah masuk ke Control UI, tambahkan penyedia model (Model Provider):

• Langsung ke API resmi: masukkan kunci API resmi dari OpenAI, Anthropic, Gemini, atau DeepSeek.
• Melalui gateway model self-hosted (disarankan): jika Anda menjalankan Magpie, New API, atau LiteLLM di Zenavo, buat kunci khusus untuk OpenClaw dengan batas kuota harian lalu arahkan OpenClaw ke gateway Anda. Dengan begitu, meskipun bot dipicu berulang kali, tagihan upstream Anda tetap aman.
• Lewat jaringan privat proyek: jika OpenClaw dan gateway berada di proyek Zenavo yang sama (ditambahkan lewat Add Service → Templates), gunakan alamat internal (http://new-api.zenavo.internal:3000/v1 atau http://litellm.zenavo.internal:4000/v1) agar permintaan tidak keluar ke internet publik. Lihat Jaringan Privat.

4. Hubungkan kanal Telegram, Discord, atau Slack

Pada halaman Channels di Control UI, tambahkan aplikasi chat yang Anda gunakan:

1. Buat kredensial bot: misalnya kirim /newbot ke @BotFather di Telegram untuk mendapatkan Bot Token, atau buat bot di Discord Developer Portal maupun dashboard Slack App.
2. Simpan dan aktifkan kanal: tempelkan token ke pengaturan kanal di OpenClaw.
3. Batasi siapa yang boleh mengirim pesan ke bot: bot publik di Telegram atau Discord bisa dikirimi pesan oleh siapa saja yang mengetahui username-nya. Aktifkan daftar izin (Allowlist) pengguna atau kanal di OpenClaw agar hanya User ID Telegram Anda sendiri, akun Discord Anda, atau kanal server privat tertentu yang dapat memicu pemanggilan model.

5. OpenClaw vs Hermes Agent: pilih yang mana?

Katalog template Zenavo juga menyediakan Hermes Agent (open source dari Nous Research), yang sama-sama mendukung Telegram, Discord, dan Slack:

Aspek	OpenClaw	Hermes Agent
Image & port bawaan	ghcr.io/openclaw/openclaw:2026.11.3, port 18789	nousresearch/hermes-agent:v0.23.1, port 9119
Volume persisten	/home/node/.openclaw dan /home/node/.config/openclaw	/opt/data
Login dashboard	Masuk dengan token OPENCLAW_GATEWAY_TOKEN	Username admin, kata sandi di variabel HERMES_DASHBOARD_BASIC_AUTH_PASSWORD
Fokus utama	Gateway AI personal multi-kanal dan workspace yang ringan serta ringkas	Memori jangka panjang (Memory), kumpulan skill, dan eksekusi tugas otonom

Mulai dengan OpenClaw jika Anda menginginkan gateway cepat lintas aplikasi chat; pilih template Hermes Agent jika Anda mengutamakan sistem memori jangka panjang dan ekstensi skill dari Nous Research.

6. Backup dan upgrade

OpenClaw menyimpan konfigurasi, file workspace, dan kredensial kanal di volume /home/node/.openclaw serta /home/node/.config/openclaw:

1. Pada jendela pemeliharaan, hentikan proyek, buat backup kedua volume dari tab Backup & Restore pada layanan openclaw, jalankan kembali proyek, lalu unduh salinan backup untuk disimpan. Lihat Backup & Pemulihan.
2. Template mengunci versi yang telah diuji (2026.11.3). Sebelum melakukan upgrade, cadangkan volume terlebih dahulu, baca catatan rilis upstream, lalu perbarui tag image di Settings → Source.

Pertanyaan umum

Browser menampilkan "Origin not allowed" atau tidak dapat terhubung. Periksa dua hal: pertama, SITE_URL harus sama persis dengan domain yang dipasang (https://... tanpa garis miring di akhir). Kedua, karena skrip awal hanya membuat /home/node/.openclaw/openclaw.json saat file tersebut belum ada, jika Anda mengubah variabel SITE_URL setelah booting pertama, Anda juga perlu memperbarui publicOrigin dan controlUi.allowedOrigins di dalam openclaw.json lalu me-restart layanan.

Mengapa health check butuh beberapa saat sebelum berubah hijau setelah deploy? OpenClaw menginisialisasi gateway saat pertama kali dijalankan, dan template memberikan waktu tenggang 60 detik (start_period: 60). Jika setelah dua menit masih belum siap, buka Zenavo Agent bawaan di sisi kanan konsol atau periksa log dari Claude Code dengan MCP.

Mengapa bot Telegram saya tidak membalas di grup? Bot Telegram mengaktifkan Privacy Mode secara bawaan, sehingga di dalam grup bot hanya menerima perintah yang diawali / atau pesan yang me-@mention bot tersebut. Mention bot atau matikan Privacy Mode lewat /setprivacy di @BotFather, dan pastikan grup atau User ID Anda sudah masuk ke allowlist.

Bagaimana jika saya juga menginginkan antarmuka chat di browser? OpenClaw sangat nyaman dipanggil dari Telegram, Slack, dan Discord. Jika Anda juga membutuhkan antarmuka web khusus dengan fitur unggah dokumen, basis pengetahuan, dan akun multi-pengguna, deploy Open WebUI atau LobeHub berdampingan di server yang sama.

Siapkan subdomain lalu deploy template OpenClaw atau template Hermes Agent agar asisten AI pribadi Anda selalu siap di aplikasi chat ponsel Anda.