Instalasi OpenClaw dan Konfigurasi OmniProxy

OpenClaw adalah asisten AI yang dipasang di komputer Anda sendiri. Anda dapat langsung berbicara dengannya melalui Telegram, Discord, WhatsApp, atau Feishu tanpa harus terus membuka jendela percakapan lain. Percakapan dan catatan akan tetap berada di komputer ini, dan OpenClaw juga dapat melanjutkan langkah berikutnya secara lokal.

Persiapan sebelum instalasi

OpenClaw memerlukan Node 24.16 atau versi yang lebih baru. Anda juga dapat menggunakan Node 26.1 atau versi yang lebih baru, dan Node 26 direkomendasikan. Node adalah lingkungan dasar yang diperlukan untuk menjalankan OpenClaw.

OpenClaw dapat dipasang di macOS, Linux, dan Windows. Jika komputer belum memiliki versi Node yang sesuai, skrip instalasi akan menyiapkannya secara otomatis: Node 26 di macOS dan Node 24 LTS di Linux. pnpm hanya diperlukan jika Anda membangun OpenClaw dari kode sumber.

Jika versi Node yang lebih lama sudah terpasang di komputer, Anda tidak perlu segera menghapusnya. Dalam pengujian pada 2026-10-09, Node sistem di komputer ini adalah 24.2.0, lebih rendah daripada persyaratan 24.16, dan skrip instalasi noninteraktif menyiapkan Node 24.21.0 secara otomatis.

Jika menginginkan jendela

Pendamping desktop

• Gunakan paket instalasi Hub di Windows
• Gunakan DMG dari GitHub di macOS
• Gateway lokal dapat diinstal saat pertama kali

Rekomendasi resmi

Skrip instalasi

• macOS Linux WSL2
• Di Windows, gunakan PowerShell
• Dapat menambahkan --no-onboard

Jika sudah memiliki Node

Pengelola paket

• npm pnpm atau bun
• Lalu jalankan onboard
• Lihat versi Node di halaman instalasi

Instalasi dan peluncuran pertama

Anda dapat memasang aplikasi pendamping desktop dengan antarmuka berjendela atau melakukan instalasi langsung melalui terminal. Gateway adalah layanan lokal yang menerima pesan, memanggil model, dan mengirimkan kembali hasilnya. Anda dapat menyiapkannya saat pertama kali membuka aplikasi pendamping desktop.

Jika menginginkan antarmuka berjendela

• Windows: Unduh dan jalankan OpenClawCompanion-Setup-x64.exe atau OpenClawCompanion-Setup-arm64.exe. Paket instalasi ditandatangani dan mencakup pengaturan, status tray, percakapan, serta mode node.
• macOS: Unduh .dmg untuk OpenClaw dari GitHub releases OpenClaw. Utamakan dmg, tetapi Anda juga dapat menggunakan .zip. Setelah instalasi selesai, buka OpenClaw.app. Jika tidak tersedia berkas macOS untuk versi ini, ikuti petunjuk di halaman aplikasi macOS.

Saat pertama kali membukanya, Anda dapat meminta OpenClaw menyiapkan Gateway di komputer ini atau menghubungkannya ke Gateway jarak jauh yang sudah tersedia.

Instalasi melalui terminal

Untuk macOS, Linux, dan WSL2, gunakan:

curl -fsSL https://openclaw.ai/install.sh | bash

Untuk Windows PowerShell, gunakan:

iwr -useb https://openclaw.ai/install.ps1 | iex

Skrip akan mendeteksi sistem yang digunakan, memasang Node jika diperlukan, kemudian memasang OpenClaw dan memulai panduan awal. Panduan tersebut akan membantu Anda menyelesaikan penyiapan pertama.

Jika untuk sementara Anda tidak ingin membuka panduan, gunakan perintah berikut di macOS, Linux, dan WSL2:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

Di Windows, gunakan opsi resmi -NoOnboard:

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

Jika Anda mengelola Node sendiri, Anda juga dapat menggunakan npm, pnpm, atau bun. Untuk npm 12 serta npm 11.16 dan versi yang lebih baru, jalankan:

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

Untuk npm 11.15 dan versi yang lebih lama, hapus --allow-scripts=openclaw. Saat menggunakan pnpm, tambahkan --allow-build=openclaw. Lihat halaman instalasi untuk rincian perbedaannya.

Setelah instalasi selesai, jalankan tiga perintah berikut secara berurutan:

openclaw --version
openclaw doctor
openclaw gateway status

openclaw --version digunakan untuk melihat versi, openclaw doctor untuk memeriksa masalah lingkungan yang umum, dan openclaw gateway status untuk melihat apakah Gateway sedang berjalan. Instalasi dasar dianggap selesai hanya jika ketiga perintah menghasilkan keluaran yang normal.

