Pag-install ng OpenClaw at Pag-configure ng OmniProxy

Ang OpenClaw ay isang AI assistant na naka-install sa sarili mong computer. Maaari mo itong kausapin nang direkta sa pamamagitan ng Telegram, Discord, WhatsApp, o Feishu nang hindi na kailangang magbukas ng isa pang chat window. Ang mga usapan at record ay nananatili sa computer na ito, at maaari nitong ipagpatuloy ang mga susunod na hakbang nang lokal.

Bago Ka Magsimula

Ang OpenClaw ay nangangailangan ng Node 24.16 o mas bago. Maaari mo ring gamitin ang Node 26.1 o mas bago, kung saan inirerekomenda ang Node 26. Ang Node ang nagbibigay ng runtime environment na kailangan ng OpenClaw.

Maaari itong i-install sa macOS, Linux, at Windows. Kung ang computer ay walang angkop na bersyon ng Node, awtomatikong ihahanda ito ng installation script: Node 26 sa macOS at Node 24 LTS sa Linux. Ang pnpm ay kailangan lamang kapag nagbi-build ng OpenClaw mula sa source.

Kung mayroon nang mas lumang bersyon ng Node, hindi mo na kailangang i-uninstall ito muna. Noong testing noong 2026-10-09, ang system Node version sa computer na ito ay 24.2.0, na mas mababa sa kinakailangang 24.16, at ang non-interactive installation script ay awtomatikong naghanda ng Node 24.21.0.

Gusto ng window

Desktop companion

• Gamitin ang Hub installer sa Windows
• Gamitin ang GitHub DMG sa macOS
• Ang lokal na Gateway ay maaaring i-install sa unang setup

Opisyal na inirerekomenda

Installation script

• macOS Linux WSL2
• Gamitin ang PowerShell sa Windows
• Maaari mong idagdag ang --no-onboard

Naka-install na ang Node

Package manager

• npm pnpm o bun
• Pagkatapos ay patakbuhin ang onboard
• Tingnan ang installation page para sa Node version

Pag-install at Unang Paglulunsad

Maaari mong i-install ang desktop companion na may graphical window, o i-install nang direkta sa pamamagitan ng terminal. Ang Gateway ay ang lokal na serbisyo na responsable sa pagtanggap ng mga mensahe, pagtawag sa mga model, at pagbabalik ng mga resulta. Maaari mo itong i-set up kapag binuksan ang desktop companion sa unang pagkakataon.

Kung Gusto Mo ng Window

• Windows: I-download at patakbuhin ang OpenClawCompanion-Setup-x64.exe o OpenClawCompanion-Setup-arm64.exe. Ang installer ay may pirma at may kasamang mga setting, tray status, chat, at node modes.
• macOS: I-download ang OpenClaw .dmg mula sa GitHub releases ng OpenClaw. Mas mainam ang dmg, bagaman maaari mo ring gamitin ang .zip. Buksan ang OpenClaw.app pagkatapos ng pag-install. Kung ang bersyong ito ay walang kasamang macOS file, sundin ang macOS app page.

Kapag binuksan ito sa unang pagkakataon, maaari mong hayaan ang OpenClaw na ihanda ang Gateway sa computer na ito o kumonekta sa isang umiiral na remote Gateway.

Pag-install sa Pamamagitan ng Terminal

Para sa macOS, Linux, at WSL2, gamitin ang:

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

Para sa Windows PowerShell, gamitin ang:

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

Dine-detect ng script ang kasalukuyang system, nag-i-install ng Node kung kinakailangan, nag-i-install ng OpenClaw, at pagkatapos ay sinisimulan ang initial onboarding process. Ang onboarding flow ang gagabay sa iyo sa unang setup.

Kung ayaw mo pang simulan ang onboarding, gamitin ang sumusunod sa halip sa macOS, Linux, at WSL2:

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

Sa Windows, gamitin ang opisyal na -NoOnboard opsyon:

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

Kung ikaw na mismo ang namamahala sa Node, maaari mo ring gamitin ang npm, pnpm, o bun. Sa npm 12 o npm 11.16 at mas bago, patakbuhin ang:

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

Para sa npm 11.15 at mas luma, alisin ang --allow-scripts=openclaw. Kapag gumagamit ng pnpm, idagdag ang --allow-build=openclaw. Sumangguni sa installation page para sa eksaktong pagkakaiba.

Pagkatapos ng pag-install, patakbuhin ang tatlong command na ito nang sunod-sunod:

openclaw --version
openclaw doctor
openclaw gateway status

openclaw --version ay nagpapakita ng bersyon, openclaw doctor ay sumusuri para sa mga karaniwang isyu sa environment, at openclaw gateway status ay nagpapakita kung tumatakbo ang Gateway. Ang pangunahing pag-install ay kumpleto lamang kapag ang lahat ng tatlong command ay naglabas ng normal na output.

