Kết xuất

Triển khai OpenClaw trên Render bằng Blueprint render.yaml của kho mã nguồn. Tệp này khai báo dịch vụ, ổ đĩa và các biến môi trường trong một tệp duy nhất.

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

• Một tài khoản Render (có gói miễn phí)
• Khóa API từ nhà cung cấp mô hình bạn ưu tiên

Triển khai

Triển khai lên Render

Thao tác này tạo một dịch vụ Render từ render.yaml, xây dựng ảnh Docker và triển khai dịch vụ. URL dịch vụ của bạn có dạng 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 # tự động tạo một token bảo mật    disk:      name: openclaw-data      mountPath: /data      sizeGB: 1

Chọn gói

Blueprint mặc định sử dụng starter. Để dùng gói miễn phí, hãy đổi thành plan: free trong render.yaml của bản fork — lưu ý rằng khi không có ổ đĩa bền vững, trạng thái OpenClaw sẽ được đặt lại sau mỗi lần triển khai.

Sau khi triển khai

Truy cập giao diện điều khiển

Bảng điều khiển web có tại https://<your-service>.onrender.com/. Kết nối bằng bí mật dùng chung: OPENCLAW_GATEWAY_TOKEN được tạo tự động (tìm trong Dashboard → your service → Environment), hoặc mật khẩu của bạn nếu đã chuyển sang xác thực bằng mật khẩu.

Nhật ký

Dashboard → your service → Logs hiển thị nhật ký xây dựng (tạo ảnh Docker), nhật ký triển khai (khởi động dịch vụ) và nhật ký thời gian chạy (đầu ra của ứng dụng).

Truy cập shell

Dashboard → your service → Shell mở một phiên shell. Ổ đĩa bền vững được gắn tại /data.

Biến môi trường

Chỉnh sửa các biến trong Dashboard → your service → Environment. Các thay đổi sẽ kích hoạt quá trình tự động triển khai lại.

Tự động triển khai

Render tự động triển khai lại khi nhánh của kho mã nguồn được kết nối có commit mới. Nếu bạn triển khai trực tiếp từ openclaw/openclaw thay vì bản fork của riêng mình, bạn không có quyền đẩy mã để kích hoạt quá trình này; vì vậy, hãy cập nhật bằng cách chạy đồng bộ Blueprint thủ công từ Dashboard hoặc trỏ dịch vụ đến bản fork của riêng bạn.

Miền tùy chỉnh

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

Mở rộng quy mô

• Theo chiều dọc: đổi gói để có thêm CPU/RAM. Thường là đủ cho OpenClaw.
• Theo chiều ngang: tăng số lượng phiên bản (gói Standard trở lên). Yêu cầu phiên cố định hoặc quản lý trạng thái bên ngoài vì OpenClaw lưu trạng thái thời gian chạy trên ổ đĩa cục bộ.

Sao lưu và di chuyển

Từ shell trong Render Dashboard, bạn có thể xuất trạng thái, cấu hình, hồ sơ xác thực và không gian làm việc bất cứ lúc nào:

openclaw backup create

Lệnh này tạo một kho lưu trữ sao lưu có thể di chuyển. Xem Sao lưu.

Khắc phục sự cố

Dịch vụ 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 biến này đã được đặt trong Dashboard → Environment
• Cổng không khớp — bảo đảm OPENCLAW_GATEWAY_PORT=8080 để Gateway liên kết với cổng mà Render mong đợi

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

Các dịch vụ thuộc gói miễn phí sẽ 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 sẽ mất vài giây trong khi vùng chứa khởi động. Nâng cấp lên Starter để dịch vụ luôn hoạt động.

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

Điều này xảy ra ở 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 bản sao lưu bằng openclaw backup create từ shell của Render.

Kiểm tra tình trạng không thành công

Nếu quá trình 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 hoặc không thể truy cập /health. Hãy kiểm tra:

• Nhật ký xây dựng để tìm lỗi
• Vùng chứa có chạy cục bộ bằng docker build && docker run hay không

Các bước tiếp theo

• Thiết lập các kênh nhắn tin: Kênh
• Cấu hình Gateway: Cấu hình Gateway
• Duy trì OpenClaw ở phiên bản mới nhất: Cập nhật