Hướng dẫn nền tảng

V-Claw là gì?

V-Claw là lớp đóng gói và bản địa hóa dựa trên OpenClaw để người dùng Việt Nam có thể cài, cấu hình và vận hành trợ lý AI dễ hơn.

Thay vì bắt đầu từ nhiều tài liệu rời rạc, bạn có một luồng tương đối rõ:

Chọn cách cài → cấu hình model → mở bảng điều khiển → cài kỹ năng → vận hành / hỗ trợ từ xa

Bản USB

Mang theo toàn bộ cấu hình và dữ liệu sang máy khác.

Ứng dụng cài sẵn

Trải nghiệm gần giống một ứng dụng cài sẵn thông thường.

Bản cài qua mạng

Cài nhanh bằng lệnh shell hoặc PowerShell.

Chọn cách cài đặt trước khi làm gì khác

Nếu chưa biết nên đi đường nào, hãy quyết định dựa trên nhu cầu thật của bạn, không phải theo cảm giác “cài cho đủ”.

Khi nào nên dùng bản USB?

  • Bạn thường xuyên đổi máy làm việc.
  • Bạn muốn dữ liệu và cấu hình nằm trên USB.
  • Bạn không muốn thay đổi nhiều trên máy đang dùng.

Khi nào nên dùng bản cài qua mạng hoặc ứng dụng cài sẵn?

  • Bạn dùng cố định một máy cá nhân.
  • Bạn muốn mở ứng dụng hoặc cửa sổ lệnh và chạy ngay.
  • Bạn không có nhu cầu mang cả môi trường đi nơi khác.

Cài bằng script: cách nhanh nhất để bắt đầu

Đây là lựa chọn thực dụng cho đa số người dùng mới.

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, hãy chạy openclaw onboard. Đừng vội cài thêm plugin hay chỉnh sâu nếu hệ thống chưa lên bảng điều khiển ổn định.

Cài thủ công: dành cho người muốn hiểu rõ từng lớp

Bạn chỉ nên đi hướng này khi thật sự cần kiểm soát chi tiết hoặc đang làm việc như người phát triển.

Bước 1: cài Node.js 22+

OpenClaw yêu cầu Node.js đủ mới. Kiểm tra trước:

node -v

Bước 2: cài OpenClaw

npm install -g openclaw@latest

Bước 3: chạy trình cấu hình

openclaw onboard
Nếu bạn đang cài thủ công chỉ để “cho chắc”, hãy cân nhắc quay lại bản script. Càng nhiều bước tay, xác suất sai càng tăng.

Chọn model: đừng cố tối ưu hết ngay ở ngày đầu

Mục tiêu ban đầu là hệ thống hoạt động được, không phải chọn model “hoàn hảo” trong lần đầu.

DeepSeek

Phù hợp để bắt đầu vì dễ dùng, chi phí dễ chịu và đủ tốt cho nhiều nhu cầu phổ thông.

Kimi

Phù hợp hơn nếu bạn hay đọc tài liệu dài hoặc cần ngữ cảnh lớn.

Model khác

Chỉ nên thử sau khi bạn đã có một cấu hình chạy ổn và hiểu nhu cầu thực tế của mình. 

openclaw onboard

Mở bảng điều khiển và bắt đầu dùng

Bảng điều khiển là điểm vào đơn giản nhất trước khi bạn nghĩ đến bot, plugin hay quy trình nâng cao. 

openclaw gateway run --bind lan
openclaw dashboard

Nếu bảng điều khiển không mở

  1. Kiểm tra gateway đã chạy chưa bằng openclaw status.
  2. Xem có cổng nào đang bị chiếm hay không.
  3. Xem log nếu trình duyệt mở nhưng trang không phản hồi.

Kỹ năng: chỉ cài những gì bạn thật sự cần

Kỹ năng giúp trợ lý AI làm việc cụ thể hơn, nhưng không nên cài tràn lan ngay từ đầu.

  • Nếu bạn làm việc nội dung: bắt đầu với kỹ năng viết, tóm tắt và tự động hóa đăng bài.
  • Nếu bạn làm việc kỹ thuật: bắt đầu với GitHub, code assistant và công cụ xử lý tài liệu.
  • Nếu bạn cần thao tác trình duyệt: cân nhắc kỹ năng tự động hóa trình duyệt.
openclaw skill install <skill-name>

Danh mục kỹ năng đã Việt hóa nằm ở trang chợ kỹ năng.

Xử lý sự cố thường gặp

Lỗi không tìm thấy lệnh openclaw

Thường là do PATH hoặc quá trình cài chưa hoàn tất. Hãy kiểm tra lại cách cài bạn đã dùng và mở cửa sổ lệnh mới.

AI không phản hồi

  • Kiểm tra API key.
  • Kiểm tra model name.
  • Kiểm tra gateway đang chạy hay không.
  • Xem log lỗi thay vì đoán.

Cần người khác hỗ trợ?

Dùng chế độ hỗ trợ nhanh khi cần xử lý gấp, hoặc SSH khi bạn muốn người hỗ trợ vào máy theo cách quen thuộc hơn.

Sau khi hệ thống chạy ổn, nên làm gì tiếp?

  1. Chốt một model mặc định cho công việc hằng ngày.
  2. Cài 2–3 kỹ năng thật sự cần dùng thay vì cài mọi thứ.
  3. Lưu lại quy trình mở gateway và bảng điều khiển cho riêng bạn.
  4. Nếu cần dùng nhiều máy, cân nhắc chuyển sang bản USB.
Tư duy đúng ở giai đoạn đầu: chạy ổn trước, tối ưu sau.