Pemasangan OpenClaw dan Konfigurasi OmniProxy

OpenClaw ialah pembantu AI yang dipasang pada komputer anda sendiri. Anda boleh bercakap dengannya terus melalui Telegram, Discord, WhatsApp atau Feishu tanpa perlu sentiasa membuka tetingkap sembang lain; perbualan dan rekod akan kekal pada komputer ini, dan ia juga boleh meneruskan langkah-langkah berikutnya secara setempat.

Persediaan sebelum pemasangan

OpenClaw memerlukan Node 24.16 atau lebih baharu. Anda juga boleh menggunakan Node 26.1 atau lebih baharu, dan Node 26 disyorkan. Node ialah persekitaran asas yang diperlukan untuk menjalankan OpenClaw.

OpenClaw boleh dipasang pada macOS, Linux dan Windows. Jika komputer tidak mempunyai versi Node yang sesuai, skrip pemasangan akan menyediakannya secara automatik: Node 26 pada macOS dan Node 24 LTS pada Linux. pnpm hanya diperlukan apabila membina OpenClaw daripada kod sumber.

Jika komputer sudah memasang versi Node yang lebih lama, anda tidak perlu tergesa-gesa menyahpasangnya. Dalam ujian pada 2026-10-09, Node sistem pada komputer ini ialah 24.2.0, lebih rendah daripada keperluan 24.16, dan skrip pemasangan tanpa interaksi menyediakan Node 24.21.0 secara automatik.

Mahukan tetingkap

Pembantu desktop

• Pakej pemasangan Hub untuk Windows
• DMG daripada GitHub untuk macOS
• Gateway setempat boleh dipasang pada penggunaan pertama

Disyorkan secara rasmi

Skrip pemasangan

• macOS Linux WSL2
• Gunakan PowerShell pada Windows
• Boleh tambahkan --no-onboard

Node sudah tersedia

Pengurus pakej

• npm pnpm atau bun
• Kemudian jalankan onboard
• Lihat halaman pemasangan untuk versi Node

Pasang dan lancarkan buat kali pertama

Anda boleh memasang aplikasi pendamping desktop yang mempunyai tetingkap atau memasangnya terus melalui terminal. Gateway ialah perkhidmatan setempat yang menerima mesej, memanggil model dan menghantar semula hasil. Anda boleh menyediakannya sekali semasa membuka aplikasi pendamping desktop buat kali pertama.

Jika anda mahukan tetingkap

• Windows: Muat turun dan jalankan OpenClawCompanion-Setup-x64.exe atau OpenClawCompanion-Setup-arm64.exe. Pakej pemasangan ini ditandatangani serta mengandungi tetapan, status dulang sistem, sembang dan mod node.
• macOS: Muat turun fail .dmg untuk OpenClaw daripada GitHub releases OpenClaw. Utamakan dmg, tetapi anda juga boleh menggunakan .zip. Selepas pemasangan, buka OpenClaw.app. Jika versi ini tidak mempunyai fail macOS, ikut arahan pada halaman aplikasi macOS.

Apabila membukanya buat kali pertama, anda boleh membenarkan OpenClaw menyediakan Gateway pada komputer ini atau menyambung kepada Gateway jauh yang sedia ada.

Pasang menggunakan 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 mengenal pasti sistem semasa, memasang Node jika diperlukan, kemudian memasang OpenClaw dan memulakan panduan awal. Panduan tersebut akan membantu anda menyelesaikan persediaan pertama.

Jika anda belum mahu memulakan panduan, gunakan arahan berikut untuk macOS, Linux dan WSL2:

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

Untuk Windows, gunakan pilihan rasmi -NoOnboard:

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

Jika anda mengurus Node sendiri, anda juga boleh menggunakan npm, pnpm atau bun. Untuk npm 12 serta npm 11.16 dan lebih baharu, jalankan:

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

Untuk npm 11.15 dan versi lebih lama, alih keluar --allow-scripts=openclaw. Apabila menggunakan pnpm, tambahkan --allow-build=openclaw. Rujuk halaman pemasangan untuk perbezaan khusus.

Selepas pemasangan selesai, jalankan tiga arahan berikut secara berurutan:

openclaw --version
openclaw doctor
openclaw gateway status

