logo

quickActions

icon

OpenClaw ๐Ÿฆž with view bot

OpenClaw ๐Ÿฆž (sebelumnya Clawdbot, Moltbot) adalah asisten AI pribadi yang berjalan secara lokal dan terhubung ke berbagai platform perpesanan (WhatsApp, Telegram, Slack, Discord, dll.) melalui arsitektur Gateway berbasis WebSocket.

template cover
Dideploy10 kali
Penerbithadtinfo
Dibuat2026-03-26
Layanan
service icon
Minimum2 Cores4 GB
Direkomendasikan4 Cores8 GB
Tag
AIAssistantChatbotWhatsAppTelegramSlackDiscord

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:2026.3.24. 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.

โš ๏ธ 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 Anda menjalankannya, Anda perlu memperbarui pengaturan terkait secara manual. Lihat dokumentasi resmi untuk detailnya.

Variabel Deploy

Anda akan diminta mengisi variabel berikut saat deploy:

VariabelWajibDeskripsi
DomainYaSubdomain untuk mengakses OpenClaw (contoh my-openclaw โ†’ my-openclaw.zeabur.app). Dapat dihapus setelah beralih ke mode loopback.
Aktifkan Control UIYatrue (default) โ€” mengaktifkan Control UI web via domain publik. false โ€” hanya loopback, tanpa akses web publik (lebih aman, gunakan dengan Tailscale atau channel yang didukung seperti Telegram)
Kunci API Zeabur AI HubTidakKosongkan untuk melewati. Tanpa ini, model default adalah anthropic/claude-opus-4-6 (memerlukan API key sendiri). Dengan AI Hub, Anda dapat menggunakan Gemini, GPT, Claude, DeepSeek. Dapat ditambahkan nanti di tab Variabel.

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, buka URL layanan dari tab Networking. Di halaman login, tempelkan Gateway Token (tersedia di tab Instruksi atau Variables โ†’ OPENCLAW_GATEWAY_TOKEN) dan klik Connect
  2. Konfigurasi model AI (pilih salah satu):
    • Zeabur AI Hub (model default: 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).
    • Penyedia lain (Anthropic, OpenAI, dll.): Jika tidak memasukkan API Key Zeabur AI Hub, model default adalah anthropic/claude-opus-4-6. Buka Control 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.

Pergantian Model dan Failover

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 Control UI Chat atau Perintah di dashboard Zeabur.

Dari Control 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.

Menambahkan Penyedia Model Eksternal

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 Claude
  • OPENAI_API_KEY โ€” model GPT
  • GOOGLE_API_KEY โ€” model Gemini

Setelah menambahkan, restart layanan, lalu ganti model:

  • Control UI Chat: /model anthropic/claude-opus-4-6
  • Perintah: openclaw models set anthropic/claude-opus-4-6

Metode 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.

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. Setelah restart, buka Settings โ†’ Config dan aktifkan plugin Telegram: "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 Perintah 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 Control 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 Perintah 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. Setelah restart, buka Settings โ†’ Config dan aktifkan plugin LINE: "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 Perintah 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/glm-4.7-flash
    • Tanpa โ†’ model default: anthropic/claude-opus-4-6 (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 Control 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 Control UI Settings atau variabel lingkungan):

Modifikasi model Zeabur AI Hub (via dashboard Zeabur):

  • Buka Settings โ†’ Configs โ†’ Edit /opt/openclaw/providers/zeabur-ai-hub.json5, lalu restart layanan (perubahan disinkronkan saat startup)
  • Versi lama (tanpa perintah): Edit /home/node/.openclaw/openclaw.json via tab Files atau Control 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 }

Catatan Keamanan

Control UI adalah alat manajemen untuk konfigurasi, pemantauan, dan chat โ€” platform pesan (Telegram, WhatsApp, Discord, dll.) bekerja secara independen tanpa Control 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 Control 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.

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: CLI Backup (v2026.3.8+) - Buka Perintah โ†’ Jalankan openclaw backup create โ†’ Unduh dari Files di /home/node
    • Konfigurasi saja: openclaw backup create --only-config
    • Tanpa workspace: openclaw backup create --no-include-workspace
    • Verifikasi arsip: openclaw backup verify <file-cadangan>
    • Contoh:
    $ openclaw backup create
