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

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

Triển khai OpenClaw trên Render bằng Infrastructure as Code. Blueprint render.yaml đi kèm định nghĩa toàn bộ stack của bạn theo cách khai báo, gồm service, disk, biến môi trường, để bạn có thể triển khai chỉ bằng một cú nhấp 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 bằng Render Blueprint

Triển khai lên Render Khi nhấp vào liên kết này, hệ thống sẽ:
  1. Tạo một Render service mới từ Blueprint render.yaml ở thư mục gốc của repo này.
  2. Build Docker image và triển khai
Sau khi triển khai, URL service của bạn có dạng https://<service-name>.onrender.com.

​
Tìm hiểu Blueprint

Render Blueprints là các tệp YAML định nghĩa hạ tầng của bạn. render.yaml trong repository 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: 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 # auto-generates a secure token
    disk:
      name: openclaw-data
      mountPath: /data
      sizeGB: 1
Các tính năng Blueprint chính được sử dụng:
Tính năngMục đích
runtime: dockerBuild từ Dockerfile của repo
healthCheckPathRender giám sát /health và khởi động lại instance lỗi
generateValue: trueTự động tạo một giá trị bảo mật bằng mật mã học
diskLưu trữ bền vững tồn tại qua các lần triển khai lại

​
Chọn gói

GóiTạm dừngDiskPhù hợp nhất cho
FreeSau 15 phút rảnhKhông cóKiểm thử, demo
StarterKhông bao giờ1GB+Sử dụng cá nhân, nhóm nhỏ
Standard+Không bao giờ1GB+Production, nhiều kênh
Blueprint mặc định dùng starter. Để dùng gói miễn phí, hãy đổi plan: free trong render.yaml của fork của bạn (nhưng lưu ý: không có disk bền vững nghĩa là trạng thái OpenClaw sẽ đặt lại ở mỗi lần triển khai).

​
Sau khi triển khai

​
Truy cập Control UI

Bảng điều khiển web có tại https://<your-service>.onrender.com/. Kết nối bằng shared secret đã cấu hình. Mẫu triển khai này tự động tạo OPENCLAW_GATEWAY_TOKEN (tìm trong Dashboard → service của bạn → Environment); nếu bạn thay bằng xác thực mật khẩu, hãy dùng mật khẩu đó thay vào.

​
Tính năng Render Dashboard

​
Nhật ký

Xem nhật ký thời gian thực trong Dashboard → service của bạn → Logs. Lọc theo:
  • Nhật ký build (tạo Docker image)
  • Nhật ký triển khai (khởi động service)
  • Nhật ký runtime (đầu ra ứng dụng)

​
Truy cập shell

Để debug, mở một phiên shell qua Dashboard → service của bạn → Shell. Disk bền vững được mount tại /data.

​
Biến môi trường

Sửa đổi biến trong Dashboard → service của bạn → Environment. Các thay đổi sẽ kích hoạt triển khai lại tự động.

​
Tự động triển khai

Nếu bạn dùng repository OpenClaw gốc, Render sẽ không tự động triển khai OpenClaw của bạn. Để cập nhật, hãy chạy đồng bộ Blueprint thủ công từ dashboard.

​
Miền tùy chỉnh

  1. Vào Dashboard → service của bạn → Settings → Custom Domains
  2. Thêm 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 quy mô

Render hỗ trợ mở rộng theo chiều ngang và chiều dọc:
  • Chiều dọc: Đổi gói để có thêm CPU/RAM
  • Chiều ngang: Tăng số lượng instance (gói Standard trở lên)
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 sticky sessions hoặc quản lý trạng thái bên ngoài.

​
Sao lưu và di chuyển

Xuất trạng thái, cấu hình, hồ sơ xác thực và workspace của bạn bất cứ lúc nào bằng quyền truy cập shell trong Render Dashboard: 
openclaw backup create
Lệnh này tạo một kho lưu trữ sao lưu có thể di chuyển, gồm trạng thái OpenClaw cùng mọi workspace đã cấu hình. Xem Sao lưu để biết chi tiết.

​
Khắc phục sự cố

​
Service không khởi động

Kiểm tra nhật ký triển khai trong Render Dashboard. Các vấn đề thường gặp:
  • Thiếu OPENCLAW_GATEWAY_TOKEN — xác minh rằng nó đã được đặt trong Dashboard → Environment
  • Không khớp cổng — đảm bảo OPENCLAW_GATEWAY_PORT=8080 được đặt để gateway bind vào cổng Render mong đợi

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

Service gói miễn phí tạm dừng sau 15 phút không hoạt động. Yêu cầu đầu tiên sau khi tạm dừng mất vài giây trong khi container khởi động. Nâng cấp lên gói Starter để luôn bật.

​
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ó disk bền vững). Nâng cấp lên gói trả phí, hoặc thường xuyên xuất bản sao lưu đầy đủ bằng openclaw backup create trong Render shell.

​
Lỗi health check

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

​
Bước tiếp theo