openclaw --version digunakan untuk melihat versi, openclaw doctor digunakan untuk memeriksa masalah persekitaran yang lazim, dan openclaw gateway status digunakan untuk melihat sama ada Gateway sedang berjalan. Pemasangan asas hanya dianggap selesai apabila ketiga-tiga arahan menghasilkan output yang normal.

Jika terminal melaporkan bahawa openclaw tidak ditemui, biasanya direktori bin global npm belum ditambahkan pada PATH. PATH ialah senarai lokasi yang digunakan terminal untuk mencari program. Anda boleh membandingkan hasil node -v, npm prefix -g dan echo "$PATH", tambahkan direktori bin yang sepadan pada PATH, kemudian buka semula terminal.

Jika ~/.openclaw sudah mengandungi konfigurasi yang sedang digunakan, skrip pemasangan lalai akan menggunakan direktori tersebut. Jika anda mahu membuat pemasangan berasingan tanpa mengubah konfigurasi asal, jalankan skrip tanpa interaksi dan tentukan direktori baharu:

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

--no-onboard ialah tingkah laku lalai skrip ini. Pada 2026-10-09, arahan ini digunakan untuk memasang OpenClaw 2026.9.9. Selepas pemasangan selesai, anda perlu menjalankan openclaw dalam direktori bin bagi lokasi tersebut.

Dapatkan parameter sambungan daripada OmniProxy

Pastikan OmniProxy sedang berjalan, kemudian buka senarai modelnya dan sediakan tiga item berikut:

baseUrl: https://your-omniproxy-origin.example/v1
apiKey:  <YOUR_OMNIPROXY_API_KEY>
Model ID: salin keseluruhan ID daripada senarai model OmniProxy semasa

baseUrl ialah alamat yang digunakan OpenClaw untuk menghantar permintaan model dan mesti berakhir dengan /v1. Apabila menyambungkan OmniProxy, gunakan openai-completions untuk api. Tukar kepada openai-responses hanya jika model tersebut sememangnya berfungsi melalui /v1/responses.

Model ID ialah pengecam penuh model dalam senarai. Salin tepat seperti yang dipaparkan dalam senarai dan kekalkan semua garis miring yang terkandung di dalamnya. Dua nama berikut hanyalah rujukan daripada dokumentasi penyedia pada 2026-10-09. Jangan gunakannya jika tiada dalam senarai: claude-sonnet-5-5, gpt-6-luna.

Walaupun Gateway tidak mengesahkan kunci, apiKey masih perlu diisi. Anda boleh menggunakan rentetan aksara ruang letak yang hanya digunakan pada komputer ini. Jangan komit kunci sebenar ke dalam repositori.

Masukkan konfigurasi alat

Provider boleh difahami sebagai sekumpulan tetapan sambungan yang digunakan OpenClaw untuk mencari perkhidmatan model. Di sini, Provider dinamakan omniproxy.

Jalankan arahan berikut dalam terminal dan gantikan alamat, kunci serta dua ID model 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

Arahan ini akan menulis Provider dan senarai model ke dalam konfigurasi. Selepas arahan berjaya, Gateway tidak perlu dimulakan semula.

Seterusnya, tentukan model lalai. Rujukan model terdiri daripada omniproxy/ dan ID model. Kekalkan semua garis miring yang memang terdapat dalam ID. Jika ID dalam senarai model lebih panjang daripada nama pendek di bawah, gunakan kandungan penuh daripada senarai:

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

reasoning, input, cost, contextWindow dan maxTokens semuanya boleh ditinggalkan. Jika tidak diisi, model teks akan dikendalikan mengikut tetapan lalai.

Tetapan yang sama juga boleh ditulis terus ke dalam fail konfigurasi. Provider dalam konfigurasi utama terletak di models.providers. Setiap agent juga boleh mempunyai models.json sendiri; agent ialah tika pembantu yang benar-benar menerima tugas dan memanggil model. Fail tersebut terletak dalam agent/models.json di bawah direktori agent yang sepadan dalam ~/.openclaw/agents/.

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

Semak pemasangan

Tiga perintah

• openclaw --version
• openclaw doctor
• gateway status

Konfigurasi

models.providers

• baseUrl mesti berakhir dengan /v1
• Gunakan completions untuk api
• Sekurang-kurangnya tulis id model

Pemilihan

provider/model

• Gunakan rujukan ini untuk primary
• Utamakan pemboleh ubah persekitaran untuk kunci
• Gunakan senarai daripada get laluan

Sahkan tugas sebenar

