render.yaml yang disertakan mendefinisikan seluruh stack Anda secara deklaratif, termasuk service, disk, dan variabel lingkungan, sehingga Anda dapat men-deploy dengan satu klik dan memversikan infrastruktur Anda bersama kode Anda.
Prasyarat
Deploy dengan Render Blueprint
Deploy to Render Mengklik tautan ini akan:- Membuat service Render baru dari Blueprint
render.yamldi root repo ini. - Membangun image Docker dan men-deploy
https://<service-name>.onrender.com.
Memahami Blueprint
Render Blueprints adalah file YAML yang mendefinisikan infrastruktur Anda.render.yaml di
repo ini mengonfigurasi semua yang diperlukan untuk menjalankan OpenClaw:
| Feature | Tujuan |
|---|---|
runtime: docker | Membangun dari Dockerfile repo ini |
healthCheckPath | Render memantau /health dan memulai ulang instance yang tidak sehat |
generateValue: true | Menghasilkan nilai yang aman secara kriptografis secara otomatis |
disk | Penyimpanan persisten yang tetap ada setelah redeploy |
Memilih plan
| Plan | Spin-down | Disk | Paling cocok untuk |
|---|---|---|---|
| Free | Setelah 15 menit idle | Tidak tersedia | Pengujian, demo |
| Starter | Tidak pernah | 1GB+ | Penggunaan pribadi, tim kecil |
| Standard+ | Tidak pernah | 1GB+ | Produksi, banyak channel |
starter. Untuk menggunakan free tier, ubah plan: free di
render.yaml pada fork Anda (tetapi perhatikan: tanpa disk persisten, state OpenClaw
di-reset pada setiap deploy).
Setelah deployment
Akses Control UI
Dashboard web tersedia dihttps://<your-service>.onrender.com/.
Hubungkan menggunakan shared secret yang telah dikonfigurasi. Template deployment ini secara otomatis menghasilkan
OPENCLAW_GATEWAY_TOKEN (temukan di Dashboard → service Anda →
Environment); jika Anda menggantinya dengan auth berbasis password, gunakan
password tersebut.
Fitur Render Dashboard
Log
Lihat log real-time di Dashboard → service Anda → Logs. Filter berdasarkan:- Log build (pembuatan image Docker)
- Log deploy (startup service)
- Log runtime (output aplikasi)
Akses shell
Untuk debugging, buka sesi shell melalui Dashboard → service Anda → Shell. Disk persisten di-mount di/data.
Variabel lingkungan
Ubah variabel di Dashboard → service Anda → Environment. Perubahan memicu redeploy otomatis.Auto-deploy
Jika Anda menggunakan repositori OpenClaw asli, Render tidak akan auto-deploy OpenClaw Anda. Untuk memperbaruinya, jalankan sinkronisasi Blueprint manual dari dashboard.Domain kustom
- Buka Dashboard → service Anda → Settings → Custom Domains
- Tambahkan domain Anda
- Konfigurasikan DNS sesuai petunjuk (CNAME ke
*.onrender.com) - Render akan memprovisikan sertifikat TLS secara otomatis
Scaling
Render mendukung scaling horizontal dan vertikal:- Vertikal: Ubah plan untuk mendapatkan lebih banyak CPU/RAM
- Horizontal: Tambah jumlah instance (plan Standard ke atas)
Backup dan migrasi
Ekspor state, konfigurasi, auth profile, dan workspace Anda kapan saja menggunakan akses shell di Render Dashboard:Pemecahan masalah
Service tidak mau mulai
Periksa log deploy di Render Dashboard. Masalah umum:OPENCLAW_GATEWAY_TOKENtidak ada — verifikasi bahwa variabel ini telah disetel di Dashboard → Environment- Ketidakcocokan port — pastikan
OPENCLAW_GATEWAY_PORT=8080disetel agar gateway bind ke port yang diharapkan Render
Cold start lambat (free tier)
Service free tier akan spin down setelah 15 menit tidak aktif. Permintaan pertama setelah spin-down memerlukan beberapa detik saat container mulai. Upgrade ke plan Starter untuk mode selalu aktif.Kehilangan data setelah redeploy
Ini terjadi di free tier (tanpa disk persisten). Upgrade ke plan berbayar, atau ekspor full backup secara rutin melaluiopenclaw backup create di shell Render.
Kegagalan health check
Render mengharapkan respons 200 dari/health dalam 30 detik. Jika build berhasil tetapi deploy gagal, service mungkin memerlukan waktu terlalu lama untuk mulai. Periksa:
- Log build untuk error
- Apakah container berjalan secara lokal dengan
docker build && docker run
Langkah selanjutnya
- Siapkan channel pesan: Channels
- Konfigurasikan Gateway: Konfigurasi Gateway
- Jaga OpenClaw tetap terbaru: Memperbarui