Dokumentasi / OpenClaw

OpenClaw

OpenClaw adalah asisten AI pribadi yang bisa diajak bicara lewat Telegram atau WhatsApp. Saka memasangnya di server Anda dengan setelan aman bawaan, lalu menyediakan halaman kelola tanpa terminal.

Pasang

Buka server Anda di panel, tekan + Pasang aplikasi, lalu pilih OpenClaw. Isian yang diminta:

IsianKeterangan
Penyedia AIAnthropic (Claude), OpenAI, Google Gemini, OpenRouter, atau endpoint yang kompatibel OpenAI (misalnya 9Router, LiteLLM, vLLM).
Alamat endpoint dan nama modelHanya untuk endpoint kompatibel OpenAI. Gateway yang berjalan di server yang sama (mis. 9Router) boleh ditulis http://localhost:20128/v1; Saka mengarahkannya ke server itu sendiri, bukan ke dalam kontainer. Gateway harus mendengar di 0.0.0.0, portnya tetap tertutup dari internet bila firewall Saka aktif.
Kunci API AIDiperiksa dulu ke penyedianya sebelum pemasangan, lalu disimpan hanya di server Anda, dalam berkas yang hanya bisa dibaca root. Biaya token dibayar langsung ke penyedia AI Anda.
Token bot Telegram (opsional)Dari @BotFather, perintah /newbot. Boleh dikosongkan dan ditambahkan nanti. Bot ini milik asisten Anda, bukan bot Saka.
Memakai Google Gemini?

Buat kunci API di aistudio.google.com/apikey dan salin lengkap (diawali AIza). Kunci diperiksa langsung ke Google sebelum dipasang. Langganan Google Workspace atau langganan Gemini (aplikasi Gemini) bukan kunci API dan tidak bisa dipakai; hanya kunci API dari Google AI Studio yang berfungsi.

Kebutuhan server: RAM 2 GB dan sisa disk 8 GB. Docker dipasang otomatis bila belum ada. Pemasangan butuh beberapa menit. Dialog boleh ditutup; pemasangan tetap berjalan dan hasilnya dikirim ke Telegram Anda.

Setelan yang dipasang Saka:

Hermes Agent

Katalog juga berisi Hermes Agent dari Nous Research, asisten AI yang belajar dari pemakaian dan diajak bicara lewat Telegram. Dipasang dari image resmi nousresearch/hermes-agent:latest, butuh RAM 1 GB dan sisa disk 4 GB. Pilihan penyedia AI-nya sama dengan OpenClaw: Anthropic, OpenAI, Google Gemini, OpenRouter, atau endpoint kompatibel OpenAI. Hermes langsung menjawab pengguna Telegram yang ID-nya diisi saat pemasangan (tanya @userinfobot; pisahkan dengan koma untuk beberapa orang). Sudah memasang Hermes sendiri (Docker atau langsung)? Saka mendeteksinya di halaman server dan menolak memasang yang kedua. Tombol Kelola dengan Saka menghentikan Hermes lama tanpa menghapusnya, menyalin memori, skill, sesi, bot, dan kuncinya, lalu mengembalikannya otomatis bila ada yang gagal. Lupa mengisi bot Telegram saat pasang? Tambahkan nanti di kartu Telegram halaman aplikasi tanpa memasang ulang; data tetap dan Hermes dijalankan ulang sekitar satu menit. Hermes juga punya halaman kelola: siapa yang boleh chat (orang yang chat bot mendapat permintaan akses yang Anda setujui di panel, atau tambahkan ID Telegram langsung), ganti penyedia, model, atau kunci AI (kunci diperiksa dulu), versi & update dengan cadangan otomatis sebelum update, dan cadangan. Halaman kelola lengkap di bawah ini khusus untuk OpenClaw.

Akses chat & persetujuan

Orang baru yang mengirim pesan ke bot Anda tidak langsung dilayani. Ia mendapat kode akses (pairing), dan pesannya tidak diproses sampai Anda menyetujui.

  1. Kirim pesan apa saja ke bot Anda di Telegram.
  2. Permintaan muncul di halaman kelola dalam beberapa detik, lengkap dengan nama pengirim. Cocokkan kodenya dengan kode dari bot.
  3. Tekan Setujui hanya bila Anda mengenal pengirimnya.

Daftar "Yang bisa mengobrol dengan asisten ini" menampilkan semua yang sudah disetujui. Akses bisa dicabut kapan saja. Pemilik tidak bisa dicabut dari panel agar Anda tidak terkunci dari asisten sendiri.

Model AI

Saluran: Telegram dan WhatsApp

Telegram

Isi token bot saat pemasangan, atau tambahkan nanti di kartu Telegram. Setelah itu gunakan alur persetujuan akses.

WhatsApp

  1. Tekan Tambah WhatsApp. Pertama kali, Saka mengunduh plugin WhatsApp dan memulai ulang OpenClaw (±2-3 menit; bot Telegram berhenti sebentar).
  2. QR tampil di panel. Pindai dari WhatsApp di ponsel, seperti WhatsApp Web. QR diperbarui otomatis bila kedaluwarsa.
  3. Pengirim baru mendapat kode akses; setujui di kartu akses.
