V-Claw là gì?

V-Claw là lớp phân phối và bản địa hóa dựa trên OpenClaw, được tối ưu để người dùng Việt Nam có thể bắt đầu dùng trợ lý AI nhanh hơn. Bạn có thể chạy từ USB, cài trực tiếp lên máy tính hoặc dùng bản Linux khởi động tùy nhu cầu.

Bắt đầu trong 3 phút

1. Chọn một hình thức cài đặt ở phần dưới.
2. Chạy openclaw onboard hoặc mở trang cấu hình đi kèm.
3. Chọn model AI, nhập API key, sau đó mở bảng điều khiển để bắt đầu chat.

Chọn cách cài phù hợp

Bản USB di động

Bản này giữ cấu hình, dữ liệu và trạng thái làm việc trên USB. Bạn cắm vào máy khác vẫn tiếp tục dùng với cùng model, cùng API key và cùng dữ liệu.

1. Cắm USB V-Claw
2. Chạy script khởi động phù hợp với hệ điều hành
3. Mở trang cấu hình nếu là lần dùng đầu
4. Mở bảng điều khiển và bắt đầu dùng

Bản cài qua mạng

Nếu bạn muốn cài trực tiếp vào máy cá nhân, đây là cách nhanh nhất.

macOS / Linux

curl -fsSL https://v-claw.org/install.sh | bash

Windows PowerShell

irm https://v-claw.org/install.ps1 | iex

Sau khi cài xong, bạn có thể chạy openclaw onboard để cấu hình lần đầu.

Ứng dụng cài sẵn

Bản này bao bọc OpenClaw bằng ứng dụng Electron. Nó phù hợp với người dùng muốn mở ứng dụng như bình thường, thay vì thao tác trực tiếp trong cửa sổ lệnh.

• Tải file cài đặt từ trang release.
• Mở ứng dụng và làm theo màn hình cấu hình đầu tiên.
• Sau khi chọn model và nhập API key, ứng dụng sẽ đưa bạn vào bảng điều khiển.

Bản cho nhà phát triển

Nếu bạn muốn chỉnh kho mã, dựng lại hoặc hiểu kiến trúc đóng gói, hãy làm việc trực tiếp trong mã nguồn.

cd portable && bash setup.sh
cd ../v-claw-app && bash setup.sh

Với hướng này, bạn nên đọc thêm hướng dẫn chi tiết để nắm rõ từng thành phần.

Trình cấu hình lần đầu

Trình cấu hình giúp bạn đi qua 3 quyết định quan trọng:

• Chọn model AI sẽ dùng mặc định
• Nhập API key
• Xác nhận các thông số gateway cơ bản

openclaw onboard

Chọn model AI

Nguyên tắc thực tế: chọn một model để đi vào hoạt động trước, không cần tối ưu hết ngay ở ngày đầu.

Bảng điều khiển

Bảng điều khiển là nơi bạn chat trực tiếp với AI, kiểm tra trạng thái kênh, cài kỹ năng và theo dõi log cơ bản.

openclaw gateway run --bind lan
openclaw dashboard

Nếu bảng điều khiển không mở được, hãy kiểm tra gateway trước bằng openclaw status.

Kỹ năng

Kỹ năng là phần mở rộng giúp V-Claw làm được việc cụ thể hơn, ví dụ: xử lý PDF, làm việc với GitHub, tự động hóa trình duyệt hoặc viết nội dung.

Mở trang skills.html để xem kho kỹ năng đã Việt hóa.

openclaw skill install <skill-name>

Kênh chat

OpenClaw có thể kết nối với nhiều kênh chat và quy trình khác nhau. Ở bản hướng dẫn này, hãy coi bảng điều khiển web là điểm bắt đầu đơn giản nhất. Sau khi hệ thống chạy ổn, bạn mới mở rộng sang bot hoặc nền tảng nhắn tin khác.

Hỗ trợ từ xa

Khi bạn cần người khác hỗ trợ xử lý lỗi, hãy dùng một trong hai cách sau:

• Chế độ hỗ trợ nhanh — phù hợp khi cần mở phiên hỗ trợ từ xa ngay.
• SSH — phù hợp khi bạn hoặc người hỗ trợ quen thao tác trong cửa sổ lệnh.

Lệnh cơ bản

openclaw onboard
openclaw status
openclaw gateway run --bind lan
openclaw dashboard
openclaw skill install <skill-name>

Câu hỏi thường gặp

Không biết chọn cách cài nào?

Nếu bạn là người mới, hãy đi từ bản cài qua mạng hoặc ứng dụng cài sẵn. Nếu cần mang theo dữ liệu, hãy dùng bản USB.

Bảng điều khiển không mở?

Kiểm tra gateway còn chạy không. Nếu chưa chạy, mở lại gateway trước rồi mới mở bảng điều khiển.

AI không trả lời?

Đầu tiên hãy kiểm tra API key, model name và trạng thái kết nối mạng. Sau đó xem log để biết lỗi cụ thể.

Bảo trì và gỡ cài đặt

Giữ lại cấu hình nếu bạn chỉ muốn cài lại phần mềm. Chỉ xóa dữ liệu khi bạn thực sự muốn reset toàn bộ hệ thống.