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

# WebChat

# WebChat (Giao diện WebSocket Gateway)

Trạng thái: giao diện chat SwiftUI trên macOS/iOS giao tiếp trực tiếp với Gateway WebSocket.

## WebChat là gì

* Giao diện chat native cho gateway (không nhúng trình duyệt và không có máy chủ tĩnh cục bộ).
* Sử dụng cùng các phiên và quy tắc định tuyến như các kênh khác.
* Định tuyến xác định: phản hồi luôn quay lại WebChat.

## Khởi động nhanh

1. Khởi động gateway.
2. Mở giao diện WebChat (ứng dụng macOS/iOS) hoặc tab chat của Control UI.
3. Đảm bảo xác thực gateway đã được cấu hình (mặc định là bắt buộc, kể cả trên local loopback).

## Cách hoạt động (hành vi)

* UI kết nối tới Gateway WebSocket và sử dụng `chat.history`, `chat.send` và `chat.inject`.
* `chat.inject` thêm một ghi chú của trợ lý trực tiếp vào bản ghi hội thoại và phát tới UI (không chạy agent).
* Lịch sử luôn được lấy từ gateway (không theo dõi tệp cục bộ).
* Nếu gateway không truy cập được, WebChat ở chế độ chỉ đọc.

## Sử dụng từ xa

* Chế độ từ xa tạo đường hầm Gateway WebSocket qua SSH/Tailscale.
* Bạn không cần chạy một máy chủ WebChat riêng.

## Tham chiếu cấu hình (WebChat)

Cấu hình đầy đủ: [Configuration](/gateway/configuration)

Tùy chọn kênh:

* Không có khối `webchat.*` riêng biệt. WebChat sử dụng endpoint của gateway + các thiết lập xác thực bên dưới.

Các tùy chọn toàn cục liên quan:

* `gateway.port`, `gateway.bind`: máy chủ/cổng WebSocket.
* `gateway.auth.mode`, `gateway.auth.token`, `gateway.auth.password`: xác thực WebSocket.
* `gateway.remote.url`, `gateway.remote.token`, `gateway.remote.password`: đích gateway từ xa.
* `session.*`: lưu trữ phiên và các giá trị mặc định của khóa chính.
* `session.*`: lưu trữ phiên và các giá trị mặc định của khóa chính.