OpenClaw

Cấu hình OpenClaw để sử dụng AISieure

Giới thiệu

Hướng dẫn này giúp bạn kết nối OpenClaw — framework AI agent mã nguồn mở — với AISieuRe để sử dụng các model AI hàng đầu như Claude Sonnet 4.6, GPT-4.1, Gemini 2.5 Pro với chi phí tối ưu. Bạn sẽ đi qua toàn bộ quy trình từ cài đặt OpenClaw, cấu hình provider AISieuRe, cho đến kiểm tra kết nối và xử lý sự cố.

OpenClaw hoạt động như một trợ lý cá nhân AI đa năng, cho phép bạn tương tác với các model AI thông qua nhiều giao diện khác nhau:

Terminal / CLI — dành cho developer thích làm việc trực tiếp từ dòng lệnh
Web Dashboard — giao diện trực quan để quản lý agent, cấu hình và theo dõi lịch sử
Chat apps — tích hợp với các ứng dụng nhắn tin quen thuộc

Nhờ tương thích giao thức OpenAI API, OpenClaw kết nối liền mạch với AISieuRe mà không cần plugin hay adapter bổ sung.

Yêu cầu hệ thống

Trước khi bắt đầu, hãy đảm bảo môi trường của bạn đáp ứng các yêu cầu sau:

Yêu cầu	Chi tiết
Node.js	Phiên bản 22 trở lên (`node --version` để kiểm tra)
Hệ điều hành	Linux, macOS, hoặc Windows (PowerShell 5.1+)
Tài khoản AISieuRe	Đăng ký miễn phí tại aisieure.com/register
API Key	Tạo tại Dashboard → API Keys

Note: Nếu chưa cài Node.js, bạn có thể sử dụng nvm (Linux/macOS) hoặc nvm-windows để cài đặt và quản lý nhiều phiên bản Node.js.

Cài đặt OpenClaw

Cách 1: Cài đặt qua npm (khuyên dùng)

npm install -g openclaw@latest

Cách 2: Script cài đặt nhanh

Linux / macOS:

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

Windows (PowerShell):

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

Xác nhận cài đặt

Sau khi cài đặt thành công, chạy hai lệnh sau để xác nhận:

# Kiểm tra phiên bản
openclaw --version

# Khởi tạo OpenClaw và cài đặt daemon chạy nền
openclaw onboard --install-daemon

Lệnh openclaw onboard --install-daemon sẽ tạo thư mục cấu hình tại ~/.openclaw/ và khởi động daemon để OpenClaw có thể xử lý request liên tục trong nền.

Cấu hình kết nối AISieuRe

OpenClaw cung cấp ba cách để cấu hình provider. Bạn chỉ cần chọn một trong ba — kết quả hoàn toàn tương đương.

Cách 1: Cấu hình qua file JSON

Mở file ~/.openclaw/openclaw.json bằng text editor bất kỳ và thêm nội dung sau:

