OpenClaw 🦞

OpenClaw 🦞 (sebelumnya Clawdbot, Moltbot) adalah asisten AI pribadi yang berjalan secara lokal dan terhubung ke berbagai platform perpesanan melalui arsitektur Gateway berbasis WebSocket.

⚠️ Template ini menggunakan ghcr.io/openclaw/openclaw:latest. OpenClaw 🦞 sedang dalam pengembangan cepat, jadi mungkin ada bug yang belum ditemukan. Mengubah versi juga tidak menjamin stabilitas.

⚠️ Jika Anda mengalami masalah, silakan kunjungi GitHub issues untuk mencari solusi atau melaporkan masalah baru. Untuk masalah terkait platform Zeabur, silakan hubungi dukungan Zeabur.

⚠️ Software dan paket khusus macOS (seperti Homebrew) tidak didukung di lingkungan container ini. Silakan cari solusi alternatif.

⚠️ Template ini memerlukan Dedicated Server di Zeabur. Tidak dapat berjalan di kluster bersama.

⚠️ Template ini sudah dikonfigurasi dan siap digunakan - tidak perlu menjalankan wizard pengaturan. Jika ingin menjalankan wizard, ingat untuk mengatur bind ke mode lan. Lihat dokumentasi resmi untuk konfigurasi lebih lanjut.

---

Sumber Daya yang Direkomendasikan

• Minimum: 2 vCPU / 4 GB RAM
• Disarankan: 4 vCPU / 8 GB RAM

Ekstensi Fitur

• Browser: Jika Anda memerlukan fitur browser (browsing web, screenshot, dll.), deploy Template Browser
• Devbox: Jika Anda memerlukan eksekusi kode multi-bahasa (Python, Go, Rust, C/C++), deploy Template Devbox ke proyek yang sama

Penggunaan

1. Setelah deploy, salin URL "Web UI (with token)" dari tab Instruksi dan tempelkan di browser Anda (login pertama memerlukan token, setelah itu bisa langsung akses URL)
2. Konfigurasi model AI (pilih salah satu):
   • Zeabur AI Hub (model default: gpt-5-mini): Jika sudah memasukkan API Key saat deploy, langsung ke langkah 3. Bisa juga menambahkan ZEABUR_AI_HUB_API_KEY nanti di tab Variables dashboard Zeabur (restart layanan setelah menambahkan).
   • Penyedia lain (Anthropic, OpenAI, dll.): Jika tidak memasukkan API Key Zeabur AI Hub, model default adalah anthropic/claude-opus-4-5. Buka Web UI Settings atau tambahkan kunci API melalui variabel lingkungan. Info: https://docs.openclaw.ai/providers/anthropic
3. Buka halaman Chat untuk menguji apakah model AI Anda berfungsi
4. (Opsional) Atur platform pesan seperti Telegram, WhatsApp, dll.

Untuk konfigurasi model AI, lihat dokumentasi resmi.

Pengaturan Bot Telegram

Mendapatkan token dari BotFather:

1. Buka Telegram dan cari @BotFather
2. Kirim /newbot untuk membuat bot baru
3. Ikuti petunjuk untuk mengatur nama dan username bot
4. BotFather akan mengirimkan token (contoh: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz)

Menambahkan token ke Zeabur:

1. Buka tab Variabel layanan Anda di dashboard Zeabur
2. Tambahkan TELEGRAM_BOT_TOKEN dengan token bot Anda
3. Restart layanan
4. Plugin Telegram akan diaktifkan secara otomatis saat restart. Jika bot tidak berjalan, buka Settings → Config dan pastikan plugin sudah diaktifkan: "plugins": { "entries": { "telegram": { "enabled": true } } }. Untuk menonaktifkan, atur enabled ke false.

Menghubungkan akun Telegram Anda:

1. Kirim /start ke bot Anda di Telegram
2. Bot akan membalas dengan kode pairing (mis. JN4MSY23)
3. Setujui pairing menggunakan salah satu metode berikut:
   • Web Chat: Di antarmuka web OpenClaw, ketik openclaw pairing approve telegram <kode>
   • Terminal: Buka Command di dashboard Zeabur, jalankan openclaw pairing approve telegram <kode>
4. Anda akan melihat: Approved telegram sender <user-id>.
5. Sekarang Anda dapat mengobrol dengan bot!

Pengaturan WhatsApp