Risiko WhatsApp

OpenClaw tersambung ke WhatsApp dengan cara perangkat tertaut (seperti WhatsApp Web), jalur yang tidak resmi. Meta bisa membatasi atau memblokir nomor yang dipakai. Pakai nomor terpisah, bukan nomor utama Anda, dan jangan dipakai untuk kirim pesan massal atau promosi.

WhatsApp bisa diputus dari panel dan disambungkan lagi kapan saja dengan memindai QR. Discord dan Slack menyusul.

Jadwal & pengingat

Buat tugas terjadwal untuk asisten: sekali (tanggal dan jam tertentu), harian, hari kerja, atau mingguan (pilih harinya), dengan jam dalam WIB. Tulis apa yang harus dikerjakan asisten, lalu pilih tujuan kirim hasilnya di Telegram atau WhatsApp. Jadwal bisa dinyalakan atau dimatikan, dijalankan sekarang, atau dihapus.

Jadwal juga bisa dibuat lewat chat, misalnya "ingatkan saya minum obat tiap jam 8 malam".

Pencarian web

Pencarian web aktif sejak pemasangan tanpa kunci tambahan. Penyedia bisa diganti di panel: parallel-free (bawaan) atau DuckDuckGo, atau dimatikan. Mengganti penyedia pertama kali mengunduh plugin dan memulai ulang OpenClaw.

Skill, persona, memori

Dasbor lewat terowongan

Tombol Buka dasbor membuka dasbor bawaan OpenClaw di subdomain khusus <id>-<aplikasi>-dashboard.saka.work, tanpa membuka port di server Anda:

Keamanan bawaan

SetelanBawaan SakaArtinya
Minta izin sebelum menjalankan perintahMenyalaSebelum menjalankan perintah di server, asisten mengirim tombol ✅/❌ ke Telegram Anda. Tidak dijawab berarti ditolak.
Skill dari internet (ClawHub)MatiAsisten tidak bisa mengunduh skill pihak ketiga yang tidak diperiksa. Skill bawaan tetap bisa dipakai.

Keduanya bisa diubah di kartu Keamanan, tetapi disarankan tetap seperti bawaan.

Pemeriksaan keamanan: tombol di kartu yang sama menjalankan security audit milik OpenClaw (±1-3 menit) dan menampilkan temuan beserta tingkat dan saran perbaikannya. Pemeriksaan ini butuh swap agar asisten tidak ikut terhenti; bila belum ada, perbaiki dulu dari kartu Kesiapan.

Pindah ke server lain

Menemukan VPS yang lebih murah atau lebih kencang? Pasang Saka di VPS baru, lalu di halaman server lama tekan Pindahkan ke server lain pada OpenClaw atau Hermes. Ini berlaku untuk yang dikelola Saka maupun yang dipasang sendiri sebelum ada Saka (Docker atau installer resmi; Saka mendeteksinya otomatis). Memori, sesi, pengaturan, kunci AI, kredensial kanal, dan workspace ikut pindah; data dikirim langsung antar server (sertifikat sekali pakai, hanya IP server baru yang diizinkan), tidak lewat Saka Panel.

  1. Server baru diperiksa dan disiapkan dulu (RAM, disk, Docker, image) selagi bot lama tetap berjalan.
  2. Bot lama dijeda, datanya dikemas, dikirim, dan dicek keutuhannya (SHA-256). Dalam uji kami jedanya sekitar 30 detik untuk 18 MB data; lebih lama bila memori/sesi besar. Bot tidak pernah berjalan berdua, karena dua bot dengan token Telegram yang sama saling berebut pesan.
  3. Bot dijalankan di server baru sebagai aplikasi kelolaan Saka dan dipastikan sehat. Token gateway lama dipakai lagi, jadi perangkat yang sudah dipasangkan tetap tersambung.
  4. Bila ada langkah yang gagal (mis. server baru tidak bisa menjangkau server lama), bot lama dinyalakan lagi otomatis. Bila berhasil, bot lama dihentikan (juga tidak menyala lagi saat reboot) tetapi datanya tidak dihapus; hapus server lama setelah Anda yakin.

Agent AI memakai alat MCP aplikasi_pindah. Jalur pindah lain (cPanel, Dokploy, Coolify) ada di Pindah ke Saka.

OpenClaw yang dipasang sendiri

OpenClaw yang dipasang langsung di server (bukan Docker, bukan lewat Saka) tetap dikenali di kartu Aplikasi lain: Anda bisa melihat log, memulai, menghentikan, dan memulai ulang layanannya dari panel. Saka tidak mengubah isi layanan atau datanya. Bila OpenClaw terpasang sebagai layanan tetapi tidak menyala otomatis saat server dinyalakan, kartu Kesiapan menampilkan peringatan dan tombol Aktifkan saat boot, supaya bot tidak berhenti setelah reboot.

Cadangan & update

Bila aplikasi dihapus, kontainernya dihentikan dan datanya dipindah ke /var/lib/sakapanel/aplikasi/.sampah/ di server, bisa dipulihkan manual.