Kung ang terminal ay nag-ulat na hindi nito mahanap ang openclaw, ang npm global bin directory ay karaniwang wala sa PATH. Ang PATH ay ang listahan ng mga lokasyon kung saan naghahanap ang terminal ng mga program. Ihambing ang output ng node -v, npm prefix -g, at echo "$PATH", idagdag ang kaukulang bin directory sa PATH, at pagkatapos ay buksan muli ang terminal.

Kung ang ~/.openclaw ay mayroon nang configuration na kasalukuyang ginagamit, gagamitin ng default installation script ang directory na iyon. Para mag-install ng hiwalay na kopya nang hindi binabago ang umiiral na configuration, patakbuhin ang non-interactive script at tukuyin ang bagong directory:

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

--no-onboard ay ang default na gawi ng script na ito. Noong 2026-10-09, ang command na ito ay nag-install ng OpenClaw 2026.9.9. Pagkatapos ng pag-install, patakbuhin ang openclaw executable mula sa bin folder ng directory.

Kumuha ng Connection Values mula sa OmniProxy

Siguraduhin muna na tumatakbo ang OmniProxy, pagkatapos ay buksan ang listahan ng mga model nito at ihanda ang sumusunod na tatlong value:

baseUrl: https://your-omniproxy-origin.example/v1
apiKey:  <YOUR_OMNIPROXY_API_KEY>
Model ID: copy the full value from the current OmniProxy model list

baseUrl ay ang address kung saan ipinapadala ng OpenClaw ang mga request sa model, at dapat itong magtapos sa /v1. Kapag kumokonekta sa OmniProxy, gamitin ang openai-completions para sa api. Palitan ito ng openai-responses lamang kung ang model ay talagang gumagana sa pamamagitan ng /v1/responses.

Ang Model ID ay ang kumpletong identifier ng model sa listahan. Kopyahin ito nang eksakto gaya ng ipinapakita, kasama ang anumang slash. Ang sumusunod na dalawang pangalan ay mga sanggunian lamang mula sa dokumentasyon ng provider simula noong 2026-10-09; huwag gamitin ang mga ito kung hindi sila lumalabas sa listahan: claude-sonnet-5-5, gpt-6-luna.

Kahit na hindi i-validate ng gateway ang key, apiKey ay dapat pa ring maglaman ng value. Maaari kang gumamit ng placeholder string na ginagamit lamang sa computer na ito. Huwag mag-commit ng totoong key sa isang repository.

Ipasok ang Configuration ng Tool

Ang isang Provider ay maaaring ituring bilang isang set ng mga setting ng koneksyon na ginagamit ng OpenClaw para mahanap ang isang model service. Dito, ang Provider ay pinangalanang omniproxy.

Patakbuhin ang sumusunod na command sa terminal, palitan ang address, key, at dalawang model ID ng sarili mong mga value:

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

Ang command na ito ay nagsusulat ng Provider at listahan ng mga model sa configuration. Hindi mo na kailangang i-restart ang Gateway pagkatapos magtagumpay ang command.

Susunod, tukuyin ang default model. Ang sanggunian ng model ay binubuo ng omniproxy/ na sinusundan ng model ID. Panatilihin ang bawat slash na naroroon na sa ID. Kung ang ID sa listahan ng mga model ay mas mahaba kaysa sa maikling pangalan sa ibaba, gamitin ang kumpletong value mula sa listahan:

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

reasoning, input, cost, contextWindow, at maxTokens ay maaaring alisin lahat. Kapag hindi sila ibinigay, ang mga text model ay pinoproseso gamit ang mga default.

Maaari mo ring isulat ang parehong mga setting nang direkta sa configuration file. Sa pangunahing configuration, ang Provider ay matatagpuan sa ilalim ng models.providers. Ang bawat agent ay maaari ring magkaroon ng sarili nitong models.json; ang agent ay isang assistant instance na aktwal na tumatanggap ng mga gawain at tumatawag sa mga model. Ang file ay matatagpuan sa agent/models.json sa loob ng kaukulang agent directory sa ilalim ng ~/.openclaw/agents/.

Kung ang models.json na ito ay naglalaman ng hindi bakanteng baseUrl, ino-override nito ang address sa pangunahing configuration.

Suriin ang pag-install

Tatlong command

• openclaw --version
• openclaw doctor
• gateway status

Configuration

models.providers

• baseUrl nagtatapos sa /v1
• I-set ang api sa completions
• Tukuyin kahit ang model id

Piliin

provider/model

• Gamitin ang sangguniang ito para sa primary
• Mas mainam ang environment variable para sa key
• Gamitin ang listahan ng gateway bilang source of truth

I-verify ang Isang Totoong Gawain

