Hướng dẫn Thiết Lập Model AI cho OpenClaw (Chi tiết từ A-Z)

Ngày đăng: March 10, 2026

Sau khi cài đặt Openclaw thành công, việc cấu hình Model Provider là bước quan trọng nhất để "kích hoạt" bộ não AI cho OpenClaw. Bài viết này sẽ giúp bạn thiết lập kết nối API một cách chuẩn xác và an toàn.

1. Mục tiêu của việc cấu hình API

Việc kết nối API (OpenAI, Anthropic, OpenRouter...) cho phép OpenClaw thực hiện các tác vụ:

Xử lý ngôn ngữ: Gọi các model LLM mạnh mẽ (GPT-4, Claude 3, Llama 3).
Vận hành Agent: Chạy các tác vụ tự động hóa thông minh.
Kết nối và phản hồi tin nhắn

2. Kiểm tra trạng thái OpenClaw

Trước khi bắt đầu, hãy đảm bảo dịch vụ OpenClaw đang sẵn sàng.

Lệnh kiểm tra:

openclaw status

Nếu cài đặt đúng, màn hình sẽ hiển thị thông số Onboarding Setup cơ bản:

Gateway Port: 18789
Gateway Bind: 127.0.0.1 (Localhost)
Auth Mode: Token

3. Quy trình cấu hình Onboarding (Wizard)

Nếu bạn lần đầu thiết lập hoặc muốn thay đổi cấu hình cũ, hãy chạy lệnh:

openclaw onboard

Chọn yes > QuickStart để tiếp tục cài đặt.

Bước A: Thiết lập Gateway (Cổng kết nối)

Đây là "trạm trung chuyển" dữ liệu giữa OpenClaw và các ứng dụng khác.

Thông số	Giá trị khuyến nghị	Ý nghĩa
Gateway Port	18789	Cổng mặc định để truy cập API.
Gateway Bind	127.0.0.1	Chỉ cho phép máy hiện tại truy cập (An toàn nhất).
Gateway Auth	Token	Bắt buộc có mã bảo vệ khi gọi API.
Tailscale	Off	Tắt nếu bạn không dùng mạng nội bộ ảo Tailscale.

Tiếp theo đến bước chọn cách xử lý file cấu hình (config) của OpenClaw trong quá trình onboarding

Chon Update Values để cho phép chỉnh sửa lại từng phần.

Bước B: Chọn Model Provider

OpenClaw hỗ trợ rất nhiều "nhà cung cấp não bộ". Trong hướng dẫn này, chúng ta ưu tiên chọn:

OpenAI (Codex OAuth + API key)

(Bạn cũng có thể chọn Anthropic, Google Gemini hoặc OpenRouter tùy nhu cầu).

4. Quản lý API Key

Để OpenClaw hoạt động, bạn cần có "chìa khóa" từ nhà cung cấp.

4.1. Truy cập: OpenAI API Keys.

4.2. Nhấn Create new secret key.

Lưu ý: Sao chép và cất giữ kỹ, bạn sẽ không thể xem lại mã này lần thứ hai.

5. Hai cách nhập API Key vào OpenClaw

Cách 1: Nhập trực tiếp (Dành cho người mới)

Trong giao diện openclaw onboard, khi trình điều hướng hỏi:

Enter your OpenAI API key: -> Bạn chỉ cần dán mã sk-xxxx... và nhấn Enter.

Tiếp theo đến bước chọn cách cung cấp API key cho OpenClaw trong quá trình cấu hình model.

Tiếp theo đến bước nhập API KEY. Bạn sẽ dán trực tiếp API key vào wizard. Ví dụ: export OPENAI_API_KEY="sk-xxxxxxxx"

Tiếp theo đây là bước chọn Model AI mặc định (Default model) cho OpenClaw trong quá trình onboarding.
Bước tiếp theo Nếu bạn chỉ muốn test OpenClaw trước: chọn Skip for now > enter
Bước tiếp theo Agent AI sẽ hỏi dùng dịch vụ tìm kiếm nào để tra cứu thông tin trên Internet.
Nếu bạn chỉ test OpenClaw: chọn Skip for now

Đến bước cuối cùng Đây là bước cấu hình khả năng mở rộng cho OpenClaw trong quá trình onboarding, bạn có thể chọn yes Openclaw sẽ quét các skill có sẵ, kích hoạt skill mặc định, chuẩn bị môi trường cho agent
Tiếp theo Bỏ qua bước cài thêm, tiếp tục onboarding.
Các bước tiếp theo có thể cấu hình sau nên bạn chỉ cần chọn no để bỏ qua.
Đến đây chúng ta chọn restart khởi động lại gateway service.

Cách 2: Sử dụng Biến môi trường (Chuyên nghiệp & Bảo mật)

Cách này giúp bạn quản lý Key hệ thống tốt hơn mà không cần nhập lại nhiều lần.

Linux/macOS: export OPENAI_API_KEY="sk-xxxxxxxxxxxxxxxx"
Windows (PowerShell): $env:OPENAI_API_KEY="sk-xxxxxxxxxxxxxxxx"

6. Kiểm tra và Vận hành

Sau khi cấu hình xong, hãy thử gửi một câu chào để kiểm tra "sức khỏe" hệ thống.

test trực tiếp agent (đơn giản nhất)

Dùng lệnh sau để test API Gateway có hoạt động đúng chuẩn OpenAI-compatible không:

openclaw agent --agent main --message "Hello OpenClaw"

Hiển thị như trên tức là OpenClaw đã kết nối thành công tới OpenAI.

7. Kết luận

Việc hoàn tất cấu hình API là bước ngoặt giúp OpenClaw từ một công cụ tĩnh trở thành một trợ lý AI mạnh mẽ. Bằng cách tuân thủ các bước thiết lập Gateway và quản lý Key an toàn, bạn đã sẵn sàng để tích hợp OpenClaw vào quy trình làm việc hằng ngày cũng như các nền tảng chat phổ biến. Hãy luôn chú ý đến vấn đề bảo mật API để bảo vệ tài nguyên của mình.

CloudFly - Đối tác Hạ tầng Đám mây Tin cậy

Để vận hành OpenClaw một cách ổn định nhất, một hạ tầng Cloud mạnh mẽ là điều không thể thiếu.

CLOUDFLY tự hào là đơn vị tiên phong tại Việt Nam cung cấp dịch vụ Cloud Server, Cloud Hosting tùy chỉnh cấu hình. Chúng tôi nhận được sự tin tưởng và hợp tác với hơn 15.000 khách hàng trong và ngoài nước, sẵn sàng đồng hành và đem lại những giải pháp tối ưu nhất cho bạn.

Nếu quý khách hàng gặp khó khăn hay có bất kì thắc mắc nào, hãy liên hệ ngay với chúng tôi:

CloudFly - Đơn giản hóa ứng dụng trên đám mây