---
title: "Hướng Dẫn Khắc Phục Lỗi \"Origin Not Allowed\" Trên OpenClaw"
description: "Lỗi \"origin not allowed\" là một thông báo bảo mật phổ biến khi vận hành OpenClaw. Bài viết này sẽ giúp bạn hiểu rõ nguyên nhân và các bước xử lý triệt để vấn đề này."
url: https://cloudfly.vn/huong-dan-khac-phuc-loi-origin-not-allowed-tren-openclaw
image: https://media.cloudfly.vn/posts/9464b368-a737-465b-b93f-79507085da93_JPxAOJo.png
---

# Hướng Dẫn Khắc Phục Lỗi "Origin Not Allowed" Trên OpenClaw

![](https://media.cloudfly.vn/posts/9464b368-a737-465b-b93f-79507085da93.png)

Khi triển khai hoặc sử dụng OpenClaw, đôi khi bạn sẽ gặp thông báo lỗi **“Origin Not Allowed”** khi truy cập vào Control UI. Đây là một lỗi khá phổ biến, thường xảy ra khi Control UI không được Gateway cho phép kết nối do cơ chế bảo mật.

Lỗi này không phải do hệ thống bị hỏng, mà thường liên quan đến cấu hình **domain, protocol (HTTP/HTTPS)** hoặc **danh sách whitelist của Gateway**. Chỉ cần điều chỉnh lại cấu hình phù hợp là bạn có thể khắc phục được.

Trong bài viết này, chúng ta sẽ cùng tìm hiểu **nguyên nhân gây ra lỗi “Origin Not Allowed” và các bước khắc phục chi tiết** để hệ thống OpenClaw hoạt động bình thường trở lại.

## 1\. Dấu hiệu và Nguyên nhân

Khi truy cập vào Control UI của OpenClaw, hệ thống hiển thị thông báo lỗi duy nhất: origin not allowed.  
![](https://media.cloudfly.vn/posts/mceclip0_J9qkgpr.png)

### Nguyên nhân:

Đây là cơ chế bảo vệ CORS (Cross-Origin Resource Sharing) của OpenClaw Gateway. Lỗi xảy ra khi:

*   Khác biệt về Protocol: Gateway chạy HTTP nhưng Control UI chạy HTTPS.
    
*   Khác biệt về Domain: Domain của Control UI chưa được khai báo trong danh sách trắng (Whitelist) của Gateway.
    
*   Ví dụ: Gateway đang chạy tại http://localhost:8080 nhưng bạn truy cập Control UI qua https://domain.
    

## 2\. Quy trình xử lý (3 bước)

### Bước 1: Whitelist Domain của Control UI

Bạn cần thêm chính xác địa chỉ domain mà bạn dùng để truy cập Control UI vào cấu hình của OpenClaw.

Sử dụng lệnh sau trong terminal:

> openclaw config set gateway.controlUi.allowedOrigins '\["https://your-domain.com"\]'

**ví dụ tên miền:  
![](https://media.cloudfly.vn/posts/mceclip1_zSUnyvT.png)  
**

Lưu ý: Thay https://your-domain.com bằng domain thực tế của bạn (phải bao gồm cả https:// hoặc http://).

### Bước 2: Xác nhận cấu hình

Để đảm bảo giá trị đã được ghi đè chính xác vào hệ thống, hãy chạy lệnh kiểm tra:

openclaw config get gateway.controlUi

Kết quả mong đợi:

> JSON
> 
> {
> 
>   "allowedOrigins": \[
> 
>     "https://your-domain.com"
> 
>   \]
> 
> }

**![](https://media.cloudfly.vn/posts/mceclip2_tDojSiM.png)  
**

### Bước 3: Khởi động lại dịch vụ

Cấu hình chỉ có hiệu lực sau khi Gateway được nạp lại. Hãy thực hiện restart:

> openclaw gateway restart

![](https://media.cloudfly.vn/posts/mceclip3_41rue8g.png)

## 3\. Các trường hợp mở rộng

### Cấu hình cho nhiều Domain

Nếu bạn quản trị OpenClaw từ nhiều địa chỉ khác nhau (ví dụ: cả domain chính và sub-domain), hãy sử dụng định dạng mảng:

> openclaw config set gateway.controlUi.allowedOrigins '\["https://n3tworks.io.vn", "https://admin.n3tworks.io.vn"\]'

### Xử lý lỗi "Config path not found"

Nếu hệ thống báo Config path not found: gateway.controlUi, bạn đừng lo lắng. Đây không phải lỗi hệ thống mà chỉ là thông báo rằng key này chưa từng được khởi tạo. Khi bạn thực hiện lệnh set ở Bước 1, OpenClaw sẽ tự động tạo mới đường dẫn này.

##   
4.Lỗi “Unauthorized: Gateway Token Mismatch”

### Dấu hiệu

Khi truy cập vào **OpenClaw Gateway Dashboard**, hệ thống hiển thị thông báo:  
![](https://media.cloudfly.vn/posts/mceclip4_UQVOJOS.png)

### Cách khắc phục

#### Bước 1: Lấy Gateway Token

> openclaw dashboard

![](https://media.cloudfly.vn/posts/mceclip5_6eP1HL0.png)

Sau đó tìm **Gateway Token** được hiển thị trong trang dashboard. Chính là cái này  
  
![](https://media.cloudfly.vn/posts/mceclip6_XoAvnUF.png)

Sau đó truy cập ulr:  
[https://n3tworks.io.vn/#token=c00ae012095702ea4864c47997981f5d74adf5a23ab130c7](https://n3tworks.io.vn/#token=c00ae012095702ea4864c47997981f5d74adf5a23ab130c7)  
  
![Image](https://cloudfly.vn/_next/image?url=https%3A%2F%2Fmedia.cloudfly.vn%2Fposts%2Fmceclip32.png&w=1200&q=85)

## 5\. Checklist kiểm tra nhanh (Troubleshooting)

Nếu sau khi làm các bước trên vẫn gặp lỗi, hãy rà soát lại các mục sau:

| STT | Hạng mục kiểm tra | Chi tiết |
| --- | --- | --- |
| 1 | Giao thức (Protocol) | Đảm bảo domain trong config có https:// nếu website của bạn có SSL. |
| 2 | Dấu ngoặc | Lệnh set config yêu cầu định dạng mảng JSON \[' "domain" '\] (chú ý dấu nháy đơn/kép). |
| 3 | Trạng thái Gateway | Đảm bảo lệnh restart đã thực hiện thành công. |
| 4 | Trình duyệt | Thử xóa Cache trình duyệt hoặc mở tab ẩn danh để loại bỏ dữ liệu cũ. |

## Kết luận

Việc kiểm soát allowedOrigins là lớp bảo mật quan trọng để ngăn chặn các truy cập trái phép vào Gateway của bạn. Chỉ cần đảm bảo Khai báo đúng Domain và Restart Gateway, bạn sẽ truy cập Control UI bình thường.

## CloudFly đơn vị tiên phong tại Việt Nam cung cấp dịch vụ Cloud Server và Cloud Hosting tùy chỉnh cấu hình

CLOUDFLY tự hào là đơn vị tiên phong tại Việt Nam cung cấp dịch vụ [Cloud Server](https://cloudfly.vn/cloud-server), [Cloud Hosting](https://cloudfly.vn/cloud-hosting) [tùy chỉnh cấu hình](https://cloudfly.vn/cloud-hosting). Chúng tôi nhận được sự tin tưởng và hợp tác với hơn 15.000 khách hàng trong và ngoài nước. Sẵn sàng đồng hành và đem lại những giải pháp tối ưu nhất cho bạn.

Nếu quý khách hàng gặp khó khăn hay có bất kì thắc mắc nào. Hãy liên hệ theo thông tin bên dưới.

**CloudFly** - Đơn giản hóa ứng dụng trên đám mây

**HOTLINE**: 0904.558.448

**WEBSITE**: [https://cloudfly.vn/](https://cloudfly.vn/)

**FACEBOOK**: [https://www.facebook.com/cloudfly.vn](https://www.facebook.com/cloudfly.vn)

**TELEGRAM CHANNELS**: [https://t.me/cloudflyvn](https://t.me/cloudflyvn)