Langkah 1: Konfigurasi kanal WhatsApp Tambahkan konfigurasi berikut melalui OpenClaw Web UI (Settings → Config) atau tempelkan ke chat:

"channels": {
  "whatsapp": {
    "selfChatMode": true,
    "dmPolicy": "allowlist",
    "allowFrom": ["+15551234567"]
  }
}

Ganti +15551234567 dengan nomor telepon WhatsApp Anda (dengan kode negara). Restart layanan setelah menyimpan.

Langkah 2: Hubungkan WhatsApp

1. Buka Command di dashboard Zeabur untuk mengakses terminal container
2. Jalankan: openclaw channels login
3. QR Code akan muncul - pindai dengan WhatsApp di ponsel Anda
4. Koneksi selesai! Sekarang Anda dapat mengirim pesan ke diri sendiri di WhatsApp untuk mengobrol dengan OpenClaw

Pengaturan Bot LINE

Membuat channel LINE Messaging API:

1. Jika belum memiliki Akun Resmi LINE, buat terlebih dahulu
2. Buka LINE Developers Console
3. Buat atau pilih Provider
4. Buat channel Messaging API baru dan hubungkan ke Akun Resmi LINE Anda
5. Di tab Messaging API, terbitkan Channel access token (berlaku lama)
6. Di tab Basic settings, salin Channel secret

Menambahkan kredensial ke Zeabur:

1. Buka tab Variabel layanan Anda di dashboard Zeabur
2. Tambahkan LINE_CHANNEL_ACCESS_TOKEN dengan Channel access token Anda
3. Tambahkan LINE_CHANNEL_SECRET dengan Channel secret Anda
4. Restart layanan
5. Plugin LINE akan diaktifkan secara otomatis saat restart. Jika bot tidak berjalan, buka Settings → Config dan pastikan plugin sudah diaktifkan: "plugins": { "entries": { "line": { "enabled": true } } }

Mengatur Webhook:

1. Setelah restart, URL webhook Anda adalah: https://<your-domain>/line/webhook
2. Di LINE Developers Console, buka tab Messaging API channel Anda
3. Atur Webhook URL ke https://<your-domain>/line/webhook
4. Aktifkan Use webhook
5. (Disarankan) Nonaktifkan Pesan balasan otomatis dan Pesan sambutan di LINE Official Account Manager

Menghubungkan akun LINE Anda:

1. Tambahkan bot sebagai teman di LINE dan kirim pesan apa saja
2. Bot akan membalas dengan kode pairing (mis. JN4MSY23)
3. Setujui pairing menggunakan salah satu metode berikut:
   • Web Chat: Di antarmuka web OpenClaw, ketik openclaw pairing approve line <kode>
   • Terminal: Buka Command di dashboard Zeabur, jalankan openclaw pairing approve line <kode>
4. Anda akan melihat: Approved line sender <user-id>.
5. Sekarang Anda dapat mengobrol dengan bot di LINE!

Untuk platform perpesanan lainnya (Discord, Slack, dll.), lihat dokumentasi Channels.

Konfigurasi Model AI

Verifikasi setup Anda:

1. Model default tergantung pada cara deploy:
   • Dengan Zeabur AI Hub API Key → model default: zeabur-ai/gpt-5-mini
   • Tanpa → model default: anthropic/claude-opus-4-5 (memerlukan kunci API)
2. Buka halaman Chat dan kirim pesan percobaan
3. Jika mendapat balasan → model berfungsi dengan baik
4. Jika ada error → pastikan kunci API sudah dikonfigurasi dengan benar

Ganti model untuk percakapan saat ini (melalui perintah chat):

• /models - Lihat model yang tersedia
• /model <model-id> - Ganti model hanya untuk percakapan ini (tidak mempengaruhi percakapan lain)

Ganti model default untuk semua percakapan baru (via Web UI Settings):

• Buka Settings → Agents → Default model
• Tips: Tetapkan model berbiaya rendah sebagai default (misal: gemini-2.5-flash-lite, gpt-5-nano). Jika model tidak tersedia, gunakan /new untuk memulai percakapan baru dengan model default.

Tambah penyedia AI (via Web UI Settings atau variabel lingkungan):

• Tambahkan kunci API penyedia lain (misal: Anthropic, OpenAI)
• Info: https://docs.openclaw.ai/providers

Modifikasi model Zeabur AI Hub (via dashboard Zeabur):

