
ZeaburOpenClaw 🦞 (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:2026.3.7. 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 openclaw onboard. Jika ingin mengkonfigurasi ulang, buka Perintah di dashboard Zeabur dan jalankan:
openclaw onboard --gateway-bind lan
Lihat Wizard Reference untuk semua flag yang tersedia.
glm-4.7-flash): 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).anthropic/claude-opus-4-6. Buka Web UI Settings atau tambahkan kunci API melalui variabel lingkungan. Info: https://docs.openclaw.ai/providers/anthropicUntuk konfigurasi model AI, lihat dokumentasi resmi.
Template ini menyertakan model failover yang otomatis beralih saat model utama tidak tersedia. Rantai default: glm-4.7-flash → grok-4-fast-non-reasoning → minimax-m2.5 → kimi-k2.5 → qwen-3-235b → gpt-5-mini.
Anda dapat mengelola model dari Web UI Chat atau Perintah di dashboard Zeabur.
Dari Web UI Chat — ketik slash command langsung di kotak chat:
/model zeabur-ai/glm-4.7-flash — ganti model utama/model — lihat model saat ini/models — daftar penyedia model/models <provider> — daftar model dari penyedia tertentu (mis. /models zeabur-ai)Dari Perintah (dashboard Zeabur) — perintah yang sama di terminal:
openclaw models set zeabur-ai/glm-4.7-flash
openclaw models status
openclaw models list --all
openclaw models fallbacks list
openclaw models fallbacks add zeabur-ai/gpt-5-mini
openclaw models fallbacks remove zeabur-ai/gpt-5-mini
openclaw models fallbacks clear
Atau edit file konfigurasi langsung (~/.openclaw/config.json5):
"agents": {
"defaults": {
"model": {
"primary": "zeabur-ai/glm-4.7-flash",
"fallbacks": ["zeabur-ai/grok-4-fast-non-reasoning", "zeabur-ai/minimax-m2.5"]
}
}
}
Setelah mengedit file konfigurasi, restart layanan.
Selain Zeabur AI Hub, Anda dapat menambahkan penyedia eksternal seperti Anthropic, OpenAI, Google, dll.
Metode 1: Variabel lingkungan — tambahkan API key di tab Variables dashboard Zeabur:
ANTHROPIC_API_KEY — model ClaudeOPENAI_API_KEY — model GPTGOOGLE_API_KEY — model GeminiSetelah menambahkan, restart layanan, lalu ganti model:
/model anthropic/claude-opus-4-6openclaw models set anthropic/claude-opus-4-6Metode 2: Auth token — buka Perintah di dashboard Zeabur:
# Tempel API key dari penyedia
openclaw models auth paste-token --provider anthropic
# Atau gunakan pembantu autentikasi interaktif
openclaw models auth add
Metode 3: File konfigurasi — edit ~/.openclaw/config.json5:
"models": {
"providers": {
"anthropic": { "apiKey": "sk-ant-..." },
"openai": { "apiKey": "sk-..." }
}
}
Untuk semua penyedia yang didukung, lihat dokumentasi resmi.
Mendapatkan token dari BotFather:
/newbot untuk membuat bot baru123456789:ABCdefGHIjklMNOpqrsTUVwxyz)Menambahkan token ke Zeabur:
TELEGRAM_BOT_TOKEN dengan token bot Anda"plugins": { "entries": { "telegram": { "enabled": true } } }. Untuk menonaktifkan, atur enabled ke false.Menghubungkan akun Telegram Anda:
/start ke bot Anda di TelegramJN4MSY23)openclaw pairing approve telegram <kode>openclaw pairing approve telegram <kode>Approved telegram sender <user-id>.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
openclaw channels loginMembuat channel LINE Messaging API:
Menambahkan kredensial ke Zeabur:
LINE_CHANNEL_ACCESS_TOKEN dengan Channel access token AndaLINE_CHANNEL_SECRET dengan Channel secret Anda"plugins": { "entries": { "line": { "enabled": true } } }Mengatur Webhook:
https://<your-domain>/line/webhookhttps://<your-domain>/line/webhookMenghubungkan akun LINE Anda:
JN4MSY23)openclaw pairing approve line <kode>openclaw pairing approve line <kode>Approved line sender <user-id>.Untuk platform perpesanan lainnya (Discord, Slack, dll.), lihat dokumentasi Channels.
Verifikasi setup Anda:
zeabur-ai/glm-4.7-flashanthropic/claude-opus-4-6 (memerlukan kunci API)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):
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):
Modifikasi model Zeabur AI Hub (via dashboard Zeabur):
/opt/openclaw/providers/zeabur-ai-hub.json5, lalu restart layanan (perubahan disinkronkan saat startup)/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.75, "output": 14, "cacheRead": 0.18, "cacheWrite": 0 }, "contextWindow": 400000, "maxTokens": 8192 },
{ "id": "gpt-5.1", "name": "GPT-5.1", "reasoning": false, "input": ["text", "image"], "cost": { "input": 1.25, "output": 10, "cacheRead": 0.13, "cacheWrite": 0 }, "contextWindow": 400000, "maxTokens": 8192 },
{ "id": "gpt-5-nano", "name": "GPT-5 Nano", "reasoning": false, "input": ["text", "image"], "cost": { "input": 0.05, "output": 0.4, "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.4, "output": 1.9, "cacheRead": 0.08, "cacheWrite": 0 }, "contextWindow": 204800, "maxTokens": 8192 },
{ "id": "glm-4.7-flash", "name": "GLM-4.7 Flash", "reasoning": false, "input": ["text", "image"], "cost": { "input": 0.06, "output": 0.4, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 204800, "maxTokens": 8192 },
{ "id": "kimi-k2.5", "name": "Kimi K2.5", "reasoning": false, "input": ["text"], "cost": { "input": 0.45, "output": 2.25, "cacheRead": 0.07, "cacheWrite": 0 }, "contextWindow": 131072, "maxTokens": 8192 }
Web UI adalah alat manajemen untuk konfigurasi, pemantauan, dan chat — platform pesan (Telegram, WhatsApp, Discord, dll.) bekerja secara independen tanpa Web UI. Jika Anda hanya menggunakan platform yang tidak memerlukan inbound webhook (Telegram, WhatsApp, Discord, Signal, iMessage), Anda dapat menghapus pengikatan domain di dashboard Zeabur (tab Networking) untuk menghindari mengekspos gateway ke internet publik. Semua tugas manajemen juga dapat dilakukan melalui CLI di terminal Perintah Zeabur (openclaw config set, openclaw models set, dll.). Untuk akses Web UI privat tanpa domain publik, lihat Akses Jaringan Pribadi Tailscale. Anda juga dapat mengatur OPENCLAW_GATEWAY_BIND ke loopback di tab Variables (restart layanan setelahnya) untuk membatasi gateway hanya menerima koneksi lokal.
Platform yang memerlukan domain publik (inbound webhook): LINE, Slack, Google Chat.
Semua data disimpan di /home/node:
/home/node/.openclaw - Konfigurasi, sesi, perangkat, dan kredensial/home/node/.openclaw/workspace - Ruang kerja dan file memori💡 Tips: Kami merekomendasikan untuk membuat cadangan setelah menyelesaikan pengaturan awal atau melakukan perubahan konfigurasi penting.
Cadangan:
backup → Unduh dari Files di /home/node (contoh: backup-1430.tar.gz)
cd /home/node && tar -czvf backup.tar.gz .openclawPemulihan:
/home/node di Filesrestore <nama-file> --strip 2restore <nama-file>restore <nama-file> --strip 2 (contoh: restore data-2026-02-27.zip --strip 2)restore <nama-file> (contoh: restore backup-1430.tar.gz)cd /home/node && tar -xzvf <nama-file>/home/node di Files untuk mengosongkan ruang disk⚠️ 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.
Perintah startup default:
/opt/openclaw/startup.sh && /opt/openclaw/start_gateway.sh
Ketika gateway berhenti, halaman bantuan akan muncul di URL layanan dengan detail error dan langkah perbaikan:
/home/node/.openclaw/openclaw.json) dan perbaiki masalahnyaJika deployment Anda tidak memiliki halaman bantuan, ikuti langkah berikut:
sleep 3600, lalu klik Restart — ini menjaga container tetap berjalan agar Anda bisa mengedit file/home/node/.openclaw/openclaw.json) dan perbaiki masalahnya/opt/openclaw/startup.sh && /opt/openclaw/start_gateway.sh dan klik Restart💡 Untuk mengaktifkan halaman bantuan, deploy ulang dari template ini.
ghcr.io/openclaw/openclaw, Tag: ubah dari versi saat ini (contoh: 2026.2.26) ke versi baru (contoh: 2026.3.7)⚠️ Hindari menggunakan
latestsebagai tag — ini akan mengunduh versi terbaru setiap kali restart, yang dapat menyebabkan perubahan yang tidak kompatibel atau error tak terduga. Gunakan versi spesifik untuk stabilitas.
💡 Skrip startup secara otomatis memigrasi konfigurasi Anda setiap kali boot — pengaturan yang hilang (seperti
trustedProxies,dangerouslyDisableDeviceAuth) akan ditambahkan otomatis. Pengaturan yang sudah ada tidak akan ditimpa.
Ini berarti Web UI belum dipasangkan dengan Gateway Token. Solusi:
Gateway Token dapat ditemukan di tab Instructions Dashboard Zeabur atau di Environment Variables (OPENCLAW_GATEWAY_TOKEN).
Ini berarti perangkat Anda (browser/aplikasi) belum dipasangkan dengan Gateway. Cara memasangkan:
openclaw devices list — lihat permintaan pairing yang menunggu dan temukan requestIdopenclaw devices approve <requestId> — setujui perangkatError ini terjadi setelah upgrade ke image 2026.2.23 atau lebih baru tanpa memperbarui konfigurasi. Solusi: edit /home/node/.openclaw/openclaw.json dan tambahkan "dangerouslyAllowHostHeaderOriginFallback": true di bawah gateway.controlUi:
{
"gateway": {
"controlUi": {
"dangerouslyAllowHostHeaderOriginFallback": true
}
}
}
Lalu restart layanan. Deployment baru dari template ini sudah menyertakan pengaturan ini.
⚠️ 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:
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 → Perintah, 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.
Login menggunakan salah satu cara:
https://<TS_HOSTNAME>.<tailnet-anda>.ts.net?token=<GATEWAY_TOKEN>Gateway Token dapat ditemukan di tab Instructions atau Environment Variables dashboard Zeabur (OPENCLAW_GATEWAY_TOKEN).
Langkah 5: Menghubungkan OpenClaw app (Opsional, contoh macOS)
wss://<TS_HOSTNAME>.<tailnet-anda>.ts.netUntuk 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.
Template ini mengonfigurasi pengaturan berikut untuk lingkungan cloud Zeabur:
gateway.trustedProxies: Diatur ke ["10.0.0.0/8", "172.16.0.0/12"] agar gateway dapat mengidentifikasi IP klien dengan benar di belakang reverse proxy Zeabur. Tanpa ini, Web UI mungkin menampilkan error "device identity required".dangerouslyDisableDeviceAuth: Menonaktifkan pemasangan perangkat Web UI (pemasangan perangkat dirancang untuk jaringan lokal; deployment cloud menggunakan autentikasi Gateway Token)./usr/local/bin: Perintah openclaw, backup, dan restore di-symlink ke /usr/local/bin agar berfungsi di terminal Perintah Zeabur.OPENCLAW_DISABLE_BONJOUR=1: Menonaktifkan mDNS/Bonjour karena nama host container Zeabur dapat melebihi batas label DNS 63 byte. mDNS hanya digunakan untuk penemuan jaringan lokal dan tidak diperlukan di lingkungan cloud.OPENCLAW_TELEGRAM_DISABLE_AUTO_SELECT_FAMILY=true: Memperbaiki masalah koneksi Telegram di lingkungan container (diperlukan untuk versi image 2026.2.17 dan setelahnya).2026/3/8
2026.3.7 — antarmuka plugin context engine, binding channel ACP persisten, routing agen topik Telegram, build Docker multi-stage, dukungan SecretRef gateway, 30+ fitur baru dan 40+ perbaikan di 5 rilis (2026.3.3–2026.3.7)gateway.auth.mode sekarang diperlukan ketika gateway.auth.token dan gateway.auth.password keduanya dikonfigurasi — template menetapkan mode: "token" (deployment yang ada migrasi otomatis saat startup)gemini-3.1-pro-preview, gemini-3.1-flash-lite-preview, gemini-3.1-flash-image-preview, kimi-2.5gateway.auth.mode: "token" eksplisit (defensif untuk perubahan autentikasi gateway di masa depan)--port yang redundan dari skrip startup gateway (port diselesaikan otomatis via env/config/default)2026/3/4
2026.3.2 — tool PDF, embedding Ollama, streaming Telegram default ke partial, endpoint kesehatan container (/healthz), transport WebSocket OpenAI, 200+ perbaikan dan 20+ penguatan keamanan di 3 rilis (2026.3.1, 2026.3.2)api.registerHttpHandler(...) harus migrasi ke api.registerHttpRoute(...), channel Zalouser memerlukan login ulang (openclaw channels login --channel zalouser)2026/3/2
claude-opus-4-6, minimax-m2.5, step-3.5-flashllama-3.3-70b → llama-3.1-8b, qwen-3-32 → qwen-3-235bZEABUR_AI_HUB_API_KEY dan restart sekarang berlaku (hapus envsubst, resolusi ${VAR} saat runtime)/opt setiap startup — pembaruan model template dan edit Configs berlaku setelah restartOPENCLAW_GATEWAY_BIND=loopback2026/2/27
dangerouslyDisableDeviceAuth — gunakan autentikasi Gateway Token menggantikan pemasangan perangkat untuk deployment cloudzeabur-ai/glm-4.7-flash dengan rantai failover (grok-4-fast-non-reasoning → minimax-m2.5 → kimi-k2.5 → qwen-3-235b → gpt-5-mini)2026.2.26 — perbaikan pewarisan allowlist DM Telegram, perbaikan izin temp dir di container, perbaikan CLI gateway --force di Docker non-root, normalisasi ID model Gemini, dan penguatan keamanan tambahan2026/2/26
2026.2.25 — 100+ perbaikan keamanan dari 2026.2.23→2026.2.25, provider baru (Kilo Gateway, Mistral, Volcano Engine), konfigurasi heartbeat directPolicy, penguatan autentikasi WebSocket gateway, isolasi routing lintas channel, keandalan Discord voice DAVE, perbaikan webhook Telegram hang, dan banyak peningkatan stabilitas2026/2/24
2026.2.23 — mencakup 30+ perbaikan keamanan, provider baru (Kilo Gateway, Mistral, Volcano Engine), konfigurasi streaming channel terpadu, frasa stop multibahasa, pemfilteran reasoning/thinking di semua channel, dan banyak peningkatan stabilitasdangerouslyAllowHostHeaderOriginFallback ke konfigurasi Control UI — diperlukan untuk deployment non-loopback sejak 2026.2.232026/2/22
rescue.sh) — digantikan oleh halaman bantuan2026/2/20
2026.2.19 — menambahkan variabel OPENCLAW_TELEGRAM_DISABLE_AUTO_SELECT_FAMILY=true untuk memperbaiki masalah koneksi Telegram (diperlukan untuk versi image 2026.2.17 dan setelahnya)2026/2/16
latest untuk mengikuti perbaikan keamanan yang cepat2026/2/15
start_gateway_tailscale.sh untuk akses HTTPS pribadi via tailnet tanpa diekspos ke internet publik2026.2.142026/2/10
/v1/chat/completions, model default ke gemini-2.5-flash-imagegpt-oss-120b, llama-3.3-70b, qwen-3-32: menambahkan pengaturan kompatibilitas supportsStore: falsegpt-oss-120b (diatur ke true).zip (layanan backup Zeabur)TELEGRAM_BOT_TOKEN, DISCORD_BOT_TOKEN, SLACK_BOT_TOKEN, SLACK_APP_TOKEN, LINE_CHANNEL_ACCESS_TOKEN, LINE_CHANNEL_SECRET) ke file konfigurasi saat startup2026/2/7
2026/2/4
backup dan restore2026/2/2
Zeabur