Render

Deploy OpenClaw di Render menggunakan Blueprint render.yaml dari repositori. File tersebut mendeklarasikan layanan, disk, dan variabel lingkungan dalam satu file.

Prasyarat

Akun Render (tersedia paket gratis)
Kunci API dari penyedia model pilihan Anda

Deployment

Deploy ke Render Tindakan ini membuat layanan Render dari render.yaml, membangun image Docker, lalu melakukan deployment. URL layanan Anda mengikuti pola https://<service-name>.onrender.com.

Blueprint

services:
  - type: web
    name: openclaw
    runtime: docker
    plan: starter
    healthCheckPath: /health
    envVars:
      - key: OPENCLAW_GATEWAY_PORT
        value: "8080"
      - key: OPENCLAW_STATE_DIR
        value: /data/.openclaw
      - key: OPENCLAW_WORKSPACE_DIR
        value: /data/workspace
      - key: OPENCLAW_GATEWAY_TOKEN
        generateValue: true # membuat token aman secara otomatis
    disk:
      name: openclaw-data
      mountPath: /data
      sizeGB: 1

Fitur	Tujuan
`runtime: docker`	Membangun dari Dockerfile repositori
`healthCheckPath`	Render memantau `/health` dan memulai ulang instans yang bermasalah
`generateValue: true`	Membuat nilai yang aman secara kriptografis secara otomatis
`disk`	Penyimpanan persisten yang tetap ada setelah deployment ulang

Memilih paket

Paket	Penonaktifan	Disk	Paling sesuai untuk
Gratis	Setelah 15 menit nonaktif	Tidak tersedia	Pengujian, demo
Starter	Tidak pernah	1GB+	Penggunaan pribadi, tim kecil
Standard+	Tidak pernah	1GB+	Produksi, beberapa kanal

Blueprint menggunakan starter secara default. Untuk menggunakan paket gratis, ubah plan: free dalam render.yaml di fork Anda — perlu diketahui bahwa tanpa disk persisten, status OpenClaw akan direset pada setiap deployment.

Setelah deployment

Mengakses UI Kontrol

Dasbor web tersedia di https://<your-service>.onrender.com/. Hubungkan menggunakan rahasia bersama: OPENCLAW_GATEWAY_TOKEN yang dibuat secara otomatis (temukan di Dashboard → your service → Environment), atau kata sandi Anda jika beralih ke autentikasi kata sandi.

Log

Dashboard → your service → Logs menampilkan log pembangunan (pembuatan image Docker), log deployment (pengaktifan layanan), dan log waktu proses (keluaran aplikasi).

Akses shell

Dashboard → your service → Shell membuka sesi shell. Disk persisten dipasang di /data.

Variabel lingkungan

Edit variabel di Dashboard → your service → Environment. Perubahan memicu deployment ulang otomatis.

Deployment otomatis

Render secara otomatis melakukan deployment ulang ketika cabang repositori yang terhubung menerima commit baru. Jika Anda melakukan deployment langsung dari openclaw/openclaw, bukan dari fork sendiri, Anda tidak memiliki akses push untuk memicunya. Oleh karena itu, lakukan pembaruan dengan menjalankan sinkronisasi Blueprint secara manual dari Dashboard, atau arahkan layanan ke fork Anda sendiri.

Domain khusus

Dashboard → your service → Settings → Custom Domains
Tambahkan domain Anda
Konfigurasikan DNS sesuai petunjuk (CNAME ke *.onrender.com)
Render menyediakan sertifikat TLS secara otomatis

Penskalaan

Vertikal: ubah paket untuk mendapatkan lebih banyak CPU/RAM. Biasanya memadai untuk OpenClaw.
Horizontal: tingkatkan jumlah instans (paket Standard dan yang lebih tinggi). Memerlukan sesi lengket atau pengelolaan status eksternal karena OpenClaw menyimpan status waktu proses di disk lokal.

Pencadangan dan migrasi

Dari shell Render Dashboard, ekspor status, konfigurasi, profil autentikasi, dan ruang kerja kapan saja:

openclaw backup create

Perintah ini membuat arsip cadangan portabel. Lihat Pencadangan.

Pemecahan masalah

Layanan tidak dapat dimulai

Periksa log deployment di Render Dashboard. Masalah umum:

OPENCLAW_GATEWAY_TOKEN tidak ada — pastikan variabel tersebut telah ditetapkan di Dashboard → Environment
Port tidak cocok — pastikan OPENCLAW_GATEWAY_PORT=8080 agar Gateway mengikat ke port yang diharapkan Render

Cold start lambat (paket gratis)

Layanan paket gratis dinonaktifkan setelah 15 menit tidak aktif; permintaan pertama setelah penonaktifan memerlukan beberapa detik saat kontainer dimulai. Tingkatkan ke Starter agar layanan selalu aktif.

Kehilangan data setelah deployment ulang

Hal ini terjadi pada paket gratis (tanpa disk persisten). Tingkatkan ke paket berbayar, atau ekspor cadangan secara rutin dengan openclaw backup create dari shell Render.

Kegagalan pemeriksaan kesehatan

Jika pembangunan berhasil tetapi deployment gagal, layanan mungkin memerlukan waktu terlalu lama untuk dimulai atau /health mungkin tidak dapat dijangkau. Periksa:

Log pembangunan untuk menemukan kesalahan
Apakah kontainer berjalan secara lokal dengan docker build && docker run

Langkah berikutnya

Siapkan kanal perpesanan: Kanal
Konfigurasikan Gateway: Konfigurasi Gateway
Pastikan OpenClaw selalu diperbarui: Pembaruan

Install overview

Maintenance

Containers

Hosting

Advanced setup

Prasyarat

Deployment

Blueprint

Memilih paket

Setelah deployment

Mengakses UI Kontrol

Log

Akses shell

Variabel lingkungan

Deployment otomatis

Domain khusus

Penskalaan

Pencadangan dan migrasi

Pemecahan masalah

Layanan tidak dapat dimulai

Cold start lambat (paket gratis)

Kehilangan data setelah deployment ulang

Kegagalan pemeriksaan kesehatan

Langkah berikutnya

​Prasyarat

​Deployment

​Blueprint

​Memilih paket

​Setelah deployment

​Mengakses UI Kontrol

​Log

​Akses shell

​Variabel lingkungan

​Deployment otomatis

​Domain khusus

​Penskalaan

​Pencadangan dan migrasi

​Pemecahan masalah

​Layanan tidak dapat dimulai

​Cold start lambat (paket gratis)

​Kehilangan data setelah deployment ulang

​Kegagalan pemeriksaan kesehatan

​Langkah berikutnya

Prasyarat

Deployment

Blueprint

Memilih paket

Setelah deployment

Mengakses UI Kontrol

Log

Akses shell

Variabel lingkungan

Deployment otomatis

Domain khusus

Penskalaan

Pencadangan dan migrasi

Pemecahan masalah

Layanan tidak dapat dimulai

Cold start lambat (paket gratis)

Kehilangan data setelah deployment ulang

Kegagalan pemeriksaan kesehatan

Langkah berikutnya