Pumasok sa isang regular na project directory at magpadala ng napakaikling mensahe. Palitan ang sanggunian ng model sa command ng iyong kumpletong Model ID:

openclaw agent --local --model omniproxy/claude-sonnet-5-5 --timeout 300 --message "Reply with one word."

--local ay nagpapatakbo ng agent task na ito nang lokal, --model ay tumutukoy sa model na gagamitin para sa run na ito, at --timeout 300 ay nagtatakda ng maximum na oras ng paghihintay sa 300 segundo.

Ang isang aktwal na tugon mula sa model ay dapat lumabas sa terminal. Noong 2026-10-09, ang OpenClaw 2026.9.9 ay nakatanggap ng tugon gamit ang command na ito. Ang unang tawag ay maaaring tumagal ng isa o dalawang minuto.

Kung ang orihinal na error na Request timed out before a response was generated ay lumabas, dagdagan ang --timeout at ipadala muli ang request. Karaniwang nangangahulugan ito na hindi sapat ang oras ng paghihintay at hindi kinakailangang nangangahulugan na mali ang address.

Pagkatapos magtagumpay ang maikling tugon, hilingin dito na basahin ang isang lokal na file na iyong tinukoy. Pagkatapos ay buksan ang mga request record ng OmniProxy at kumpirmahin ang source at model ID na ipinapakita sa record. Ang output mula lamang sa version command o doctor ay hindi nangangahulugan na ang koneksyon sa model ay ganap nang na-configure.

Pag-install

Tumutugon ang command

• Ang version number ay ipinapakita
• Ang doctor ay walang iniulat na mga blocker
• Ang status ng Gateway ay nababasa

Gawain

Nakumpleto nito ang isang maliit na gawain

• Halimbawa, basahin ang isang lokal na file
• Ang tugon ay hindi isang error
• Ang sanggunian ng model ay tama

Mga Log

Nakikita sa gateway

• Ang source ay OpenClaw
• Ang Model ID ay tumutugma
• Ang key ay hindi idinagdag sa repository

Mga Karaniwang Error

• Hindi mahanap ang openclaw: Idagdag ang npm global bin directory sa PATH, pagkatapos ay buksan muli ang terminal. Kung nag-install ka sa isang tinukoy na directory, patakbuhin ang executable mula sa bin folder ng directory.
• node -v ay mas mababa sa 24.16: Hindi mo na kailangang i-uninstall ang lumang bersyon muna. Suriin ang Node version na inihanda ng installation script, o gumamit ng 24.16+ o 26.1+ gaya ng inilarawan sa installation page. Inirerekomenda ang Node 26.
• Hindi lumalabas ang model: Ang model ay dapat kasama sa models array sa ilalim ng models.providers at dapat kahit man lang ay may parehong id. Ang pag-set lamang ng agents.defaults.models ay hindi nagrerehistro ng bagong model nang mag-isa.
• Ang 400 response ay bumabanggit ng developer role: Kapag ang address host ay hindi api.openai.com, panatilihin ang default at huwag i-set ang supportsDeveloperRole sa true. Kahit i-set ito sa true, mao-override pa rin ito.
• Mabilis itong mag-timeout: Dagdagan ang --timeout sa higit sa 300 segundo bago baguhin ang address.
• Nabibigo ang mga tool call pagkatapos piliin ang gpt-6-luna: Sinusuportahan nito ang Chat Completions; ang function calling sa Chat Completions ay sinusuportahan lamang kapag ang reasoning_effort ay none. Kung ang ID sa listahan ay naiiba sa isang ito, gamitin ang ID na ipinapakita sa listahan.
• Hindi maabot ang address: Kumpirmahin na tumatakbo ang OmniProxy, na ang baseUrl ay nagtatapos sa /v1, at na ang address na isinulat sa configuration ay naa-access. Ang ibang mga private-network address ay dapat payagan nang hiwalay.
• Ang mga request ay napupunta pa rin sa ibang address pagkatapos ng configuration: Suriin kung ang models.json ng agent na iyon ay naglalaman ng ibang baseUrl.

Mga Opisyal na Sanggunian

Para sa mga hakbang sa pag-install, tingnan ang OpenClaw install. Para sa custom Provider configuration, tingnan ang Custom providers at configuration fields. Para sa mga model ID na ginamit sa mga halimbawa, ihambing sa Claude model overview at GPT-6 Luna.

Palagyan ng halaga mula sa iyong sariling konfigurasyon ng OmniProxy ang bawat placeholder. Huwag kailanman ilabas ang tunay na key.

Ang isang na-save na resulta o HTTP 200 lamang ay hindi patunay ng full Agent compatibility. Suriin ang source at modelo sa call log ng OmniProxy.

Mga opisyal na pinagkukunan · OpenClaw ↗