> ## 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 Sử Dụng OpenClaw Trợ Lý AI
# OpenClaw 🦞
> *"EXFOLIATE! EXFOLIATE!"* — Có lẽ là lời của một con tôm hùm vũ trụ nào đó
Gateway chạy trên mọi hệ điều hành dành cho các tác nhân AI qua WhatsApp, Telegram, Discord, iMessage và nhiều nền tảng khác.
Chỉ cần gửi tin nhắn là bạn sẽ nhận được phản hồi từ AI ngay trên điện thoại. Có thể bổ sung Mattermost và các kênh khác thông qua plugin.
Cài đặt OpenClaw và khởi chạy Gateway chỉ trong vài phút.
Thiết lập theo từng bước với lệnh `openclaw onboard` và quy trình liên kết.
Khởi chạy bảng điều khiển (dashboard) trên trình duyệt để quản lý chat, cấu hình và phiên (sessions).
## OpenClaw là gì?
OpenClaw là một **gateway tự lưu trữ (self-hosted)** giúp kết nối các ứng dụng chat quen thuộc của bạn — như WhatsApp, Telegram, Discord, iMessage, và nhiều nền tảng khác — với các tác nhân AI lập trình như Pi. Bạn chỉ cần chạy một quy trình Gateway duy nhất trên máy tính (hoặc server) của mình, và nó sẽ trở thành cầu nối giữa các ứng dụng nhắn tin và trợ lý AI luôn sẵn sàng phục vụ.
**Dành cho ai?** Dành cho các nhà phát triển và người dùng chuyên nghiệp (power users) muốn có một trợ lý AI cá nhân để nhắn tin từ bất kỳ đâu — mà không phải đánh đổi quyền kiểm soát dữ liệu hay phụ thuộc vào các dịch vụ bên thứ ba.
**Điều gì làm nên sự khác biệt?**
* **Tự lưu trữ**: chạy trên thiết bị của bạn, theo quy tắc của bạn
* **Đa kênh**: một Gateway duy nhất phục vụ đồng thời WhatsApp, Telegram, Discord và nhiều kênh khác
* **Tối ưu cho tác nhân AI**: được xây dựng riêng cho các tác nhân lập trình với khả năng sử dụng công cụ, quản lý phiên (sessions), bộ nhớ (memory) và định tuyến đa tác nhân (multi-agent routing)
* **Mã nguồn mở**: cấp phép theo chuẩn MIT, thân thiện với cộng đồng
**Bạn cần chuẩn bị gì?** Node 24 (khuyên dùng), hoặc Node 22 LTS (`22.16+`) để tương thích tốt nhất; một API key từ nhà cung cấp mô hình (provider) bạn chọn; và khoảng 5 phút thiết lập. Để đạt được chất lượng và độ bảo mật cao nhất, hãy sử dụng mô hình thế hệ mới nhất hiện có.
## Cách thức hoạt động
```mermaid theme={"theme":{"light":"min-light","dark":"min-dark"}}
flowchart LR
A["Các ứng dụng chat + plugin"] --> B["Gateway"]
B --> C["Tác nhân Pi"]
B --> D["CLI"]
B --> E["Web Control UI"]
B --> F["Ứng dụng macOS"]
B --> G["Các node iOS và Android"]
```
Gateway đóng vai trò là nguồn dữ liệu thực (source of truth) duy nhất quản lý các phiên (sessions), định tuyến (routing) và các kết nối kênh.
## Các tính năng chính
Kết nối WhatsApp, Telegram, Discord và iMessage chỉ bằng một quy trình Gateway duy nhất.
Bổ sung Mattermost và các nền tảng khác bằng các gói tiện ích mở rộng (extension).
Các phiên được tách biệt riêng cho từng tác nhân, workspace hoặc người gửi.
Gửi và nhận hình ảnh, âm thanh, cũng như tài liệu.
Bảng điều khiển trên trình duyệt để quản lý chat, cấu hình, phiên và các node.
Liên kết các node iOS và Android để sử dụng Canvas, camera và các luồng công việc kích hoạt bằng giọng nói.
## Hướng dẫn nhanh
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
npm install -g openclaw@latest
```
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --install-daemon
```
Mở Control UI trên trình duyệt và gửi tin nhắn:
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw dashboard
```
Hoặc kết nối một kênh ([Telegram](/channels/telegram) dễ kết nối nhất) và chat ngay từ điện thoại của bạn.
Nếu bạn cần hướng dẫn chi tiết về quy trình cài đặt và thiết lập môi trường phát triển (dev setup), hãy xem phần [Bắt đầu](/start/getting-started).
## Bảng điều khiển (Dashboard)
Mở Control UI trên trình duyệt sau khi Gateway khởi động thành công.
* Mặc định trên máy cục bộ: [http://127.0.0.1:18789/](http://127.0.0.1:18789/)
* Truy cập từ xa: Qua [các giao diện Web](/web) và [Tailscale](/gateway/tailscale)
## Cấu hình (Tùy chọn)
File cấu hình được lưu tại `~/.openclaw/openclaw.json`.
* Nếu bạn **không thiết lập gì**, OpenClaw sẽ sử dụng luồng chạy (binary) Pi được tích hợp sẵn ở chế độ RPC với các phiên được tách riêng theo từng người gửi.
* Nếu bạn muốn thắt chặt quyền truy cập, hãy bắt đầu với mục `channels.whatsapp.allowFrom` và cấu hình luật bắt buộc nhắc đến (requireMention) đối với các nhóm.
Ví dụ:
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
channels: {
whatsapp: {
allowFrom: ["+15555550123"],
groups: { "*": { requireMention: true } },
},
},
messages: { groupChat: { mentionPatterns: ["@openclaw"] } },
}
```
## Bắt đầu từ đây
Toàn bộ tài liệu và hướng dẫn, được phân loại theo từng mục đích sử dụng.
Các thiết lập cốt lõi của Gateway, quản lý token và cấu hình nhà cung cấp (provider).
Tổ chức truy cập qua SSH và mạng tailnet.
Hướng dẫn thao tác thiết lập đặc thù cho WhatsApp, Telegram, Discord và nhiều nền tảng khác.
Các node trên iOS và Android với khả năng kết nối thiết bị để dùng Canvas, camera và ra lệnh hệ thống.
Điểm dừng chân đầu tiên khi có sự cố và các cách khắc phục phổ biến.
## Tìm hiểu thêm
Tổng hợp toàn bộ khả năng về kênh hỗ trợ, định tuyến và đa phương tiện.
Sự tách biệt workspace và quản lý phiên (session) theo từng tác nhân.
Quản lý tokens, danh sách cho phép (allowlists) và các lớp kiểm soát an toàn.
Công cụ chẩn đoán Gateway và các lỗi thường gặp trong quá trình vận hành.
Nguồn gốc dự án, những người đóng góp và thông tin giấy phép.