Documentation Index

Fetch the complete documentation index at: https://openclawhub.vn/llms.txt

Use this file to discover all available pages before exploring further.

​

WebChat (Giao diện WebSocket của Gateway)

​

Giới thiệu

• Giao diện chat gốc cho gateway (không cần trình duyệt nhúng và không cần server tĩnh cục bộ).
• Sử dụng cùng 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.

​

Bắt đầu nhanh

1. Khởi động gateway.
2. Mở giao diện WebChat (ứng dụng macOS/iOS) hoặc tab chat trong Control UI.
3. Đảm bảo cấu hình xác thực gateway (mặc định yêu cầu, ngay cả khi loopback).

​

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

• Giao diện kết nối với Gateway WebSocket và sử dụng chat.history, chat.send, và chat.inject.
• chat.history được giới hạn để đảm bảo ổn định: Gateway có thể cắt ngắn các trường văn bản dài, bỏ qua metadata nặng, và thay thế các mục quá lớn bằng [chat.history omitted: message too large].
• chat.inject thêm ghi chú trợ lý trực tiếp vào bản ghi và phát tới giao diện (không cần chạy agent).
• Các lần chạy bị hủy có thể giữ lại một phần đầu ra của trợ lý hiển thị trên giao diện.
• Gateway lưu trữ văn bản trợ lý bị hủy vào lịch sử bản ghi khi có đầu ra được đệm, và đánh dấu các mục đó với metadata hủy.
• Lịch sử luôn được lấy từ gateway (không theo dõi file cục bộ).
• Nếu gateway không thể truy cập, WebChat chỉ có thể đọc.

​

Bảng công cụ của Control UI agents

• Bảng Công cụ /agents của Control UI lấy danh mục runtime qua tools.catalog và gắn nhãn mỗi công cụ là core hoặc plugin:<id> (cộng thêm optional cho các công cụ plugin tùy chọn).
• Nếu tools.catalog không khả dụng, bảng sẽ sử dụng danh sách tĩnh tích hợp sẵn.
• Bảng chỉnh sửa cấu hình profile và override, nhưng quyền truy cập runtime hiệu quả vẫn tuân theo thứ tự ưu tiên chính sách (allow/deny, theo từng agent và override của provider/kênh).

​

Sử dụng từ xa

• Chế độ từ xa tạo đường hầm cho Gateway WebSocket qua SSH/Tailscale.
• Không cần chạy server WebChat riêng biệt.

​

Tham khảo cấu hình (WebChat)

• Không có khối webchat.* riêng biệt. WebChat sử dụng endpoint của gateway + cài đặt xác thực dưới đây.

• gateway.port, gateway.bind: host/port của WebSocket.
• gateway.auth.mode, gateway.auth.token, gateway.auth.password: xác thực WebSocket (token/mật khẩu).
• gateway.auth.mode: "trusted-proxy": xác thực reverse-proxy cho trình duyệt (xem Trusted Proxy Auth).
• gateway.remote.url, gateway.remote.token, gateway.remote.password: mục tiêu gateway từ xa.
• session.*: lưu trữ phiên và các khóa chính mặc định.