feat: update readme for more detail information and add instruction, fix dashboard pairing error, update gitignore for memory files

This commit is contained in:
2026-04-02 15:26:32 +07:00
parent 48f047b52c
commit a1f673272a
4 changed files with 27 additions and 17 deletions
+21 -7
View File
@@ -120,7 +120,7 @@ docker compose exec openclaw-cli openclaw status
docker compose exec openclaw-cli openclaw --version
```
## ⚙️ Cấu trúc Volumes & Dữ liệu
## ⚙️ Setup để bắt đầu sử dụng
| Host Path (mặc định) | Mount trong container | Mục đích |
|----------------------|-----------------------|----------|
@@ -129,7 +129,6 @@ docker compose exec openclaw-cli openclaw --version
> Thư mục `.openclaw/` được tạo tự động khi gateway khởi động lần đầu. Tất cả cấu hình (token, origins, …) lưu tại đây và **persist qua các lần restart**.Nói cách khác, thư mục `.openclaw` chính là "bộ não" chứa dữ liệu của hệ thống. Để AI có thể hoạt động, bạn cần cấp "chìa khóa" (API Keys). Có 2 cách để thực hiện:
**Cách 1: Cấu hình qua Giao diện Web (Khuyên dùng)**
Truy cập trực tiếp vào Terminal hệ thống `cli` (đây là nơi được tạo ra để kỹ sư có thể thao tác tương tác):
```bash
docker exec -it openclaw-team-repo-openclaw-cli-1 bash
@@ -139,14 +138,29 @@ Sau đó, trong container hãy thực thi lệnh thiết lập:
openclaw setup
```
**Cách 2: Cấu hình qua Terminal (bằng container CLI)**
Hệ thống Gateway mặc định có sẵn thiết lập khởi chạy không cần config, bạn có thể thiết lập trực tiếp trên web bằng cách:
* Mở trình duyệt và truy cập `http://localhost:18789` (Hoặc địa chỉ IP máy chủ của bạn với cổng `18789`).
Tại giao diện Web, hệ thống sẽ tự động hiển thị Wizard Setup để bạn điền các API Key (OpenAI, Anthropic, Gemini...). Các thông tin này sẽ được lưu ngầm tự động xuống thư mục `.openclaw`.
Sau đó chạy lệnh
```bash
openclaw configure
```
Các phần bạn cần config trước khi bắt đầu sử dụng:
- Channels:
Telegram (recommend):
Chọn Enter Telegram bot token (Cách lấy token có thể tham khảo ở `https://help.superchat.com/en/articles/14901-how-do-i-get-the-telegram-token-or-bot-id`)
Sau khi nhập xong token thì sẽ hỏi "Config DM access policies now?" -> (chọn `No`)
Sau khi config xong thì vào chat với bot, nó sẽ yêu cầu chạy lệnh `openclaw pairing approve telegram [id]` trong terminal thì hãy chạy để xác nhận kết nối.
- Model:
Nếu mọi người sử dụng API có trả phí thì có thể chọn `OpenAI` hoặc `Anthropic`.
Còn nếu mọi người sử dụng API free thì có thể chọn:
- `OpenRouter` (recommend): Các model em thấy sử dụng tốt gồm `Step 3.5 Flash (free)` (đặt làm primary), `Arcee Trinity Large preview: free` (đặt làm fallback) và `NVIDIA-Nemotron-3-Super-120B-A12B: free` (đặt làm fallback). Lưu ý: Không nên để auto vì đôi khi sẽ chọn những model không có khả năng suy luận hoặc model phải có suy luận.
- `Copilot` (Github Copilot Oauth): Sẽ được free model `GPT-5.1 mini``GPT-4.1`
Sau khi config xong, mọi người hãy chạy lệnh `openclaw dashboard` và mở link Dashboard Url `http://localhost:18789` để kiểm tra.
Nếu nó báo lỗi `unauthorized: need pairing` thì mọi người vào chạy lệnh `openclaw devices list` để kiểm tra device đang request pairing và dùng `openclaw devices approve` để approve (không cần thêm id cũng được). Sau đó mọi người vào lại `http:localhost:18789` để kiểm tra lại thì sẽ được.
> **Cảnh báo:** Mọi tệp cấu hình bảo mật sẽ nằm ở thư mục `.openclaw` trên máy tính tải về. Thư mục này đã có trong `.gitignore`. Tuyệt đối KHÔNG sử dụng lệnh ép buộc (force add) để đẩy các tệp thuộc `.openclaw` lên Github nhằm tránh rò rỉ thông tin bảo mật.
---
## 🌐 Cổng kết nối (Ports)