• Buka Settings → Configs → Edit /opt/openclaw/providers/zeabur-ai-hub.json5
• Versi lama (tanpa perintah): Edit /home/node/.openclaw/openclaw.json via tab Files atau Web UI Settings. Tambahkan berikut ke array models.providers.zeabur-ai.models:

{ "id": "gpt-5.2", "name": "GPT-5.2", "reasoning": false, "input": ["text", "image"], "cost": { "input": 1.5, "output": 12, "cacheRead": 0.15, "cacheWrite": 0 }, "contextWindow": 400000, "maxTokens": 8192 },
{ "id": "gpt-5.1", "name": "GPT-5.1", "reasoning": false, "input": ["text", "image"], "cost": { "input": 1.35, "output": 11, "cacheRead": 0.14, "cacheWrite": 0 }, "contextWindow": 400000, "maxTokens": 8192 },
{ "id": "gpt-5-nano", "name": "GPT-5 Nano", "reasoning": false, "input": ["text", "image"], "cost": { "input": 0.1, "output": 0.8, "cacheRead": 0.01, "cacheWrite": 0 }, "contextWindow": 400000, "maxTokens": 8192 },
{ "id": "glm-4.7", "name": "GLM-4.7", "reasoning": false, "input": ["text", "image"], "cost": { "input": 0.5, "output": 2, "cacheRead": 0.12, "cacheWrite": 0 }, "contextWindow": 204800, "maxTokens": 8192 },
{ "id": "glm-4.7-flash", "name": "GLM-4.7 Flash", "reasoning": false, "input": ["text", "image"], "cost": { "input": 0.25, "output": 1, "cacheRead": 0.06, "cacheWrite": 0 }, "contextWindow": 204800, "maxTokens": 8192 },
{ "id": "kimi-k2.5", "name": "Kimi K2.5", "reasoning": false, "input": ["text"], "cost": { "input": 0.45, "output": 2, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 131072, "maxTokens": 8192 }

Persistensi Data

Semua data disimpan di /home/node:

• /home/node/.openclaw - Konfigurasi, sesi, perangkat, dan kredensial
• /home/node/.openclaw/workspace - Ruang kerja dan file memori

Cadangan & Pemulihan

💡 Tips: Kami merekomendasikan untuk membuat cadangan setelah menyelesaikan pengaturan awal atau melakukan perubahan konfigurasi penting.

Cadangan:

• Metode 1: Layanan Zeabur (Direkomendasikan) - Gunakan fitur cadangan bawaan Zeabur. Lihat Dokumentasi Zeabur.
• Metode 2: Manual - Buka Command → Jalankan backup → Unduh dari Files di /home/node (contoh: backup-1430.tar.gz)
  • Versi lama (tanpa perintah): cd /home/node && tar -czvf backup.tar.gz .openclaw

Pemulihan:

1. Upload file cadangan ke folder /home/node di Files
2. Buka Command dan jalankan:
   • File dari layanan Zeabur: restore <nama-file> --strip 2
   • File cadangan manual: restore <nama-file>
   • Versi lama (tanpa perintah): cd /home/node && tar -xzvf <nama-file>
3. Restart layanan

⚠️ Pemulihan akan menimpa konfigurasi dan data yang ada di layanan baru. Jangan lupa untuk juga mengatur kembali variabel lingkungan terkait (contoh: TELEGRAM_BOT_TOKEN). Cadangan/pemulihan channel hanya diuji dengan Telegram dan WhatsApp.

Migrasi dari Clawdbot / Moltbot

Lokasi data versi lama (tanpa perintah):

• Clawdbot: config ~/.clawdbot, workspace ~/clawd
• Moltbot: config ~/.moltbot atau ~/.clawdbot, workspace ~/clawd

Lokasi OpenClaw baru: /home/node/.openclaw (termasuk config dan workspace)

OpenClaw memiliki kompatibilitas mundur dan akan otomatis membaca folder .clawdbot dan .moltbot, cukup ekstrak langsung tanpa perlu mengganti nama.

Langkah migrasi:

1. Cadangkan data di layanan lama Anda:
   • Buka Command di layanan lama
   • cd /home/node && tar -czvf backup.tar.gz .clawdbot .moltbot clawd 2>/dev/null (mengabaikan folder yang tidak ada)
   • Unduh backup.tar.gz dari Files
2. Deploy template OpenClaw baru ini
3. Pulihkan ke layanan baru:
   • Seret backup.tar.gz ke folder /home/node di Files
   • Buka Command: cd /home/node && tar -xzvf backup.tar.gz && rm backup.tar.gz
   • Restart layanan
4. Konfigurasi, riwayat percakapan, dan kredensial Anda akan dipertahankan

Perintah CLI clawdbot dan moltbot masih tersedia untuk kompatibilitas.

Pemecahan Masalah

Layanan tidak bisa dimulai setelah mengubah konfigurasi? Gunakan mode penyelamatan:

1. Buka Settings → Perintah, ubah ke: /opt/openclaw/rescue.sh (atau sleep infinity untuk versi lama tanpa perintah)
2. Buka Settings → Health Check, nonaktifkan (mode penyelamatan tidak merespons health check)
3. Restart layanan - container akan berjalan tapi OpenClaw tidak akan dimulai
4. Buka tab Command untuk mengakses container
5. Perbaiki file konfigurasi /home/node/.openclaw/openclaw.json
6. Ubah perintah startup kembali ke: /opt/openclaw/startup.sh && /opt/openclaw/start_gateway.sh
   • Versi lama (tanpa perintah): node dist/index.js gateway --allow-unconfigured --bind "${OPENCLAW_GATEWAY_BIND}" --port "${OPENCLAW_GATEWAY_PORT}" --token "${OPENCLAW_GATEWAY_TOKEN}"
7. Aktifkan kembali health check dan restart layanan

Perbarui versi: Buka Settings → Service Image Source → ubah ghcr.io/openclaw/openclaw:<tag>.

Error health check Startup probe failed: dial tcp ... connect: connection refused? Ini berarti layanan belum selesai memulai atau port belum siap. OpenClaw mungkin memerlukan lebih banyak waktu untuk memulai, terutama pada peluncuran pertama. Coba:

1. Tunggu beberapa menit — layanan mungkin masih dalam proses inisialisasi
2. Jika error berlanjut, tingkatkan sumber daya (minimum 2 vCPU / 4 GB RAM, disarankan 4 vCPU / 8 GB RAM)
3. Jika layanan terus restart, nonaktifkan Health Check sementara untuk mencegah loop restart, lalu periksa log untuk menemukan error sebenarnya

Akses Jaringan Pribadi Tailscale (Opsional)

⚠️ Fitur ini hanya tersedia untuk deployment baru. Deployment lama tidak menyertakan skrip startup Tailscale — silakan deploy ulang template untuk menggunakan fitur ini.

Selain domain publik, Anda dapat menggunakan Tailscale agar OpenClaw hanya dapat diakses dalam jaringan pribadi (tailnet) Anda, tanpa perlu diekspos ke internet publik.

Prasyarat:

• Akun Tailscale (paket gratis cukup)
• Auth Key dari Tailscale Admin Console (disarankan: Reusable + Ephemeral)

Langkah 1: Atur variabel lingkungan Di tab Environment Variables dashboard Zeabur, tambahkan:

• TS_AUTHKEY (wajib): Auth Key Tailscale Anda (tskey-auth-xxx). Buat di Tailscale Admin Console → Keys. Tanpa variabel ini, pengaturan Tailscale akan dilewati sepenuhnya.
• TS_HOSTNAME (opsional): Nama mesin di tailnet Anda, yang menentukan URL akses (https://<TS_HOSTNAME>.<tailnet>.ts.net). Default openclaw jika tidak diatur.

Langkah 2: Ubah perintah startup Buka Settings → Command, ubah ke:

/opt/openclaw/startup.sh && /opt/openclaw/start_gateway_tailscale.sh

Restart layanan.

Langkah 3: Instal Tailscale di perangkat Anda Instal Tailscale di perangkat yang ingin Anda gunakan untuk mengakses OpenClaw (macOS, Windows, iOS, Android, Linux), dan login dengan akun Tailscale yang sama yang digunakan untuk membuat Auth Key.

Langkah 4: Login pertama ke Web UI Setelah dimulai, buka di browser (harus di perangkat tailnet yang sama):

https://<TS_HOSTNAME>.<tailnet-anda>.ts.net

Nama DNS tailnet Anda dapat ditemukan di Tailscale Admin Console → DNS, atau periksa URL lengkap di Log layanan pada dashboard Zeabur.

Kunjungan pertama akan menampilkan "pairing required". Login menggunakan salah satu cara:

• Tambahkan token ke URL: https://<TS_HOSTNAME>.<tailnet-anda>.ts.net?token=<GATEWAY_TOKEN>
• Atau masukkan Gateway Token di halaman Overview Web UI

Gateway Token dapat ditemukan di tab Instructions atau Environment Variables dashboard Zeabur (OPENCLAW_GATEWAY_TOKEN).

Langkah 5: Menghubungkan OpenClaw app (Opsional, contoh macOS)

1. Instal OpenClaw for macOS dan Tailscale di Mac Anda
2. Buka OpenClaw app → Settings → General → pilih mode Remote
3. Atur Transport ke Direct (ws/wss)
4. Atur Gateway URL ke wss://<TS_HOSTNAME>.<tailnet-anda>.ts.net
5. Koneksi pertama memerlukan persetujuan pairing — buka halaman Nodes di Web UI dan klik approve

Untuk pengaturan iOS dan Android, lihat dokumentasi resmi.

Kembali ke mode domain publik: Ubah perintah startup kembali ke /opt/openclaw/startup.sh && /opt/openclaw/start_gateway.sh dan restart.

Konfigurasi Khusus Zeabur

Template ini menonaktifkan mDNS/Bonjour (OPENCLAW_DISABLE_BONJOUR=1) karena nama host container Zeabur dapat melebihi batas label DNS 63 byte. mDNS hanya digunakan untuk penemuan jaringan lokal (seperti AirPlay/Chromecast) dan tidak diperlukan di lingkungan cloud di mana layanan terhubung melalui DNS internal.

Dokumentasi

• Dokumentasi: https://docs.openclaw.ai
• GitHub: https://github.com/openclaw/openclaw

Catatan Perubahan

2026/2/16

• Mengubah tag image ke latest untuk mengikuti perbaikan keamanan yang cepat

2026/2/15

• Menambahkan akses jaringan pribadi Tailscale: pengguna dapat beralih ke start_gateway_tailscale.sh untuk akses HTTPS pribadi via tailnet tanpa diekspos ke internet publik
• Memperbarui image ke 2026.2.14

2026/2/10

• Memperbaiki skill pembuatan gambar: beralih ke API /v1/chat/completions, model default ke gemini-2.5-flash-image
• Memperbaiki HTTP 500 pada gpt-oss-120b, llama-3.3-70b, qwen-3-32: menambahkan pengaturan kompatibilitas supportsStore: false
• Memperbaiki flag reasoning gpt-oss-120b (diatur ke true)
• Script restore mendukung format .zip (layanan backup Zeabur)
• Sinkronisasi variabel lingkungan saluran (TELEGRAM_BOT_TOKEN, DISCORD_BOT_TOKEN, SLACK_BOT_TOKEN, SLACK_APP_TOKEN, LINE_CHANNEL_ACCESS_TOKEN, LINE_CHANNEL_SECRET) ke file konfigurasi saat startup

2026/2/7

• Memperbaiki notifikasi proaktif cron: mendeteksi otomatis saluran yang dikonfigurasi sebagai target pengiriman heartbeat saat startup
• Menginisialisasi HEARTBEAT.md dengan konten yang dapat dieksekusi untuk deployment baru (mencegah heartbeat dilewati karena file kosong)

2026/2/4

• Menggunakan Zeabur configs untuk skrip startup (lebih mudah dipelihara)
• Menambah perintah global backup dan restore
• Menambah rescue.sh mode penyelamatan untuk ketika konfigurasi rusak
• Menambah 6 model Zeabur AI Hub baru: gpt-5.2, gpt-5.1, gpt-5-nano, glm-4.7, glm-4.7-flash, kimi-k2.5
• Menambah pengaturan kompatibilitas store untuk model Claude Zeabur AI Hub

2026/2/2

• Tambah bagian konfigurasi model AI (global vs percakapan)
• Tambah panduan migrasi dari Clawdbot / Moltbot dengan jalur data
• Tambah bagian cadangan & pemulihan dengan layanan Zeabur
• Tambah tips untuk membuat cadangan setelah pengaturan awal
• Hapus patch Google Gemini CLI (sudah diperbaiki di upstream)
• Hapus variabel ANTHROPIC_API_KEY dan OPENAI_API_KEY dari deployment untuk mencegah OpenClaw mendeteksi API Key kosong dan gagal (dapat dikonfigurasi nanti via Web UI atau variabel lingkungan)