Backup archive: /home/node/2026-03-09T15-08-31.114Z-openclaw-backup.tar.gz
Included 1 path:
- state: ~/.openclaw
Skipped 1 path:
- workspace: ~/.openclaw/workspace (covered by ~/.openclaw)
Created /home/node/2026-03-09T15-08-31.114Z-openclaw-backup.tar.gz
  • Metode 3: Manual - Buka Perintah โ†’ 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 Perintah dan jalankan:
    • CLI Backup (v2026.3.8+): restore <nama-file> (auto-deteksi, contoh: restore 2026-03-09T15-08-31.114Z-openclaw-backup.tar.gz)
    • Layanan Zeabur: restore <nama-file> (auto-deteksi, contoh: restore data-2026-02-27.zip)
    • File cadangan manual: restore <nama-file> (contoh: restore backup-1430.tar.gz)
    • Versi lama (tanpa perintah): cd /home/node && tar -xzvf <nama-file>
  3. Hapus file cadangan yang diupload dari /home/node di Files untuk mengosongkan ruang disk
  4. 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.

Pemecahan Masalah

Perintah startup default: /opt/openclaw/startup.sh && /opt/openclaw/start_gateway.sh

Deployment baru (dengan halaman bantuan)

Ketika gateway berhenti, halaman bantuan akan muncul di URL layanan dengan detail error dan langkah perbaikan:

  1. Periksa log error โ€” halaman bantuan menampilkan log terbaru; untuk log lengkap, buka tab Logs di Dashboard Zeabur
  2. Perbaiki konfigurasi โ€” buka tab Files di Dashboard Zeabur, cari file konfigurasi (/home/node/.openclaw/openclaw.json) dan perbaiki masalahnya
  3. Klik Restart di Dashboard Zeabur untuk menerapkan perbaikan

Deployment lama (tanpa halaman bantuan)

Jika deployment Anda tidak memiliki halaman bantuan, ikuti langkah berikut:

  1. Periksa tab Logs di Dashboard Zeabur untuk menemukan error
  2. Buka Settings โ†’ Perintah, ubah perintah startup menjadi sleep 3600, lalu klik Restart โ€” ini menjaga container tetap berjalan agar Anda bisa mengedit file
  3. Perbaiki konfigurasi โ€” buka tab Files, cari file konfigurasi (/home/node/.openclaw/openclaw.json) dan perbaiki masalahnya
  4. Ubah perintah startup kembali ke /opt/openclaw/startup.sh && /opt/openclaw/start_gateway.sh dan klik Restart

๐Ÿ’ก Untuk mengaktifkan halaman bantuan, deploy ulang dari template ini.

Memperbarui Versi OpenClaw

  1. Periksa versi terbaru di OpenClaw releases
  2. Di Dashboard Zeabur, buka Settings โ†’ Service Image Source
  3. Image: ghcr.io/openclaw/openclaw, Tag: ubah dari versi saat ini (contoh: 2026.2.26) ke versi baru (contoh: 2026.3.7)
  4. Klik Restart untuk menerapkan

โš ๏ธ Hindari menggunakan latest sebagai 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.

  1. Periksa tab Logs untuk memastikan gateway berhasil dimulai

๐Ÿ’ก 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.

"device identity required"

Ini berarti Control UI belum diautentikasi dengan Gateway Token. Solusi:

  • Buka URL layanan โ€” halaman login akan muncul. Tempelkan Gateway Token dan klik Connect.
  • Gateway Token dapat ditemukan di tab Instruksi Dashboard Zeabur atau Variables (OPENCLAW_GATEWAY_TOKEN).

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

"disconnected (1008): pairing required"

Ini berarti perangkat Anda (browser/aplikasi) belum dipasangkan dengan Gateway. Cara memasangkan:

  1. Buka Control UI dan selesaikan autentikasi Gateway Token (lihat di atas)
  2. Buka Perintah di dashboard Zeabur untuk mengakses terminal, lalu jalankan:
    • openclaw devices list โ€” lihat permintaan pairing yang menunggu dan temukan requestId
    • openclaw devices approve <requestId> โ€” setujui perangkat