Jika terminal menyatakan bahwa openclaw tidak ditemukan, biasanya direktori bin global npm belum ditambahkan ke PATH. PATH adalah daftar lokasi yang digunakan terminal untuk mencari program. Anda dapat membandingkan hasil node -v, npm prefix -g, dan echo "$PATH", lalu menambahkan direktori bin yang sesuai ke PATH dan membuka ulang terminal.

Jika ~/.openclaw sudah berisi konfigurasi yang sedang digunakan, skrip instalasi bawaan akan menggunakan direktori tersebut. Untuk memasang salinan terpisah tanpa mengubah konfigurasi lama, jalankan skrip noninteraktif dan tentukan direktori baru:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix "$HOME/openclaw-omniproxy" --no-onboard

--no-onboard adalah perilaku bawaan skrip ini. Pada 2026-10-09, perintah tersebut digunakan untuk memasang OpenClaw 2026.9.9. Setelah instalasi selesai, Anda perlu menjalankan openclaw yang berada di direktori bin instalasi tersebut.

Mendapatkan parameter koneksi dari OmniProxy

Pastikan terlebih dahulu bahwa OmniProxy sedang berjalan, lalu buka daftar modelnya dan siapkan tiga informasi berikut:

baseUrl: https://your-omniproxy-origin.example/v1
apiKey:  <YOUR_OMNIPROXY_API_KEY>
Model ID: salin ID lengkap dari daftar model OmniProxy saat ini

baseUrl adalah alamat tujuan OpenClaw untuk mengirim permintaan model dan harus diakhiri dengan /v1. Saat menghubungkan OmniProxy, gunakan openai-completions untuk api. Ubah menjadi openai-responses hanya jika model tersebut benar-benar berfungsi melalui /v1/responses.

Model ID adalah pengenal lengkap model dalam daftar. Salin persis seperti yang tercantum. Jika ID berisi garis miring, pertahankan garis miring tersebut. Dua nama berikut hanya merupakan referensi dari dokumentasi penyedia pada 2026-10-09. Jangan gunakan jika tidak tersedia dalam daftar: claude-sonnet-5-5, gpt-6-luna.

Meskipun gateway tidak memeriksa kunci, apiKey tetap harus diisi. Anda dapat menggunakan rangkaian karakter pengganti yang hanya digunakan di komputer ini. Jangan memasukkan kunci asli ke repositori.

Mengisi konfigurasi alat

Provider dapat dipahami sebagai sekumpulan pengaturan koneksi yang digunakan OpenClaw untuk menemukan layanan model. Di sini, Provider diberi nama omniproxy.

Jalankan perintah berikut di terminal, lalu ganti alamat, kunci, dan kedua model ID dengan nilai Anda sendiri:

openclaw config set models.providers.omniproxy '{"baseUrl":"https://your-omniproxy-origin.example/v1","apiKey":"<YOUR_OMNIPROXY_API_KEY>","api":"openai-completions","models":[{"id":"claude-sonnet-5-5","name":"Claude Sonnet 5.5"},{"id":"gpt-6-luna","name":"GPT-6 Luna"}]}' --strict-json --merge

Perintah ini akan menulis Provider dan daftar model ke dalam konfigurasi. Setelah perintah berhasil dijalankan, Gateway tidak perlu dimulai ulang.

Selanjutnya, tentukan model bawaan. Referensi model terdiri dari omniproxy/ dan model ID. Pertahankan semua garis miring yang sudah ada di dalam ID. Jika ID dalam daftar model lebih panjang daripada nama singkat di bawah ini, gunakan ID lengkap dari daftar:

openclaw config set agents.defaults.model.primary '"omniproxy/claude-sonnet-5-5"' --strict-json

reasoning, input, cost, contextWindow, dan maxTokens boleh tidak ditulis. Jika tidak diisi, model teks akan diproses menggunakan pengaturan bawaan.

Pengaturan yang sama juga dapat ditulis langsung ke berkas konfigurasi. Provider dalam konfigurasi utama berada di models.providers. Setiap agent juga dapat memiliki models.json sendiri. Agent adalah instans asisten yang benar-benar menerima tugas dan memanggil model. Berkas tersebut berada di agent/models.json dalam direktori agent yang sesuai di bawah ~/.openclaw/agents/.

Jika models.json ini berisi baseUrl yang tidak kosong, nilainya akan menggantikan alamat dalam konfigurasi utama.

Periksa instalasi

Tiga perintah

• openclaw --version
• openclaw doctor
• gateway status

Konfigurasi

models.providers