Buka direktori projek biasa dan hantar mesej yang sangat ringkas. Gantikan rujukan model dalam arahan dengan Model ID penuh anda:

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

--local bermaksud tugas agent ini dijalankan pada komputer setempat, --model menentukan model yang digunakan untuk tugas ini, dan --timeout 300 bermaksud menunggu sehingga maksimum 300 saat.

Respons sebenar daripada model mesti muncul dalam terminal. Pada 2026-10-09, OpenClaw 2026.9.9 menerima respons menggunakan arahan ini. Panggilan pertama mungkin mengambil masa satu atau dua minit.

Jika ralat asal Request timed out before a response was generated muncul, tingkatkan nilai --timeout terlebih dahulu, kemudian hantar sekali lagi. Ini biasanya bermaksud masa menunggu tidak mencukupi dan tidak semestinya menunjukkan bahawa alamat itu salah.

Selepas respons ringkas berjaya diterima, minta ia membaca fail setempat yang anda tentukan. Kemudian buka rekod panggilan OmniProxy dan sahkan sumber serta ID model dalam rekod tersebut. Output nombor versi atau doctor sahaja belum membuktikan bahawa sambungan model telah selesai dikonfigurasi.

Pemasangan

Perintah memberikan respons

• Nombor versi dapat dipaparkan
• doctor tidak menyekat
• Status Gateway dapat dibaca

Tugas

Ia menyelesaikan satu tugas kecil

• Contohnya, membaca fail setempat
• Respons bukan ralat
• Rujukan model ditulis dengan betul

Rekod

Kelihatan dalam get laluan

• Sumbernya ialah OpenClaw
• ID model sepadan
• Kunci tidak dimasukkan ke repositori

Ralat lazim

• openclaw tidak ditemui: Tambahkan bin global npm pada PATH, kemudian buka semula terminal. Jika anda memasangnya dalam direktori tertentu, jalankan program dalam direktori bin bagi lokasi tersebut.
• node -v lebih rendah daripada 24.16: Anda tidak perlu menyahpasang versi lama terlebih dahulu. Periksa Node yang disediakan oleh skrip pemasangan atau gunakan 24.16+ atau 26.1+ seperti yang dinyatakan pada halaman pemasangan. Node 26 disyorkan.
• Model tidak muncul: Model mesti dimasukkan dalam tatasusunan models di bawah models.providers dan sekurang-kurangnya mempunyai id yang sama. Menulisnya hanya dalam agents.defaults.models tidak akan mendaftarkan model baharu secara berasingan.
• Menerima 400 dan menyebut peranan developer: Apabila hos alamat bukan api.openai.com, kekalkan tetapan lalai dan jangan tetapkan supportsDeveloperRole kepada true. Walaupun ditetapkan kepada true, nilai itu masih akan ditulis ganti.
• Tamat masa terlalu cepat: Tingkatkan --timeout kepada 300 saat atau lebih dan jangan ubah alamat terlebih dahulu.
• Panggilan alat gagal selepas memilih gpt-6-luna: Model ini menyokong Chat Completions; panggilan fungsi dalam Chat Completions hanya disokong apabila reasoning_effort ialah none. Jika ID dalam senarai berbeza daripada ini, ikut ID dalam senarai.
• Alamat tidak dapat disambungkan: Pastikan OmniProxy sedang berjalan, baseUrl berakhir dengan /v1, dan alamat yang ditulis dalam konfigurasi boleh dicapai. Alamat rangkaian persendirian lain perlu dibenarkan secara berasingan.
• Selepas dikonfigurasi, permintaan masih dihantar ke alamat lain: Periksa sama ada models.json bagi agent tersebut mengandungi baseUrl yang lain.

Rujukan rasmi

Untuk langkah pemasangan, lihat OpenClaw install. Untuk cara menyediakan Provider tersuai, lihat Custom providers dan medan konfigurasi. ID model yang digunakan dalam contoh boleh dibandingkan dengan gambaran keseluruhan model Claude dan GPT-6 Luna.

Gantikan setiap penanda tempat dengan nilai dari konfigurasi OmniProxy anda sendiri. Jangan pernah terbitkan kunci sebenar.

Hasil tersimpan atau HTTP 200 sahaja tidak membuktikan keserasian Agen penuh. Semak sumber dan model dalam rekod panggilan OmniProxy.

Sumber rasmi · OpenClaw ↗