Cài đặt OpenClaw
Tìm hiểu cách cấu hình OpenClaw để dùng API của Aiberm. Hướng dẫn này gồm cài đặt và cấu hình cho Windows, macOS và Linux.
OpenClaw là gì?
OpenClaw là nền tảng agent AI mã nguồn mở, mang trợ lý AI trực tiếp vào terminal và ứng dụng nhắn tin. Nó hỗ trợ nhiều nhà cung cấp LLM và có thể mở rộng bằng plugin.
Bằng cách cài plugin openclaw-aiberm, bạn có thể truy cập mọi mô hình có trên Aiberm (gồm GPT, Claude, Gemini, DeepSeek, Grok và hơn thế nữa) qua một giao diện thống nhất với một API key.
Điều kiện tiên quyết
Trước khi bắt đầu, hãy đảm bảo bạn có:
- Một tài khoản Aiberm (Đăng ký tại đây)
- Một API key Aiberm (Lấy khóa của bạn)
- Quyền truy cập Terminal/Command Prompt trên máy tính
- Đã cài Node.js 18+
Cài đặt
Bước 1: Cài OpenClaw
macOS & Linux:
curl -fsSL https://openclaw.ai/install.sh | bash
Hoặc dùng npm:
npm i -g openclaw
Windows:
npm i -g openclaw
Kiểm tra cài đặt:
openclaw --version
Bước 2: Cài plugin Aiberm
Cài plugin nhà cung cấp Aiberm:
openclaw plugins install openclaw-aiberm
Bật plugin:
openclaw plugins enable openclaw-aiberm
Quan trọng: Sau khi bật, hãy khởi động lại gateway để thay đổi có hiệu lực:
openclaw gateway restart
Xác thực
Sau khi cài và bật plugin, xác thực bằng API key Aiberm của bạn:
openclaw models auth login --provider aiberm --set-default
Bạn sẽ được nhắc nhập API key Aiberm. Lấy API key tại https://aiberm.com/console/token.
Nếu cần chuyển sang mô hình khác, bạn có thể chạy lại openclaw onboard, chọn Skip for now ở Model/auth provider, chọn aiberm ở Filter models by provider, rồi chọn mô hình muốn chuyển từ danh sách mô hình.

Nếu bạn đang ở trong container Docker nơi việc cài plugin bất tiện, bạn có thể tham chiếu trực tiếp tệp cấu hình này và lưu vào
~/.openclaw/openclaw.json.
Các mô hình có sẵn
Plugin tải mô hình động từ API Aiberm. Dưới đây là một số ví dụ:
OpenAI GPT
aiberm/openai/gpt-5.2-codexaiberm/openai/gpt-5.2aiberm/openai/gpt-4.1aiberm/openai/gpt-4oaiberm/openai/gpt-4o-mini
Anthropic Claude
aiberm/anthropic/claude-opus-4.5aiberm/anthropic/claude-sonnet-4.5aiberm/anthropic/claude-haiku-4.5aiberm/anthropic/claude-sonnet-4.5:thinking
Google Gemini
aiberm/google/gemini-3-proaiberm/google/gemini-3-flashaiberm/google/gemini-2.5-pro
DeepSeek
aiberm/deepseek/deepseek-r1aiberm/deepseek/deepseek-v3.2
X.AI Grok
aiberm/x-ai/grok-4.1-fastaiberm/x-ai/grok-code-fast-1
Truy cập Aiberm Pricing để xem danh sách đầy đủ và cập nhật nhất các mô hình có sẵn.
Sử dụng
Sau khi xác thực, bạn có thể bắt đầu dùng OpenClaw. Để biết cách dùng chi tiết, vui lòng tham khảo OpenClaw Documentation.
Liệt kê các mô hình đã cài:
openclaw models list | grep aiberm
Biến môi trường
Bạn cũng có thể đặt API key qua biến môi trường:
export AIBERM_API_KEY=sk-your-api-key
Tải mô hình động
Plugin openclaw-aiberm có tính năng tải mô hình động:
- Khi plugin tải, nó lấy danh sách mô hình mới nhất từ API Aiberm
- Nếu API không khả dụng, plugin sẽ fallback về danh sách mô hình tích hợp sẵn
- Trong quá trình xác thực, các mô hình mới nhất được lấy lại
Điều này có nghĩa:
- Mô hình mới có sẵn ngay mà không cần cập nhật plugin
- Mô hình đã ngừng hỗ trợ được gỡ tự động
- Khả năng của mô hình luôn được cập nhật
Xử lý sự cố
Lỗi “No provider plugins found”
Hãy đảm bảo bạn đã:
- Cài plugin:
openclaw plugins install openclaw-aiberm - Bật plugin:
openclaw plugins enable openclaw-aiberm - Khởi động lại gateway:
openclaw gateway restart
Lỗi 401/403
- Lỗi 401: API Key chưa đặt hoặc không hợp lệ
- Lỗi 403: Không đủ quyền hoặc khóa đã hết hạn
- Xác nhận API key tại Aiberm Console
Plugin không tải
Kiểm tra plugin đã được bật chưa:
openclaw plugins list
Nếu chưa bật, chạy:
openclaw plugins enable openclaw-aiberm
openclaw gateway restart