> ## Documentation Index
> Fetch the complete documentation index at: https://openclawhub.vn/llms.txt
> Use this file to discover all available pages before exploring further.

# Hướng Dẫn Cài Đặt OpenClaw Trên Render

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

* Tài khoản [Render](https://render.com) (có sẵn gói miễn phí)
* API key từ [nhà cung cấp mô hình](/providers) bạn chọn

## Triển khai với Render Blueprint

[Triển khai lên Render](https://render.com/deploy?repo=https://github.com/openclaw/openclaw)

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:

```yaml theme={"theme":{"light":"min-light","dark":"min-dark"}}
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ăng             | Mục đích                                                                |
| --------------------- | ----------------------------------------------------------------------- |
| `runtime: docker`     | Xây dựng từ Dockerfile của repo                                         |
| `healthCheckPath`     | Render giám sát `/health` và khởi động lại các instance không khỏe mạnh |
| `sync: false`         | Yêu cầu giá trị trong quá trình triển khai (bí mật)                     |
| `generateValue: true` | Tự động tạo giá trị bảo mật bằng mã hóa                                 |
| `disk`                | Lưu trữ dữ liệu bền vững qua các lần triển khai lại                     |

## Chọn gói

| Gói       | Tự động tắt                 | Ổ đĩa          | Phù hợp cho               |
| --------- | --------------------------- | -------------- | ------------------------- |
| Free      | Sau 15 phút không hoạt động | Không khả dụng | Thử nghiệm, demo          |
| Starter   | Khô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

* Thiết lập các kênh nhắn tin: [Channels](/channels)
* Cấu hình Gateway: [Gateway configuration](/gateway/configuration)
* Giữ OpenClaw luôn cập nhật: [Updating](/install/updating)