APIMaster.ai
Tài liệu APIMaster.ai
Quick startAPIMaster.aiMarketplace

OpenClaw với APIMaster.ai

Cài đặt OpenClaw trên Windows hoặc macOS, kết nối APIMaster qua Custom Provider của openclaw onboard, và trò chuyện trong web dashboard.

OpenClaw là một nền tảng tác tử AI cục bộ với giao diện trò chuyện web. Kết nối APIMaster.ai (tương thích OpenAI) thông qua openclaw onboard → Custom Provider.

Lấy API Key trước. Sử dụng placeholder your_apimaster_key bên dưới.

Điều kiện tiên quyết

  • Windows, macOS, hoặc Linux
  • Node.js 22.19+ (khuyến nghị Node 24; trình cài đặt sẽ nâng cấp nếu cần)
  • Đã có sẵn APIMaster API Key

Bước 1 — Cài đặt

Sau khi cài đặt, bạn thường thấy Starting setup… (onboard). Để chỉ cài đặt và cấu hình sau, xem Cài đặt không dùng onboard bên dưới.

Windows (PowerShell)

powershell -c "irm https://openclaw.ai/install.ps1 | iex"

Cài đặt thành công (ví dụ Windows)

macOS (Terminal)

  1. Mở Terminal.app (hoặc iTerm).
  2. Chạy trình cài đặt chính thức (tài liệu OpenClaw):
curl -fsSL https://openclaw.ai/install.sh | bash

Trên macOS, tập lệnh sẽ:

  • Phát hiện Apple Silicon vs Intel
  • Cài đặt Homebrew nếu chưa có (yêu cầu tài khoản Quản trị viên)
  • Cài đặt Node 24 (hoặc phiên bản khác ≥ 22.19) qua Homebrew nếu cần
  • Cài đặt CLI openclaw và thường khởi động onboard

Kiểm tra Node trước (tùy chọn):

node --version   # cần v22.19+, khuyến nghị v24.x

Cài đặt không dùng onboard:

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

Sau đó chạy openclaw onboard khi sẵn sàng.

Đường dẫn cấu hình macOS:

Mục Đường dẫn
Cấu hình ~/.openclaw/openclaw.json
Workspace ~/.openclaw/workspace
Phiên ~/.openclaw/agents/main/sessions

Ảnh chụp màn hình bên dưới là từ Windows, nhưng luồng onboard CLI trên macOS cũng tương tự (Custom Provider, Base URL, Bỏ qua kênh, v.v.).

Linux / WSL2

Tương tự macOS:

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

Gateway nền tùy chọn:

openclaw onboard --install-daemon

(macOS: LaunchAgent · Linux: systemd user service)

Bước 2 — openclaw onboard

Chạy bất kỳ lúc nào để (cấu hình lại):

openclaw onboard

Trên macOS, sử dụng cùng phiên Terminal. Để có Gateway liên tục:

openclaw onboard --install-daemon
  1. Thông báo bảo mật → Có
  2. Nhà cung cấp mô hình/xác thực → Custom Provider (điểm cuối tương thích OpenAI hoặc Anthropic)

Custom Provider (tương tự trên macOS)

  1. Điền thông tin:
Trường Giá trị
API Base URL https://apimaster.ai/v1
API key Dán APIMaster key
Khả năng tương thích điểm cuối Tương thích OpenAI
Model ID ví dụ: gpt-5.5

Cấu hình APIMaster

Model ID: bất kỳ id mô hình trò chuyện nào trên marketplace (gpt-5.4, claude-sonnet-4-6, …). Bỏ qua các mô hình hình ảnh như gpt-image-2.

  1. Các bước tùy chọn: Bỏ qua kênh, tìm kiếm web, kỹ năng, hooks.

Bỏ qua kênh

Bước 3 — Trò chuyện web

Nếu trình duyệt không tự động mở:

openclaw dashboard

Nếu trang không tải được, chạy lại openclaw dashboard hoặc chạy lại openclaw onboard.

Bước 4 — Kiểm tra

Chọn mô hình bên dưới ô nhập liệu (ví dụ: gpt-5.5 (Custom Provider)), gửi hello, xác nhận có phản hồi.

Trò chuyện web

Khắc phục sự cố

Vấn đề Hành động
Cấu hình sai openclaw onboard
Trang không mở được openclaw dashboard
Lỗi 401 / mô hình Kiểm tra URL, key, model id; kiểm tra kết nối

macOS

Vấn đề Hành động
openclaw: command not found Thêm vào ~/.zshrc: export PATH="$(npm prefix -g)/bin:$PATH", mở lại Terminal
Phiên bản Node vẫn sai với nvm nvm install 24 && nvm use 24 && nvm alias default 24, chạy lại trình cài đặt
Cài đặt Homebrew thất bại Sử dụng tài khoản Quản trị viên, hoặc cài đặt Homebrew trước
Gateway không chạy openclaw gateway status; thử openclaw onboard --install-daemon

Danh sách kiểm tra

  • Custom Provider + https://apimaster.ai/v1 + key
  • Chat model id (không phải hình ảnh)
  • openclaw dashboard hoạt động
  • Tin nhắn kiểm tra thành công

Xem thêm