"non-loopback Control UI requires gateway.controlUi.allowedOrigins"

Error 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.

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:

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 Control 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:

  • Tambahkan token ke URL: https://<TS_HOSTNAME>.<tailnet-anda>.ts.net?token=<GATEWAY_TOKEN>
  • Atau masukkan Gateway Token di halaman Overview Control 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 Control 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 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, Control UI mungkin menampilkan error "device identity required".
  • dangerouslyDisableDeviceAuth: Menonaktifkan pemasangan perangkat Control UI (pemasangan perangkat dirancang untuk jaringan lokal; deployment cloud menggunakan autentikasi Gateway Token).
  • Symlink /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).
  • TZ (opsional): Atur zona waktu container menggunakan string zona waktu IANA (contoh: Asia/Jakarta, America/New_York, Europe/London). Tambahkan melalui tab Variables di dashboard Zeabur. Default UTC jika tidak diatur.

Dokumentasi

Catatan Perubahan

2026/3/27

  • Upgrade image ke 2026.3.24 โ€” Endpoint API Gateway kompatibel OpenAI (/v1/models, /v1/embeddings), migrasi SDK Microsoft Teams dengan reply streaming, infrastruktur pembuatan video, isolasi startup channel gateway, perbaikan topik forum Telegram & dimensi foto, perbaikan instalasi baru Docker, penguatan keamanan dispatch media sandbox, dan 60+ perbaikan di WhatsApp, Discord, Slack, Feishu, dan plugin SDK

2026/3/23

  • Upgrade image ke 2026.3.22 โ€” penguatan shutdown SIGTERM gateway, perbaikan konteks reply Telegram & pengiriman topic announce, registrasi independen memory tools, perbaikan lazy boundary runtime provider, penguatan keamanan exec approvals, pairing, dan network discovery

2026/3/15

  • Upgrade image ke 2026.3.13-1 โ€” perbaikan memory leak plugin-sdk (mengatasi OOM crash), penguatan sesi browser, penargetan sesi cron, 50+ perbaikan keamanan, Telegram, Discord, Windows, macOS, dan validasi konfigurasi
  • Tambah variabel deploy ENABLE_CONTROL_UI โ€” mengontrol mode bind gateway (lan vs loopback) dan akses Control UI; default true
  • Tambah NODE_OPTIONS=--max-old-space-size=2048 untuk mencegah OOM di server dengan memori terbatas
  • Hapus item redundan dari skrip startup: inisialisasi HEARTBEAT.md, auto-deteksi heartbeat target, CLI wrapper, export/permission yang tidak perlu, init MEMORY.md (semua ditangani secara native oleh OpenClaw)
  • Ubah perintah startup gateway dari node dist/index.js ke binary openclaw bawaan
  • Perbaiki deskripsi variabel deploy dengan info model default dan instruksi lokal dalam 6 bahasa

2026/3/13

  • Upgrade image ke 2026.3.12 โ€” Control UI dashboard v2, mode cepat GPT-5.4/Claude, plugin provider Ollama/vLLM/SGLang, dokumentasi deployment K8s, 20+ perbaikan keamanan (validasi origin WebSocket, penguatan exec approval, penguncian auto-load plugin), pengetatan cron delivery dengan migrasi openclaw doctor --fix, 60+ fitur baru dan 100+ perbaikan di 4 rilis (2026.3.9โ€“2026.3.12)
  • โš ๏ธ Perubahan penting: cron delivery diperketat โ€” jalankan openclaw doctor --fix di Perintah setelah upgrade untuk migrasi penyimpanan cron lama
  • Menambahkan dokumentasi variabel lingkungan TZ untuk konfigurasi zona waktu container
  • Mengganti nama "Web UI" menjadi "Control UI" di seluruh dokumentasi
  • Menghapus sinkronisasi otomatis variabel lingkungan saluran dari skrip startup (plugin saluran sekarang dikonfigurasi secara manual melalui Settings)
  • Menghapus migrasi gateway config dari skrip startup (konfigurasi awal sudah mencakup semua field yang diperlukan)
  • Menyederhanakan alur login: menghapus URL "Web UI (with token)", menggunakan halaman login Control UI dengan Gateway Token

