Konfigurasi
OpenClaw
via CoreAPI
Gunakan CoreAPI sebagai penyedia model khusus untuk OpenClaw: satu API, model dengan harga resmi. Panduan ini mengikuti alur orientasi OpenClaw saat ini (2026.3.8+) dan mencakup penginstalan, konfigurasi penyedia, verifikasi, dan peralihan model.
# Hanya contoh—verifikasi dengan versi OpenClaw Anda sebelum produksi
{
"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" }]
}
}
}
}Cakupan panduan
dan prasyarat
Konfigurasi OpenClaw dengan CoreAPI
Gunakan CoreAPI sebagai penyedia model khusus untuk OpenClaw untuk mengakses model dalam satu API dengan harga resmi. Halaman ini mengikuti alur orientasi OpenClaw saat ini (2026.3.8+).
Prasyarat
Node.js >= 22 dan API key CoreAPI diperlukan. Untuk instalasi daemon, simpan COREAPI_KEY di ~/.openclaw/.env agar openclaw.json dapat mereferensikan $COREAPI_KEY tanpa mengkodekan rahasia secara langsung.
openclaw onboard --install-daemon openclaw gateway status openclaw dashboard printf 'COREAPI_KEY=%s\n' 'your_coreapi_key' >> ~/.openclaw/.env chmod 600 ~/.openclaw/.env
Setelah menambahkan ~/.openclaw/.env atau mengedit konfigurasi penyedia, mulai ulang sekali dengan openclaw gateway restart, lalu jalankan diagnostik. Gunakan referensi provider/model lengkap di semua perintah dan sesi. Untuk penyimpangan versi, periksa kembali Referensi konfigurasi.
Mengapa dua penyedia
untuk satu API key CoreAPI
Instal, onboard, konfigurasi,
verifikasi, ganti
OpenClaw menggunakan ~/.openclaw/openclaw.json sebagai konfigurasi sumber yang Anda edit. Penyedia kustom dimaterialisasikan ke dalam file models.json per-agen di bawah ~/.openclaw/agents/<agentId>/. Periksa kembali kunci dan perilaku setelah upgrade menggunakan panduan Referensi konfigurasi dan Variabel lingkungan . Perlakukan URL dasar CoreAPI hanya seperti yang didefinisikan dalam dokumentasi langsung.
{
"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" }]
}
}
}
}Pengaturan dasar tidak memerlukan pembuatan manual auth-profiles.json. Gunakan ${COREAPI_KEY} di penyedia dan injeksikan variabel melalui ~/.openclaw/.env, shell, atau manajer layanan.
Tarif langsung di
situs CoreAPI
Tabel di bawah ini menggunakan ilustrasi angka per juta token. Katalog model, harga, dan SLA mengikuti persyaratan CoreAPI saat ini. Dokumentasi dan konsol CoreAPI tampilkan saat ini.
Periksa ini
sebelum mengintegrasikan
Apakah saya memerlukan auth-profiles.json untuk pengaturan ini?
Tidak untuk pengaturan dasar. OpenClaw dapat menyelesaikan apiKey penyedia dari models.providers.*.apiKey via $COREAPI_KEY. Gunakan auth-profiles.json hanya untuk rahasia tersimpan per profil atau rotasi.
Mengapa ada 2 entri penyedia untuk satu vendor?
OpenClaw merutekan berdasarkan kompatibilitas format API. Pertahankan entri terpisah untuk openai-completions dan anthropic-messages.
Di mana konfigurasi sebenarnya diedit dan dimaterialisasikan?
Edit ~/.openclaw/openclaw.json. Penyedia kustom dimaterialisasikan ke models.json per-agen di bawah ~/.openclaw/agents/<agentId>/ setelah sync/load.
ID model apa yang digunakan dalam panduan ini?
deepseek-flash, claude-sonnet-4-5-20250929. Anda dapat menambahkan model apa pun dari halaman model CoreAPI ke blok penyedia yang sesuai.