logo
icon

OpenClaw 🦞

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
Dideploy30148 kali
PenerbitzeaburZeabur
Dibuat2026-01-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.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.


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

Pergantian Model dan Failover

Template ini menyertakan model failover yang otomatis beralih saat model utama tidak tersedia. Rantai default: glm-4.7-flashgrok-4-fast-non-reasoningminimax-m2.5kimi-k2.5qwen-3-235bgpt-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.

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:

  • Web 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. 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 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 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 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. 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 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 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):

Modifikasi model Zeabur AI Hub (via dashboard Zeabur):

  • Buka SettingsConfigs → 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 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 }

Catatan Keamanan

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.

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 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:
    • File dari layanan Zeabur: restore <nama-file> --strip 2
    • File cadangan manual: restore <nama-file>
    • File dari layanan Zeabur: restore <nama-file> --strip 2 (contoh: restore data-2026-02-27.zip --strip 2)
    • 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 SettingsPerintah, 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 SettingsService 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 Web UI belum dipasangkan dengan Gateway Token. Solusi:

  • Opsi 1: Di tab Instructions Dashboard Zeabur, salin URL Web UI (with Token) dan buka di browser
  • Opsi 2: Buka halaman Overview di Web UI dan masukkan 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 Web 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 SettingsPerintah, 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:

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

Dokumentasi

Catatan Perubahan

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-70bllama-3.1-8b, qwen-3-32qwen-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)
  • 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 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 Web UI atau variabel lingkungan)