2026/3/10

  • Add Homebrew pre-installation: touch /.dockerenv and Homebrew install script now run on every container startup, enabling brew package management inside the container
  • Add Go 1.22.3 pre-installation (persisted under /home/node/go)
  • Remove macOS software warning (Homebrew is now available)
  • Homebrew and Go are persisted on the mounted volume and skip re-installation on restart

2026/3/9

  • Upgrade image ke 2026.3.8 โ€” CLI backup (openclaw backup create / openclaw backup verify), konfigurasi timeout diam Talk mode, pencarian web Brave LLM-context, metadata provenance ACP, dedup DM Telegram, perbaikan CDP browser, guard restart/config gateway, 30+ fitur baru dan 40+ perbaikan
  • Tambah dokumentasi openclaw backup create dan openclaw backup verify (backup CLI bawaan dengan mode config-only dan validasi arsip)

2026/3/8

  • Upgrade image ke 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)
  • โš ๏ธ Perubahan tidak kompatibel: 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)
  • Tambah dukungan model Zeabur AI Hub: gemini-3.1-pro-preview, gemini-3.1-flash-lite-preview, gemini-3.1-flash-image-preview, kimi-2.5
  • Tetapkan gateway.auth.mode: "token" eksplisit (defensif untuk perubahan autentikasi gateway di masa depan)
  • Hapus flag --port yang redundan dari skrip startup gateway (port diselesaikan otomatis via env/config/default)

2026/3/4

  • Upgrade image ke 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)
  • โš ๏ธ Perubahan tidak kompatibel: plugin yang menggunakan api.registerHttpHandler(...) harus migrasi ke api.registerHttpRoute(...), channel Zalouser memerlukan login ulang (openclaw channels login --channel zalouser)

2026/3/2

  • Tambah dukungan model Zeabur AI Hub: claude-opus-4-6, minimax-m2.5, step-3.5-flash
  • Ganti model: llama-3.3-70b โ†’ llama-3.1-8b, qwen-3-32 โ†’ qwen-3-235b
  • Perbaiki rotasi API key: mengubah ZEABUR_AI_HUB_API_KEY dan restart sekarang berlaku (hapus envsubst, resolusi ${VAR} saat runtime)
  • Config provider disinkronkan dari /opt setiap startup โ€” pembaruan model template dan edit Configs berlaku setelah restart
  • Tambah catatan keamanan dengan panduan OPENCLAW_GATEWAY_BIND=loopback

2026/2/27

  • Tambah dangerouslyDisableDeviceAuth โ€” gunakan autentikasi Gateway Token menggantikan pemasangan perangkat untuk deployment cloud
  • Model default: zeabur-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)
  • Tambah dokumentasi pergantian model, failover, dan provider eksternal
  • Bersihkan variabel lingkungan (pindahkan nilai default ke skrip startup)
  • Migrasi otomatis konfigurasi yang ada (trustedProxies, pengaturan autentikasi)
  • Upgrade image ke 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 tambahan

2026/2/26

  • Upgrade image ke 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 stabilitas

2026/2/24

  • Upgrade image ke 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 stabilitas
  • Menambahkan dangerouslyAllowHostHeaderOriginFallback ke konfigurasi Control UI โ€” diperlukan untuk deployment non-loopback sejak 2026.2.23

2026/2/22

  • Mengganti health check dengan wrapper restart otomatis: gateway restart otomatis saat crash, menampilkan halaman bantuan dengan detail error dan langkah perbaikan (deteksi pemulihan layanan setiap 5 detik)
  • Menghapus mode penyelamatan (rescue.sh) โ€” digantikan oleh halaman bantuan

2026/2/20

  • Menetapkan tag image ke 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

  • 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)

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 wrapper restart otomatis dengan halaman fallback untuk pemulihan crash gateway
  • 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 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 Control UI atau variabel lingkungan)