Hướng Dẫn Chi Tiết Cài Đặt và Cấu Hình OpenClaw (Long Xa) để Chuyển Đổi Mô Hình AI

1 views

OpenClaw (hay còn gọi là Long Xa) là một công cụ mạnh mẽ giúp bạn dễ dàng cài đặt và chuyển đổi giữa các mô hình ngôn ngữ lớn (LLM) khác nhau như GPT hay Claude. Việc này cho phép bạn tối ưu hóa việc sử dụng AI cho từng loại tác vụ (ví dụ: lập trình, công việc hàng ngày) và quản lý chi phí hiệu quả. Bài viết này sẽ hướng dẫn bạn từng bước cài đặt OpenClaw và cấu hình API để sử dụng linh hoạt các mô hình AI.

1. Chuẩn Bị Công Cụ Hỗ Trợ

Trước khi cài đặt OpenClaw, bạn cần tải và cài đặt hai công cụ hỗ trợ sau:

1.1. Cài Đặt Terminal Của Microsoft

Đây là công cụ dòng lệnh chính thức từ Microsoft, rất tiện lợi cho việc quản lý hệ thống.

  • Bước 1: Truy cập [dự án mã nguồn mở của Microsoft Terminal](https://github.com/microsoft/terminal).
  • Bước 2: Tìm mục “Release” (phiên bản phát hành), chọn và tải xuống file cài đặt phù hợp với kiến trúc chip của máy tính bạn (thường là X64.msi cho Intel/AMD hoặc ARM.msi cho chip ARM).
  • Bước 3: Giải nén (nếu cần) và chạy file WindowsTerminal.exe để mở.
  • Bước 4: Lần đầu sử dụng, bạn có thể cần thiết lập Windows PowerShell làm terminal mặc định.

1.2. Tải và Cấu Hình CC Switch

CC Switch là công cụ giúp bạn quản lý và cấu hình các API của mô hình AI.

  • Bước 1: Truy cập trang tải xuống [CC Switch](https://github.com/ccloli/cc-switch).
  • Bước 2: Tìm mục “Preview Version” (phiên bản xem trước) và tải xuống file .MSI (được khuyến nghị để cài đặt dễ dàng).
  • Bước 3: Cài đặt và mở ứng dụng. Giao diện chính sẽ hiển thị các tùy chọn cấu hình API cho Claude, Codex, v.v.

2. Cài Đặt OpenClaw (Long Xa)

Sau khi có các công cụ hỗ trợ, bạn tiến hành cài đặt OpenClaw.

  • Bước 1: Mở Microsoft Terminal (đảm bảo là Windows PowerShell).
  • Bước 2: Truy cập trang web chính thức của OpenClaw: [openclaw.AI](https://openclaw.ai/).
  • Bước 3: Sao chép lệnh cài đặt một click từ trang web.
  • Bước 4: Dán lệnh vào Terminal và nhấn Enter.
  • Quan trọng: Bật chế độ VPN toàn cầu (Global VPN) trong suốt quá trình cài đặt vì OpenClaw cần tải xuống các tài nguyên từ bên ngoài. Quá trình này có thể mất khoảng 30 phút tùy thuộc vào tốc độ mạng và cấu hình máy tính của bạn.
  • Lưu ý: Nếu gặp vấn đề trong quá trình cài đặt, bạn có thể chạy lệnh openclaw doctor để sửa chữa.

3. Cấu Hình API với CC Switch và Nền Tảng Trung Gian

Hướng dẫn này sử dụng ví dụ về nền tảng trung gian “Xin Yuan API” để cấu hình, nhưng bạn có thể áp dụng tương tự cho các nền tảng khác.

3.1. Tạo API Token trên Nền Tảng Trung Gian

  • Bước 1: Đăng nhập vào nền tảng trung gian (ví dụ: Xin Yuan API) bằng tài khoản GitHub, Google hoặc Email.
  • Bước 2: Truy cập “Model Square” (Kho Mô Hình) để xem các mô hình có sẵn, thông tin về nhóm và điểm cuối API (API Endpoint).
  • Bước 3: Vào “Control Panel” (Bảng Điều Khiển) -> “API Token” (Mã API). Bạn có thể điểm danh hàng ngày để nhận miễn phí hạn mức sử dụng API.
  • Bước 4: Nhấn “Add Token” (Thêm Mã).
  • Bước 5: Chọn mô hình bạn muốn (ví dụ: GPT 5.4 mini).
  • Bước 6: Thiết lập “Group Priority” (Ưu tiên Nhóm) bằng cách thêm nhiều nhóm dự phòng (ví dụ: Codex Exclusive, Default, AZ, Reverse) để đảm bảo tính ổn định và khả dụng khi một nhóm gặp sự cố.
  • Bước 7: Nhấn “Submit” (Gửi) để tạo token. Sao chép mã API này.

3.2. Cấu Hình Mô Hình GPT-5.4 Mini trong CC Switch

GPT-5.4 Mini là lựa chọn tốt cho các tác vụ hàng ngày với chi phí hiệu quả.

  • Bước 1: Mở CC Switch, nhấn biểu tượng dấu cộng (+) để “Add Provider” (Thêm nhà cung cấp).
  • Bước 2: Chọn “Custom Config” (Cấu hình tùy chỉnh).
  • Bước 3: Điền thông tin:
  • Provider ID (Mã nhà cung cấp): Nhập tên dễ nhớ (ví dụ: XinYuanAPI).
  • API Protocol (Giao thức API): Chọn “Inference” (Suy luận).
  • Endpoint (Điểm cuối): Sao chép địa chỉ từ nền tảng trung gian và thêm /v1 vào cuối (ví dụ: your-api-domain.com/v1).
  • API Key: Dán mã API bạn đã sao chép từ nền tảng trung gian.
  • Bước 4: Nhấn “Add Model” (Thêm mô hình).
  • Model ID: Sao chép ID mô hình từ “Model Square” trên nền tảng trung gian.
  • Display Name (Tên hiển thị): GPT 5.4 mini.
  • Trong “Advanced Options” (Tùy chọn nâng cao), bật “Inference Mode” và “Image Recognition” (nếu mô hình hỗ trợ khả năng nhìn hình ảnh).
  • Bước 5: Nhấn “Add” và sau đó “Set as Default” (Đặt làm mặc định) cho mô hình này.

3.3. Cấu Hình Mô Hình Claude Opus 4.6 trong CC Switch

Claude Opus 4.6 là một trong những mô hình mạnh mẽ nhất hiện nay, phù hợp cho các tác vụ lập trình hoặc yêu cầu khả năng suy luận cao.

  • Lưu ý quan trọng: Đối với Claude, bạn phải sử dụng nhóm “Claude Code Exclusive Group” trên nền tảng trung gian vì các nhóm mặc định hoặc nhóm đảo ngược có thể không hỗ trợ gọi công cụ.
  • Bước 1: Trong CC Switch, nhấn dấu cộng (+) để “Add Provider” (Thêm nhà cung cấp).
  • Bước 2: Chọn “Custom Config” (Cấu hình tùy chỉnh).
  • Bước 3: Điền thông tin:
  • Provider ID: Nhập tên duy nhất (ví dụ: XinYuanClaude).
  • API Protocol: Chọn “Claude”.
  • Endpoint: Sao chép địa chỉ từ nền tảng trung gian (KHÔNG thêm /v1).
  • Bước 4: Tạo API Token mới trên nền tảng trung gian cho Claude. Chọn “Claude Exclusive Group” làm nhóm ưu tiên và thêm các nhóm dự phòng khác (ví dụ: Official Claude 1, Official Claude 2) nếu có.
  • Bước 5: API Key: Dán mã API Claude vừa tạo.
  • Bước 6: Nhấn “Add Model” (Thêm mô hình).
  • Model ID: Sao chép ID mô hình Claude Opus 4.6 từ “Model Square”.
  • Display Name: Claude Opus 4.6.
  • Trong “Advanced Options”, bật các tùy chọn phù hợp (ví dụ: Inference Mode).
  • Bước 7: Nhấn “Add”, nhưng KHÔNG đặt làm mặc định (trừ khi bạn muốn Claude là mô hình chính).

4. Khởi Chạy và Sử Dụng OpenClaw

Sau khi cấu hình các mô hình, bạn có thể khởi động OpenClaw.

4.1. Khởi Tạo Cài Đặt Ban Đầu

  • Bước 1: Mở Microsoft Terminal.
  • Bước 2: Chạy lệnh openclaw init để khởi tạo OpenClaw.
  • Bước 3: Làm theo hướng dẫn trên màn hình:
  • Chọn “yes” cho câu hỏi đầu tiên.
  • Chọn “tùy chọn đầu tiên” cho câu hỏi thứ hai và thứ ba (cài đặt nhanh).
  • Quan trọng: Chọn “Skip All” (Bỏ qua tất cả) khi được hỏi về tài khoản (vì bạn đang sử dụng API bên thứ ba).
  • Chọn mô hình mặc định: Chọn XinYuanAPI (hoặc tên bạn đã đặt cho GPT-5.4 mini). Không chọn “All” để tránh hiển thị quá nhiều mô hình không cần thiết.
  • Bỏ qua các bước cài đặt tích hợp bot, công cụ tìm kiếm, Skills và Hooks (thường nhấn phím cách để bỏ qua).
  • Bước 4: Chờ OpenClaw khởi động gateway. Sau khi hoàn tất, một liên kết sẽ hiển thị trong Terminal.
  • Bước 5: Sao chép liên kết và mở trong trình duyệt để truy cập giao diện web của OpenClaw.

4.2. Khắc Phục Lỗi và Khởi Động Lại

  • Nếu giao diện web không mở được hoặc gặp lỗi (ví dụ: lỗi gateway), hãy chạy lệnh openclaw doctor trong Terminal để sửa chữa.
  • Sau khi sửa chữa, chạy lệnh openclaw restart để khởi động lại gateway.
  • Nếu vẫn gặp lỗi liên quan đến gateway (ví dụ: gateway bị mất hoặc không cài đặt được), bạn có thể cần chạy Microsoft Terminal với quyền quản trị viên (Run as administrator) để cài đặt lại gateway.

Lời Kết

Giờ đây bạn đã có thể sử dụng OpenClaw để tương tác với các mô hình AI đã cấu hình. Trên giao diện web của OpenClaw, bạn có thể dễ dàng chuyển đổi giữa các mô hình (ví dụ: GPT-5.4 mini cho công việc chung, Claude Opus 4.6 cho lập trình) để tối ưu hóa hiệu suất và chi phí. Chúc bạn có trải nghiệm tuyệt vời với công cụ Long Xa!

Có thể bạn sẽ thích

Đánh giá ngay!
(0 lượt đánh giá - 0/5)
Cao Thiên
Là một người đam mê công nghệ AI, tôi sáng lập Tips AI Tech để chia sẻ kiến thức và xu hướng mới nhất, giúp mọi người dễ dàng tiếp cận và ứng dụng AI vào cuộc sống.