Pengaturan API Key OpenClaw - Konfigurasi Provider Kustom
Cara install OpenClaw & konfigurasi APIMaster.ai provider kustom kompatibel OpenAI di Windows & macOS. Atur API key & base URL guna model Claude, GPT, DeepSeek
OpenClaw adalah platform agen AI lokal dengan antarmuka obrolan web. Hubungkan APIMaster.ai (kompatibel dengan OpenAI) melalui openclaw onboard → Penyedia Kustom.
Dapatkan Kunci API terlebih dahulu. Gunakan placeholder
your_apimaster_keydi bawah.
Prasyarat
- Windows, macOS, atau Linux
- Node.js 22.19+ (Node 24 direkomendasikan; pemasang akan meningkatkan jika diperlukan)
- Kunci API APIMaster siap
Langkah 1 — Instal
Setelah instalasi, Anda biasanya akan melihat Memulai penyiapan… (onboard). Untuk hanya menginstal dan mengkonfigurasi nanti, lihat Instal tanpa onboard di bawah.
Windows (PowerShell)
powershell -c "irm https://openclaw.ai/install.ps1 | iex"

macOS (Terminal)
- Buka Terminal.app (atau iTerm).
- Jalankan pemasang resmi (dokumentasi OpenClaw):
curl -fsSL https://openclaw.ai/install.sh | bash
Pada macOS skrip akan:
- Mendeteksi Apple Silicon vs Intel
- Menginstal Homebrew jika tidak ada (memerlukan akun Administrator)
- Menginstal Node 24 (atau build lain ≥ 22.19) melalui Homebrew jika diperlukan
- Menginstal CLI
openclawdan biasanya memulai onboard
Periksa Node terlebih dahulu (opsional):
node --version # need v22.19+, v24.x recommended
Instal tanpa onboard:
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Kemudian jalankan openclaw onboard saat siap.
Jalur konfigurasi macOS:
| Item | Jalur |
|---|---|
| Konfigurasi | ~/.openclaw/openclaw.json |
| Ruang Kerja | ~/.openclaw/workspace |
| Sesi | ~/.openclaw/agents/main/sessions |
Tangkapan layar di bawah berasal dari Windows, tetapi alur CLI onboard sama di macOS (Custom Provider, Base URL, Skip channel, dll.).
Linux / WSL2
Sama seperti macOS:
curl -fsSL https://openclaw.ai/install.sh | bash
Gateway latar belakang opsional:
openclaw onboard --install-daemon
(macOS: LaunchAgent · Linux: systemd user service)
Langkah 2 — openclaw onboard
Jalankan kapan saja untuk (meng)konfigurasi:
openclaw onboard
Di macOS, gunakan sesi Terminal yang sama. Untuk Gateway yang persisten:
openclaw onboard --install-daemon
- Pemberitahuan keamanan → Ya
- Penyedia model/auth → Penyedia Kustom (endpoint yang kompatibel dengan OpenAI atau Anthropic)

- Isi:
| Bidang | Nilai |
|---|---|
| API Base URL | https://apimaster.ai/v1 |
| Kunci API | Tempelkan kunci APIMaster |
| Kompatibilitas Endpoint | kompatibel dengan OpenAI |
| ID Model | mis. gpt-5.5 |

ID Model: sembarang id model chat dari marketplace (gpt-5.4, claude-sonnet-4-6, …). Lewati model gambar seperti gpt-image-2.
- Langkah opsional: Lewati channel, pencarian web, skills, hooks.

Langkah 3 — Obrolan web
Jika browser tidak terbuka:
openclaw dashboard
Jika halaman gagal dimuat, jalankan openclaw dashboard lagi atau jalankan ulang openclaw onboard.
Langkah 4 — Uji coba
Pilih model di bawah input (mis. gpt-5.5 (Custom Provider)), kirim hello, konfirmasi balasan.

Pemecahan Masalah
| Masalah | Tindakan |
|---|---|
| Konfigurasi buruk | openclaw onboard |
| Halaman tidak terbuka | openclaw dashboard |
| 401 / kesalahan model | Periksa URL, kunci, id model; tes konektivitas |
macOS
| Masalah | Tindakan |
|---|---|
openclaw: command not found |
Tambahkan ke ~/.zshrc: export PATH="$(npm prefix -g)/bin:$PATH", buka ulang Terminal |
| Versi Node masih salah dengan nvm | nvm install 24 && nvm use 24 && nvm alias default 24, jalankan ulang pemasang |
| Instalasi Homebrew gagal | Gunakan akun Administrator, atau instal Homebrew terlebih dahulu |
| Gateway tidak berjalan | openclaw gateway status; coba openclaw onboard --install-daemon |
Daftar Periksa
- Custom Provider +
https://apimaster.ai/v1+ kunci - ID model chat (bukan gambar)
-
openclaw dashboardberfungsi - Pesan uji berhasil