Cấu hình
OpenClaw
qua CoreAPI
Sử dụng CoreAPI làm nhà cung cấp mô hình tùy chỉnh cho OpenClaw: một API, nhiều mô hình với giá niêm yết chính thức. Hướng dẫn này tuân theo quy trình triển khai OpenClaw hiện tại (2026.3.8+) và bao gồm cài đặt, cấu hình nhà cung cấp, xác minh và chuyển đổi mô hình.
# Chỉ là ví dụ—xác minh với phiên bản OpenClaw của bạn trước khi đưa vào production
{
"agents": {
"defaults": {
"model": {
"primary": "coreapi-claude/claude-sonnet-4-5-20250929"
}
}
},
"models": {
"mode": "merge",
"providers": {
"coreapi-openai": {
"baseUrl": "https://unixcore.io/v1",
"apiKey": "${COREAPI_KEY}",
"api": "openai-completions",
"models": [{ "id": "deepseek-flash", "name": "DeepSeek Flash" }]
},
"coreapi-claude": {
"baseUrl": "https://unixcore.io",
"apiKey": "${COREAPI_KEY}",
"api": "anthropic-messages",
"models": [{ "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5" }]
}
}
}
}Phạm vi hướng dẫn
và điều kiện tiên quyết
Cấu hình OpenClaw với CoreAPI
Sử dụng CoreAPI làm nhà cung cấp mô hình tùy chỉnh cho OpenClaw để truy cập nhiều mô hình trong một API với giá niêm yết chính thức. Trang này tuân theo quy trình giới thiệu OpenClaw hiện tại (2026.3.8+).
Điều kiện tiên quyết
Cần có Node.js >= 22 và API key CoreAPI. Với cài đặt daemon, lưu COREAPI_KEY vào ~/.openclaw/.env để openclaw.json có thể tham chiếu $COREAPI_KEY mà không cần hardcode secrets.
openclaw onboard --install-daemon openclaw gateway status openclaw dashboard printf 'COREAPI_KEY=%s\n' 'your_coreapi_key' >> ~/.openclaw/.env chmod 600 ~/.openclaw/.env
Sau khi thêm ~/.openclaw/.env hoặc chỉnh sửa cấu hình nhà cung cấp, khởi động lại một lần với openclaw gateway restart, sau đó chạy chẩn đoán. Sử dụng tham chiếu provider/model đầy đủ trong tất cả các lệnh và phiên. Khi có sự lệch phiên bản, kiểm tra lại Tài liệu cấu hình.
Tại sao cần hai nhà cung cấp
cho một API key CoreAPI
Cài đặt, onboard, cấu hình,
xác minh, chuyển đổi
OpenClaw sử dụng ~/.openclaw/openclaw.json là cấu hình nguồn bạn chỉnh sửa. Các nhà cung cấp tùy chỉnh được hiện thực hóa thành các tệp models.json theo từng agent dưới ~/.openclaw/agents/<agentId>/. Kiểm tra lại keys và hành vi sau khi nâng cấp bằng các hướng dẫn Tài liệu cấu hình và Biến môi trường . Coi URL cơ sở CoreAPI chỉ như được định nghĩa trong tài liệu trực tiếp.
{
"agents": {
"defaults": {
"model": {
"primary": "coreapi-claude/claude-sonnet-4-5-20250929"
}
}
},
"models": {
"mode": "merge",
"providers": {
"coreapi-openai": {
"baseUrl": "https://unixcore.io/v1",
"apiKey": "${COREAPI_KEY}",
"api": "openai-completions",
"models": [{ "id": "deepseek-flash", "name": "DeepSeek Flash" }]
},
"coreapi-claude": {
"baseUrl": "https://unixcore.io",
"apiKey": "${COREAPI_KEY}",
"api": "anthropic-messages",
"models": [{ "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5" }]
}
}
}
}Thiết lập cơ bản không yêu cầu tạo thủ công auth-profiles.json. Sử dụng ${COREAPI_KEY} trong nhà cung cấp và chèn biến qua ~/.openclaw/.env, shell hoặc trình quản lý dịch vụ.
Giá trực tiếp trên
trang CoreAPI
Bảng bên dưới sử dụng số lượng minh họa trên mỗi triệu mã thông báo. Danh mục mô hình, giá cả và SLA tuân theo các điều khoản CoreAPI hiện tại. Tài liệu và bảng điều khiển CoreAPI hiển thị ngay bây giờ.
Kiểm tra điều này
trước khi tích hợp
Tôi có cần auth-profiles.json cho thiết lập này không?
Không cho thiết lập cơ bản. OpenClaw có thể giải quyết apiKey nhà cung cấp từ models.providers.*.apiKey qua $COREAPI_KEY. Chỉ sử dụng auth-profiles.json cho secrets được lưu theo từng hồ sơ hoặc xoay vòng.
Tại sao có 2 mục nhà cung cấp cho một nhà cung cấp?
OpenClaw định tuyến theo tính tương thích định dạng API. Giữ các mục riêng biệt cho openai-completions và anthropic-messages.
Cấu hình thực sự được chỉnh sửa và hiện thực hóa ở đâu?
Chỉnh sửa ~/.openclaw/openclaw.json. Các nhà cung cấp tùy chỉnh được hiện thực hóa thành models.json theo từng agent dưới ~/.openclaw/agents/<agentId>/ sau khi đồng bộ/tải.
ID mô hình nào được sử dụng trong hướng dẫn này?
deepseek-flash, claude-sonnet-4-5-20250929. Bạn có thể thêm bất kỳ mô hình nào từ trang mô hình CoreAPI vào khối nhà cung cấp tương ứng.