Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Render

Deploy OpenClaw di Render menggunakan Infrastructure as Code. Blueprint render.yaml yang disertakan mendefinisikan seluruh stack Anda secara deklaratif, layanan, disk, variabel lingkungan, sehingga Anda dapat melakukan deployment dengan satu klik dan membuat versi infrastruktur Anda berdampingan dengan kode Anda.

​
Prasyarat

​
Deploy dengan Render Blueprint

Deploy to Render Mengklik tautan ini akan:
  1. Membuat layanan Render baru dari Blueprint render.yaml di root repo ini.
  2. Membangun image Docker dan men-deploy
Setelah di-deploy, URL layanan Anda mengikuti pola https://<service-name>.onrender.com.

​
Memahami Blueprint

Render Blueprints adalah file YAML yang mendefinisikan infrastruktur Anda. render.yaml di repository ini mengonfigurasi semua yang diperlukan untuk menjalankan OpenClaw: 
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 # otomatis membuat token aman
    disk:
      name: openclaw-data
      mountPath: /data
      sizeGB: 1
Fitur Blueprint utama yang digunakan:
FiturTujuan
runtime: dockerMembangun dari Dockerfile repo
healthCheckPathRender memantau /health dan me-restart instance yang tidak sehat
generateValue: trueOtomatis membuat nilai yang aman secara kriptografis
diskPenyimpanan persisten yang bertahan setelah redeploy

​
Memilih paket

PaketSpin-downDiskTerbaik untuk
FreeSetelah 15 mnt idleTidak tersediaPengujian, demo
StarterTidak pernah1GB+Penggunaan pribadi, tim kecil
Standard+Tidak pernah1GB+Produksi, banyak channel
Blueprint secara default menggunakan starter. Untuk menggunakan tier gratis, ubah plan: free di render.yaml fork Anda (tetapi perhatikan: tanpa disk persisten berarti status OpenClaw di-reset pada setiap deployment).

​
Setelah deployment

​
Akses UI Control

Dashboard web tersedia di https://<your-service>.onrender.com/. Hubungkan menggunakan shared secret yang dikonfigurasi. Template deployment ini otomatis membuat OPENCLAW_GATEWAY_TOKEN (temukan di Dashboard → layanan Anda → Environment); jika Anda menggantinya dengan autentikasi kata sandi, gunakan kata sandi tersebut.

​
Fitur Dashboard Render

​
Log

Lihat log real-time di Dashboard → layanan Anda → Logs. Filter berdasarkan:
  • Log build (pembuatan image Docker)
  • Log deployment (startup layanan)
  • Log runtime (output aplikasi)

​
Akses shell

Untuk debugging, buka sesi shell melalui Dashboard → layanan Anda → Shell. Disk persisten dipasang di /data.

​
Variabel lingkungan

Ubah variabel di Dashboard → layanan Anda → Environment. Perubahan memicu redeploy otomatis.

​
Auto-deploy

Jika Anda menggunakan repository OpenClaw asli, Render tidak akan melakukan auto-deploy OpenClaw Anda. Untuk memperbaruinya, jalankan sinkronisasi Blueprint manual dari dashboard.

​
Domain kustom

  1. Buka Dashboard → layanan Anda → Settings → Custom Domains
  2. Tambahkan domain Anda
  3. Konfigurasikan DNS sesuai petunjuk (CNAME ke *.onrender.com)
  4. Render menyediakan sertifikat TLS secara otomatis

​
Scaling

Render mendukung scaling horizontal dan vertikal:
  • Vertikal: Ubah paket untuk mendapatkan lebih banyak CPU/RAM
  • Horizontal: Tambahkan jumlah instance (paket Standard ke atas)
Untuk OpenClaw, scaling vertikal biasanya sudah cukup. Scaling horizontal memerlukan sticky session atau manajemen status eksternal.

​
Backup dan migrasi

Ekspor status, konfigurasi, profil auth, dan workspace Anda kapan saja menggunakan akses shell di Dashboard Render: 
openclaw backup create
Ini membuat arsip backup portabel dengan status OpenClaw plus workspace yang dikonfigurasi. Lihat Backup untuk detail.

​
Pemecahan masalah

​
Layanan tidak mau mulai

Periksa log deployment di Dashboard Render. Masalah umum:
  • OPENCLAW_GATEWAY_TOKEN hilang — verifikasi bahwa nilainya sudah disetel di Dashboard → Environment
  • Ketidakcocokan port — pastikan OPENCLAW_GATEWAY_PORT=8080 disetel agar Gateway bind ke port yang diharapkan Render

​
Cold start lambat (tier gratis)

Layanan tier gratis akan spin down setelah 15 menit tidak aktif. Permintaan pertama setelah spin-down memerlukan beberapa detik saat container mulai. Upgrade ke paket Starter untuk always-on.

​
Kehilangan data setelah redeploy

Ini terjadi pada tier gratis (tanpa disk persisten). Upgrade ke paket berbayar, atau ekspor backup lengkap secara rutin melalui openclaw backup create di shell Render.

​
Kegagalan health check

Render mengharapkan respons 200 dari /health dalam 30 detik. Jika build berhasil tetapi deployment gagal, layanan mungkin memerlukan waktu terlalu lama untuk mulai. Periksa:
  • Log build untuk error
  • Apakah container berjalan secara lokal dengan docker build && docker run

​
Langkah berikutnya