{
  "models": {
    "mode": "merge",
    "providers": {
      "aisieure": {
        "baseUrl": "https://aisieure.com/v1",
        "apiKey": "key_your_api_key_here",
        "api": "openai-completions",
        "models": [
          {
            "id": "claude-sonnet-4.6",
            "name": "Claude Sonnet 4.6"
          },
          {
            "id": "claude-opus-4.6",
            "name": "Claude Opus 4.6"
          },
          {
            "id": "gpt-4.1",
            "name": "GPT-4.1"
          },
          {
            "id": "gpt-4o",
            "name": "GPT-4o"
          },
          {
            "id": "gemini-2.5-pro",
            "name": "Gemini 2.5 Pro"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "aisieure/claude-sonnet-4.6"
      }
    }
  }
}

Quan trọng: Thay key_your_api_key_here bằng API key thực tế từ Dashboard → API Keys. Giá trị baseUrl phải kết thúc bằng /v1 — thiếu hậu tố này sẽ gây lỗi kết nối.

Giải thích các trường quan trọng:

Trường	Giá trị	Mô tả
`mode`	`"merge"`	Giữ lại các provider mặc định, bổ sung AISieuRe bên cạnh
`baseUrl`	`https://aisieure.com/v1`	Endpoint API của AISieuRe (bắt buộc có `/v1`)
`apiKey`	`key_xxxx`	API key từ tài khoản AISieuRe của bạn
`api`	`"openai-completions"`	Giao thức API — AISieuRe tương thích OpenAI format
`model.primary`	`"aisieure/claude-sonnet-4.6"`	Model mặc định khi gửi request, định dạng `provider/model-id`

Cách 2: Cấu hình qua CLI

Nếu bạn muốn thao tác nhanh mà không cần mở file, hãy chạy các lệnh sau trong terminal:

# Thiết lập provider AISieuRe
openclaw config set -- models.providers.aisieure.baseUrl "https://aisieure.com/v1"
openclaw config set -- models.providers.aisieure.api "openai-completions"
openclaw config set -- models.providers.aisieure.apiKey "key_your_api_key_here"

# Đặt model mặc định
openclaw config set -- agents.defaults.model.primary "aisieure/claude-sonnet-4.6"

Mẹo: Phương pháp CLI đặc biệt hữu ích khi bạn cần thay đổi nhanh một giá trị — ví dụ đổi model mặc định sang aisieure/gpt-4.1 chỉ với một dòng lệnh, thay vì phải mở và chỉnh sửa file JSON.

Cách 3: Cấu hình qua Web Dashboard

OpenClaw cung cấp giao diện web trực quan để quản lý mọi cấu hình:

Khởi động dashboard:

openclaw dashboard
# hoặc
openclaw gateway start

Mở trình duyệt và truy cập URL gateway được hiển thị trong terminal (thường là http://localhost:xxxx)
Điều hướng tới Config → Authentication → Raw
Dán toàn bộ nội dung JSON cấu hình (giống phần Cách 1 ở trên)
Nhấn Save để lưu cấu hình

Model khuyên dùng cho OpenClaw

AISieuRe cung cấp hơn 30 model AI. Dưới đây là các model phù hợp nhất để sử dụng với OpenClaw, được chọn dựa trên hiệu suất, context window và chi phí:

Model ID	Tên hiển thị	Context	Tool Calls	Phù hợp cho
`claude-sonnet-4.6`	Claude Sonnet 4.6	200K	✓	Lựa chọn tốt nhất cho đa số tác vụ — cân bằng giữa chất lượng và chi phí
`claude-opus-4.6`	Claude Opus 4.6	200K	✓	Tác vụ phức tạp, phân tích chuyên sâu, suy luận nhiều bước
`gpt-4.1`	GPT-4.1	128K	✓	Coding, xử lý dữ liệu có cấu trúc, tool calling
`gpt-4o`	GPT-4o	128K	✓	Đa phương tiện, phản hồi nhanh
`gpt-4o-mini`	GPT-4o mini	128K	✓	Tác vụ đơn giản, tiết kiệm chi phí tối đa
`gemini-2.5-pro`	Gemini 2.5 Pro	128K	✓	Phân tích dài, tổng hợp tài liệu lớn

Note: Xem danh sách đầy đủ các model và bảng giá chi tiết tại trang Pricing. Bạn có thể thêm bất kỳ model nào vào mảng models trong cấu hình OpenClaw, miễn là id khớp chính xác với Model ID trên AISieuRe.

Kiểm tra kết nối

Sau khi hoàn tất cấu hình, hãy gửi một tin nhắn thử để xác nhận mọi thứ hoạt động:

# Gửi prompt thử qua CLI
openclaw chat "Xin chào! Bạn là model gì?"

Nếu kết nối thành công, bạn sẽ nhận được phản hồi từ model mặc định (Claude Sonnet 4.6 nếu bạn dùng cấu hình mẫu ở trên).

Để kiểm tra chi tiết hơn, chạy lệnh chẩn đoán tích hợp:

openclaw doctor

Lệnh này sẽ kiểm tra toàn bộ cấu hình, xác thực API key, và báo cáo trạng thái kết nối đến từng provider.

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

Nếu gặp lỗi khi kết nối OpenClaw với AISieuRe, hãy kiểm tra theo bảng dưới đây:

Lỗi thường gặp	Nguyên nhân	Cách khắc phục
`401 Unauthorized`	API key không hợp lệ hoặc đã bị thu hồi	Kiểm tra và tạo key mới tại Dashboard → API Keys
`404 Not Found`	Sai `baseUrl` — thiếu `/v1`	Đảm bảo URL là `https://aisieure.com/v1` (có `/v1` ở cuối)
`Model not found`	Model ID không khớp với danh sách AISieuRe	Kiểm tra chính xác Model ID tại trang Pricing
`Connection refused`	Daemon chưa chạy hoặc firewall chặn	Chạy `openclaw onboard --install-daemon` và kiểm tra firewall
`Insufficient credits`	Tài khoản hết credit	Nạp thêm credit tại trang Pricing

Checklist nhanh khi gặp bất kỳ lỗi nào:

Chạy openclaw doctor để xem báo cáo chẩn đoán tổng quan
Xác nhận baseUrl kết thúc bằng /v1
Xác nhận API key đang active — chưa bị thu hồi hoặc tạm ngưng
Xác nhận Model ID khớp chính xác (phân biệt hoa thường)
Kiểm tra kết nối mạng: curl https://aisieure.com/v1/models -H "Authorization: Bearer key_xxxx"

# Kiểm tra kết nối mạng trực tiếp đến API AISieuRe
curl -s https://aisieure.com/v1/models \
  -H "Authorization: Bearer key_your_api_key_here" | head -c 200

Nếu lệnh trên trả về danh sách model dạng JSON, kết nối mạng đến AISieuRe hoạt động bình thường — vấn đề nằm ở cấu hình OpenClaw.

Mẹo sử dụng nâng cao

Đổi model mặc định nhanh

Bạn có thể thay đổi model mặc định bất kỳ lúc nào mà không cần chỉnh sửa file:

# Chuyển sang GPT-4.1
openclaw config set -- agents.defaults.model.primary "aisieure/gpt-4.1"

# Chuyển sang Claude Opus 4.6 cho tác vụ nặng
openclaw config set -- agents.defaults.model.primary "aisieure/claude-opus-4.6"

# Chuyển sang GPT-4o mini để tiết kiệm credit
openclaw config set -- agents.defaults.model.primary "aisieure/gpt-4o-mini"

Sử dụng nhiều provider song song

Nhờ "mode": "merge", bạn có thể giữ provider mặc định của OpenClaw và thêm AISieuRe song song. Khi cần dùng model AISieuRe, chỉ cần thêm prefix aisieure/ trước model ID:

aisieure/claude-sonnet-4.6
aisieure/gpt-4.1
aisieure/gemini-2.5-pro

Tối ưu chi phí

Để tiết kiệm credit khi sử dụng OpenClaw hàng ngày:

Dùng GPT-4o mini (1 credit input / 3 credit output) cho các tác vụ đơn giản: trả lời câu hỏi, dịch thuật, tóm tắt ngắn
Dùng Claude Sonnet 4.6 (3 / 15 credits) cho coding, viết nội dung chất lượng cao
Chỉ dùng Claude Opus 4.6 (5 / 25 credits) khi thực sự cần suy luận phức tạp hoặc phân tích chuyên sâu

Bước tiếp theo

Bạn đã kết nối thành công OpenClaw với AISieuRe. Dưới đây là một số tài nguyên hữu ích để tiếp tục:

Tài liệu AISieuRe — Hướng dẫn tích hợp với các công cụ và framework khác
Bảng giá & Danh sách model — Xem đầy đủ các model có sẵn cùng chi phí
Quản lý API Keys — Tạo, thu hồi hoặc theo dõi usage của API key
Tài liệu OpenClaw — Tìm hiểu thêm về agent system, plugin và tính năng nâng cao