OpenClaw

OpenClaw là công cụ dòng lệnh trợ lý lập trình AI, hỗ trợ kết nối đến các dịch vụ API tương thích OpenAI qua Provider tùy chỉnh. Trang chính thức khuyến nghị dùng trình hướng dẫn openclaw onboard để hoàn tất cấu hình, cũng có thể tự viết file cấu hình thủ công.

Chuẩn bịSao chép liên kết neo

Đảm bảo hệ thống đáp ứng các yêu cầu sau:

• Node.js phiên bản 22+
• Hệ điều hành macOS / Linux / Windows
• Nếu build từ mã nguồn, cần cài thêm pnpm

Cài Node.jsSao chép liên kết neo

macOS (dùng Homebrew):

brew install node

Hệ điều hành khác:

Truy cập trang chủ Node.js để tải bản LTS: https://nodejs.org/en/download

Kiểm tra cài đặtSao chép liên kết neo

node -v
npm -v

Lưu ý: Người dùng Windows nên chạy OpenClaw trong môi trường WSL2.

Cài đặt OpenClawSao chép liên kết neo

Dùng script cài đặt chính thức (khuyến nghị):

macOS / LinuxSao chép liên kết neo

curl -fsSL https://openclaw.ai/install.sh | bash

Windows PowerShellSao chép liên kết neo

iwr -useb https://openclaw.ai/install.ps1 | iex

Script cài đặt sẽ tự động phát hiện và cài bổ sung các phụ thuộc còn thiếu. Nếu bạn đã tự quản lý môi trường Node, cũng có thể cài bằng npm hoặc pnpm (xem tài liệu chính thức).

Chạy trình hướng dẫn cấu hìnhSao chép liên kết neo

Chạy lệnh hướng dẫn:

openclaw onboard

Trong trình hướng dẫn, lần lượt điền các thông tin sau:

• Loại Provider: chọn Custom Provider
• Compatibility: chọn OpenAI-compatible
• Base URL: https://aicentos.com/v1
• API Key: điền API Key của bạn
• Model ID: tham khảo tên mô hình trong "Model Square" của Console
• Endpoint ID: khuyến nghị điền aicentos

Lưu ý: API Key điền trực tiếp dạng văn bản thuần là được, không cần đổi thêm sang biến môi trường OPENAI_API_KEY.

Đặt mô hình mặc địnhSao chép liên kết neo

Sau khi hoàn tất trình hướng dẫn, đặt mô hình mặc định thành:

aicentos/gpt-4o

Như vậy khi dùng về sau sẽ tự động dùng mô hình đã cấu hình.

Cấu hình thủ công (tùy chọn)Sao chép liên kết neo

Nếu không dùng trình hướng dẫn, có thể trực tiếp viết file cấu hình provider của OpenClaw:

{
  "models": {
    "providers": {
      "aicentos": {
        "baseUrl": "https://aicentos.com/v1",
        "apiKey": "your_api_key_here",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-4o", "name": "gpt-4o" }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "aicentos/gpt-4o" }
    }
  }
}

Trong cấu hình có thể ghi trực tiếp API Key dạng văn bản thuần, hoặc dùng tham chiếu biến môi trường (nếu bạn thích cách SecretRef hơn).

Kiểm tra cấu hìnhSao chép liên kết neo

Kiểm tra trạng thái mô hình để xác nhận kết nối thành công:

openclaw models list
openclaw models status

Nếu thấy aicentos/gpt-4o và trạng thái hiển thị bình thường, nghĩa là cấu hình kết nối thành công.

Lưu ýSao chép liên kết neo

• OpenClaw chính thức hỗ trợ tính năng Provider tùy chỉnh, có thể chọn chế độ OpenAI-compatible hoặc Anthropic-compatible
• Với dịch vụ hiện tại, khuyến nghị ưu tiên dùng chế độ OpenAI-compatible
• Điền trực tiếp API Key là cách làm mặc định; tham chiếu biến môi trường chỉ là phương án tùy chọn
• Nếu muốn dùng công cụ tự ghi cấu hình, có thể cân nhắc công cụ cc-switch
• Tài liệu chính thức còn cung cấp các cách cài đặt và cấu hình khác, có thể chọn theo nhu cầu thực tế

Liên kết liên quanSao chép liên kết neo

• Tài liệu chính thức: https://docs.openclaw.ai/install/index