OpenClaw (Clawdbot) — Cấu hình & tích hợp API
OpenClaw là gì?
Một cổng (gateway) agent chạy trên các hệ điều hành phổ biến và có thể kết nối các kênh như WhatsApp, Telegram, Discord, iMessage và nhiều hơn nữa. Bạn gửi tin nhắn và nhận câu trả lời từ agent trên nhiều giao diện; có thể thêm kênh qua plugin.
Xem dự án chính thức để biết tính năng và tài liệu mới nhất: OpenClaw.
1. Cài OpenClaw
Chọn luồng phù hợp với hệ điều hành của bạn.
Cài bằng script (khuyến nghị)
macOS / Linux
- Cài
curl -fsSL https://openclaw.ai/install.sh | bash
- Kiểm tra
openclaw --version
Windows (PowerShell)
Lưu ý: Trình cài OpenClaw thường chạy trong WSL2. Trong PowerShell, hãy khởi động WSL và chạy lệnh cài đặt bên trong WSL.
iwr -useb https://openclaw.ai/install.ps1 | iex
Kiểm tra:
openclaw --version
2. Khởi tạo OpenClaw
Chạy trình hướng dẫn tương tác:
openclaw onboard
Luồng điển hình (cách diễn đạt có thể khác theo phiên bản):
- Chọn QuickStart
- Chọn Skip for now nơi bạn chưa cần khóa nhà cung cấp
- Chọn All providers (hoặc tương đương gói của bạn)
- Chọn Keep current khi chưa chắc
- Có thể Skip bước tùy chọn về công cụ chat hoặc skills rồi hoàn tất onboarding
- Bật các tùy chọn bảo mật / gateway được khuyến nghị nếu trình hướng dẫn đề xuất
Khi xong, OpenClaw có thể mở giao diện gateway trong trình duyệt.
Nếu gateway chưa chạy:
openclaw gateway
2. Kết nối OpenClaw với mixgateway.io
1. Lấy API key của gateway
- Mở mixgateway.io và đăng nhập.
- Trong [bảng điều khiển](/dashboard), mở API Keys (hoặc tương đương).
- Tạo key và sao chép — dùng làm
Authorization: Bearer …khi gọi gateway.
2. Sửa openclaw.json
Sau khi cài, OpenClaw lưu cấu hình trong thư mục cấu hình (thường là ~/.openclaw).
Mở thư mục
open ~/.openclaw
Trên Windows + WSL, từ thư mục đó mở Explorer bằng:
explorer.exe .
Chỉnh sửa openclaw.json. Gộp ý tưởng sau với file hiện có: đặt một provider trỏ tới URL nền tương thích OpenAI https://api.mixgateway.io/v1, và nối agents.defaults.model.primary với id model dùng provider đó.
Ví dụ (điều chỉnh tên cho khớp phiên bản OpenClaw — cấu trúc tham khảo hướng dẫn bên thứ ba như tài liệu ApiSet cho OpenClaw):
{
"agents": {
"defaults": {
"model": {
"primary": "mixgateway/deepseek:deepseek-chat"
},
"models": {
"mixgateway/deepseek:deepseek-chat": {}
}
}
},
"models": {
"mode": "merge",
"providers": {
"mixgateway": {
"baseUrl": "https://api.mixgateway.io/v1",
"apiKey": "PASTE_YOUR_GATEWAY_API_KEY_HERE",
"api": "openai-completions",
"models": [
{
"id": "deepseek:deepseek-chat",
"name": "deepseek-chat",
"reasoning": false,
"input": ["text"],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 128000,
"maxTokens": 8192
}
]
}
}
}
}
Ghi chú:
- Thay
PASTE_YOUR_GATEWAY_API_KEY_HEREbằng key thật từ bảng điều khiển. - Đổi
deepseek:deepseek-chatthành bất kỳ model nào gateway hỗ trợ (xem Model & định tuyến). mixgatewaychỉ là khóa provider trong ví dụ — bạn có thể đổi tên, nhưng giữ agents.defaults.model.primary đồng bộ (providerKey/modelId).
3. Khởi động lại gateway
openclaw gateway restart
Giao diện gateway sẽ phản ánh provider và model mới.
Xem thêm
- Tổng quan OpenClaw — Vì sao dùng OpenClaw cùng mixgateway.io.
- Bắt đầu nhanh — Gọi trực tiếp
https://api.mixgateway.io/v1/chat/completions.