• Akhiri baseUrl dengan /v1
• Gunakan completions untuk api
• Setidaknya tentukan id model

Pemilihan

provider/model

• Gunakan referensi ini untuk primary
• Utamakan variabel lingkungan untuk kunci
• Gunakan daftar dari gateway

Memverifikasi tugas nyata

Masuk ke direktori proyek biasa dan kirim pesan yang sangat singkat. Ganti referensi model dalam perintah dengan Model ID lengkap Anda:

openclaw agent --local --model omniproxy/claude-sonnet-5-5 --timeout 300 --message "Balas dengan satu kata."

--local berarti tugas agent ini dijalankan secara lokal, --model menentukan model yang digunakan untuk tugas ini, dan --timeout 300 berarti waktu tunggu maksimum adalah 300 detik.

Respons model harus benar-benar muncul di terminal. Pada 2026-10-09, OpenClaw 2026.9.9 menerima respons menggunakan perintah ini. Panggilan pertama mungkin memerlukan waktu satu atau dua menit.

Jika muncul pesan kesalahan asli Request timed out before a response was generated, tingkatkan terlebih dahulu nilai --timeout, lalu kirim ulang. Hal ini biasanya berarti waktu tunggu tidak cukup dan tidak selalu menunjukkan bahwa alamatnya salah.

Setelah respons singkat berhasil, minta OpenClaw membaca satu berkas lokal yang Anda tentukan. Kemudian buka catatan panggilan OmniProxy dan konfirmasikan sumber serta model ID dalam catatan tersebut. Keluaran nomor versi atau doctor saja belum membuktikan bahwa koneksi model telah selesai dikonfigurasi.

Instalasi

Perintah memberikan respons

• Nomor versi dapat ditampilkan
• doctor tidak menemukan masalah yang menghambat
• Status Gateway dapat dibaca

Tugas

Satu tugas kecil berhasil dilakukan

• Misalnya, membaca file lokal
• Balasannya bukan pesan kesalahan
• Referensi model ditulis dengan benar

Catatan

Terlihat di gateway

• Sumbernya adalah OpenClaw
• ID model sesuai
• Kunci tidak masuk ke repositori

Kesalahan umum

• openclaw tidak ditemukan: Tambahkan direktori bin global npm ke PATH, lalu buka ulang terminal. Jika memasang ke direktori tertentu, jalankan program yang berada di direktori bin instalasi tersebut.
• node -v lebih rendah daripada 24.16: Anda tidak perlu menghapus versi lama terlebih dahulu. Periksa Node yang disiapkan oleh skrip instalasi atau gunakan versi 24.16+ atau 26.1+ sesuai halaman instalasi. Node 26 direkomendasikan.
• Model tidak muncul: Model harus ditulis dalam array models di models.providers dan setidaknya memiliki id yang sama. Hanya menulis agents.defaults.models tidak akan mendaftarkan model baru secara terpisah.
• Menerima respons 400 yang menyebut peran developer: Jika host alamat bukan api.openai.com, pertahankan pengaturan bawaan dan jangan menetapkan supportsDeveloperRole ke true. Nilai tersebut tetap akan ditimpa meskipun ditetapkan ke true.
• Waktu habis terlalu cepat: Tingkatkan --timeout menjadi lebih dari 300 detik dan jangan ubah alamat terlebih dahulu.
• Pemanggilan alat gagal setelah memilih gpt-6-luna: Model ini mendukung Chat Completions. Dalam Chat Completions, pemanggilan fungsi hanya didukung ketika reasoning_effort bernilai none. Jika ID dalam daftar berbeda, gunakan ID yang tercantum dalam daftar.
• Alamat tidak dapat dihubungi: Pastikan OmniProxy sedang berjalan, baseUrl diakhiri dengan /v1, dan alamat yang ditulis ke konfigurasi dapat diakses. Alamat jaringan privat lainnya perlu diizinkan secara terpisah.
• Setelah dikonfigurasi, permintaan masih menuju alamat lain: Periksa apakah models.json milik agent tersebut berisi baseUrl lain.

Referensi resmi

Lihat langkah instalasi di OpenClaw install. Cara mengatur Provider khusus tersedia di Custom providers dan kolom konfigurasi. Model ID yang digunakan dalam contoh dapat dibandingkan dengan ringkasan model Claude dan GPT-6 Luna.

Ganti setiap placeholder dengan nilai dari konfigurasi OmniProxy Anda sendiri. Jangan pernah menerbitkan kunci asli.

Hasil tersimpan atau HTTP 200 saja tidak membuktikan kompatibilitas Agen penuh. Periksa sumber dan model dalam catatan panggilan OmniProxy.

Sumber resmi · OpenClaw ↗