Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://openclawhub.vn/llms.txt

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

Triển khai OpenClaw trên Render bằng cách sử dụng Infrastructure as Code. File render.yaml Blueprint đi kèm định nghĩa toàn bộ stack của bạn một cách khai báo, bao gồm dịch vụ, ổ đĩa, biến môi trường, giúp bạn triển khai chỉ với một cú nhấp chuột và quản lý phiên bản hạ tầng cùng với mã nguồn.

​
Điều kiện tiên quyết

​
Triển khai với Render Blueprint

Triển khai lên Render Nhấp vào liên kết này sẽ:
  1. Tạo dịch vụ Render mới từ render.yaml Blueprint tại thư mục gốc của repo này.
  2. Yêu cầu bạn thiết lập SETUP_PASSWORD
  3. Xây dựng Docker image và triển khai
Sau khi triển khai, URL dịch vụ của bạn sẽ có dạng https://<service-name>.onrender.com.

​
Hiểu về Blueprint

Render Blueprints là các file YAML định nghĩa hạ tầng của bạn. File render.yaml trong kho lưu trữ này cấu hình mọi thứ cần thiết để chạy OpenClaw: 
services:
  - type: web
    name: openclaw
    runtime: docker
    plan: starter
    healthCheckPath: /health
    envVars:
      - key: PORT
        value: "8080"
      - key: SETUP_PASSWORD
        sync: false # yêu cầu trong quá trình triển khai
      - key: OPENCLAW_STATE_DIR
        value: /data/.openclaw
      - key: OPENCLAW_WORKSPACE_DIR
        value: /data/workspace
      - key: OPENCLAW_GATEWAY_TOKEN
        generateValue: true # tự động tạo token bảo mật
    disk:
      name: openclaw-data
      mountPath: /data
      sizeGB: 1
Các tính năng chính của Blueprint:
Tính năngMục đích
runtime: dockerXây dựng từ Dockerfile của repo
healthCheckPathRender giám sát /health và khởi động lại các instance không khỏe mạnh
sync: falseYêu cầu giá trị trong quá trình triển khai (bí mật)
generateValue: trueTự động tạo giá trị bảo mật bằng mã hóa
diskLưu trữ dữ liệu bền vững qua các lần triển khai lại

​
Chọn gói

GóiTự động tắtỔ đĩaPhù hợp cho
FreeSau 15 phút không hoạt độngKhông khả dụngThử nghiệm, demo
StarterKhông bao giờ1GB+Sử dụng cá nhân, nhóm nhỏ
Standard+Không bao giờ1GB+Sản xuất, nhiều kênh
Blueprint mặc định là starter. Để sử dụng gói miễn phí, thay đổi plan: free trong render.yaml của bạn (lưu ý: không có ổ đĩa bền vững nghĩa là cấu hình sẽ bị đặt lại mỗi lần triển khai).

​
Sau khi triển khai

​
Hoàn tất thiết lập web

  1. Truy cập https://<your-service>.onrender.com/setup
  2. Nhập SETUP_PASSWORD
  3. Chọn nhà cung cấp mô hình và dán API key của bạn
  4. Tùy chọn cấu hình các kênh nhắn tin (Telegram, Discord, Slack)
  5. Nhấp Run setup

​
Truy cập Control UI

Bảng điều khiển web có sẵn tại https://<your-service>.onrender.com/openclaw.

​
Tính năng của Render Dashboard

​
Logs

Xem logs thời gian thực trong Dashboard → dịch vụ của bạn → Logs. Lọc theo:
  • Logs xây dựng (tạo Docker image)
  • Logs triển khai (khởi động dịch vụ)
  • Logs thời gian chạy (đầu ra ứng dụng)

​
Truy cập Shell

Để gỡ lỗi, mở phiên shell qua Dashboard → dịch vụ của bạn → Shell. Ổ đĩa bền vững được gắn tại /data.

​
Biến môi trường

Chỉnh sửa biến trong Dashboard → dịch vụ của bạn → Environment. Thay đổi sẽ kích hoạt triển khai lại tự động.

​
Tự động triển khai

Nếu bạn sử dụng kho lưu trữ OpenClaw gốc, Render sẽ không tự động triển khai OpenClaw của bạn. Để cập nhật, thực hiện đồng bộ Blueprint thủ công từ bảng điều khiển.

​
Tên miền tùy chỉnh

  1. Đi tới Dashboard → dịch vụ của bạn → Settings → Custom Domains
  2. Thêm tên miền của bạn
  3. Cấu hình DNS theo hướng dẫn (CNAME tới *.onrender.com)
  4. Render tự động cấp chứng chỉ TLS

​
Mở rộng

Render hỗ trợ mở rộng theo chiều ngang và chiều dọc:
  • Chiều dọc: Thay đổi gói để có thêm CPU/RAM
  • Chiều ngang: Tăng số lượng instance (gói Standard trở lên)
Đối với OpenClaw, mở rộng theo chiều dọc thường là đủ. Mở rộng theo chiều ngang yêu cầu phiên dính hoặc quản lý trạng thái bên ngoài.

​
Sao lưu và di chuyển

Xuất cấu hình và workspace của bạn bất kỳ lúc nào: 
https://<your-service>.onrender.com/setup/export
Điều này tải xuống một bản sao lưu có thể di chuyển mà bạn có thể khôi phục trên bất kỳ máy chủ OpenClaw nào.

​
Khắc phục sự cố

​
Dịch vụ không khởi động

Kiểm tra logs triển khai trong Render Dashboard. Các vấn đề thường gặp:
  • Thiếu SETUP_PASSWORD — Blueprint yêu cầu điều này, nhưng hãy xác minh đã thiết lập
  • Không khớp cổng — đảm bảo PORT=8080 khớp với cổng được mở trong Dockerfile

​
Khởi động chậm (gói miễn phí)

Dịch vụ gói miễn phí tự động tắt sau 15 phút không hoạt động. Yêu cầu đầu tiên sau khi tự động tắt mất vài giây để container khởi động. Nâng cấp lên gói Starter để luôn hoạt động.

​
Mất dữ liệu sau khi triển khai lại

Điều này xảy ra trên gói miễn phí (không có ổ đĩa bền vững). Nâng cấp lên gói trả phí, hoặc thường xuyên xuất cấu hình qua /setup/export.

​
Kiểm tra sức khỏe thất bại

Render mong đợi phản hồi 200 từ /health trong vòng 30 giây. Nếu xây dựng thành công nhưng triển khai thất bại, dịch vụ có thể mất quá nhiều thời gian để khởi động. Kiểm tra:
  • Logs xây dựng để tìm lỗi
  • Container có chạy cục bộ với docker build && docker run không

​
Bước tiếp theo

Last modified on March 22, 2026