Az OpenClaw telepítése és az OmniProxy konfigurálása

Az OpenClaw egy saját számítógépre telepíthető AI-asszisztens. Közvetlenül beszélgethet vele Telegramon, Discordon, WhatsAppon vagy Feishun keresztül anélkül, hogy külön csevegőablakot kellene nyitva tartania. A beszélgetések és a rekordok ezen a számítógépen maradnak, és képes a további lépéseket helyben végrehajtani.

Mielőtt elkezdené

Az OpenClaw a Node 24.16-os vagy újabb verzióját igényli. Használhatja a Node 26.1-es vagy újabb verzióját is, a Node 26 ajánlott. A Node biztosítja az OpenClaw által igényelt futtatókörnyezetet.

Telepíthető macOS, Linux és Windows rendszerekre. Ha a számítógépen nincs megfelelő Node-verzió, a telepítőszkript automatikusan előkészít egyet: Node 26 macOS-en és Node 24 LTS Linuxon. A pnpm csak akkor szükséges, ha az OpenClaw-t forráskódból építi.

Ha már telepítve van a Node egy régebbi verziója, nem kell először eltávolítania. A 2026-10-09-i tesztelés során a rendszer Node-verziója ezen a számítógépen 24.2.0 volt, ami a szükséges 24.16 alatt van, és a nem interaktív telepítőszkript automatikusan előkészítette a Node 24.21.0-t.

Szeretne egy ablakot

Asztali kísérő

• Használja a Hub telepítőt Windowson
• Használja a GitHub DMG-t macOS-en
• A helyi Gateway telepíthető a kezdeti beállítás során

Hivatalosan ajánlott

Telepítőszkript

• macOS Linux WSL2
• Használja a PowerShellt Windowson
• Hozzáadhatja a --no-onboard kapcsolót

A Node már telepítve van

Csomagkezelő

• npm pnpm vagy bun
• Ezután futtassa az onboardot
• Tekintse meg a telepítési oldalt a Node verziójához

Telepítés és első indítás

Telepítheti az asztali kísérőt grafikus ablakkal, vagy közvetlenül a terminálon keresztül. A Gateway az a helyi szolgáltatás, amely az üzenetek fogadásáért, a modellek meghívásáért és az eredmények visszaküldéséért felelős. Ezt az asztali kísérő első megnyitásakor állíthatja be.

Ha szeretne egy ablakot

• Windows: Töltse le és futtassa a OpenClawCompanion-Setup-x64.exe vagy OpenClawCompanion-Setup-arm64.exe fájlt. A telepítő aláírt, és tartalmazza a beállításokat, a tálca állapotát, a csevegést és a csomóponti módokat.
• macOS: Töltse le a OpenClaw .dmg fájlt az OpenClaw GitHub kiadásaiból. A dmg-t részesítse előnyben, bár használhatja a .zip-t is. A telepítés után nyissa meg az OpenClaw.app-ot. Ha ez a verzió nem tartalmaz macOS fájlt, kövesse a macOS alkalmazás oldalát.

Az első megnyitáskor hagyhatja, hogy az OpenClaw előkészítse a Gateway-t ezen a számítógépen, vagy csatlakozhat egy meglévő távoli Gateway-hez.

Telepítés a terminálon keresztül

macOS, Linux és WSL2 esetén használja:

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

Windows PowerShell esetén használja:

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

A szkript észleli az aktuális rendszert, szükség esetén telepíti a Node-ot, telepíti az OpenClaw-t, majd elindítja a kezdeti bevezetési folyamatot. A bevezetési folyamat végigvezeti az első beállításon.

Ha még nem szeretné elindítani a bevezetést, használja helyette a következőket macOS, Linux és WSL2 rendszereken:

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

Windowson használja a hivatalos -NoOnboard opciót:

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

Ha már saját maga kezeli a Node-ot, használhatja az npm-et, pnpm-et vagy bun-t is. npm 12 vagy npm 11.16 és újabb verziókkal futtassa:

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

npm 11.15 és korábbi verziók esetén távolítsa el a --allow-scripts=openclaw-t. Amikor pnpm-et használ, adja hozzá a --allow-build=openclaw-t. A pontos különbségekért tekintse meg a telepítési oldalt.

A telepítés után futtassa ezt a három parancsot sorrendben:

openclaw --version
openclaw doctor
openclaw gateway status

A openclaw --version megjeleníti a verziót, a openclaw doctor ellenőrzi a gyakori környezeti problémákat, a openclaw gateway status pedig megmutatja, hogy a Gateway fut-e. Az alapvető telepítés csak akkor fejeződik be, ha mindhárom parancs normál kimenetet ad.

Ha a terminál azt jelzi, hogy nem találja a openclaw-t, az npm globális bin könyvtára általában hiányzik a PATH-ból. A PATH azon helyek listája, ahol a terminál programokat keres. Hasonlítsa össze a node -v, npm prefix -g és echo "$PATH" kimenetét, adja hozzá a megfelelő bin könyvtárat a PATH-hoz, majd nyissa meg újra a terminált.

Ha a ~/.openclaw már tartalmaz egy jelenleg használt konfigurációt, az alapértelmezett telepítőszkript ezt a könyvtárat fogja használni. Egy külön példány telepítéséhez a meglévő konfiguráció megváltoztatása nélkül futtassa a nem interaktív szkriptet, és adjon meg egy új könyvtárat:

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

A --no-onboard a szkript alapértelmezett viselkedése. 2026-10-09-én ez a parancs telepítette az OpenClaw 2026.9.9-et. A telepítés után futtassa a openclaw végrehajtható fájlt a könyvtár bin mappájából.

Csatlakozási értékek beszerzése az OmniProxytól

Először győződjön meg arról, hogy az OmniProxy fut, majd nyissa meg a modelllistáját, és készítse elő a következő három értéket:

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

A baseUrl az a cím, amelyre az OpenClaw a modellkéréseket küldi, és a /v1-vel kell végződnie. Amikor az OmniProxyhoz csatlakozik, állítsa az api értékét openai-completions-re. Csak akkor változtassa meg openai-responses-re, ha a modell ténylegesen működik a /v1/responses-n keresztül.

A Modellazonosító a modell teljes azonosítója a listában. Másolja pontosan úgy, ahogy látható, beleértve a perjelt is. A következő két név csak a szolgáltatói dokumentációból származó hivatkozás 2026-10-09-től; ne használja őket, ha nem szerepelnek a listában: claude-sonnet-5-5, gpt-6-luna.

Még ha a gateway nem is érvényesíti a kulcsot, a apiKey-nek akkor is tartalmaznia kell egy értéket. Használhat egy helyőrző karakterláncot, amelyet csak ezen a számítógépen használ. Ne commitoljon valódi kulcsot tárolóba.

Az eszköz konfigurációjának megadása

A szolgáltató (Provider) olyan csatlakozási beállítások készleteként értelmezhető, amelyet az OpenClaw a modellszolgáltatás megkeresésére használ. Itt a szolgáltató neve omniproxy.

Futtassa a következő parancsot a terminálban, a címet, a kulcsot és a két modellazonosítót a saját értékeivel helyettesítve:

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

Ez a parancs beírja a szolgáltatót és a modelllistát a konfigurációba. A parancs sikeres végrehajtása után nem kell újraindítania a Gateway-t.

Ezután adja meg az alapértelmezett modellt. A modellhivatkozás a omniproxy/-ből és az azt követő modellazonosítóból áll. Őrizze meg az azonosítóban már meglévő összes perjelt. Ha a modelllistában szereplő azonosító hosszabb, mint az alábbi rövid név, használja a listában szereplő teljes értéket:

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

A reasoning, input, cost, contextWindow és maxTokens mind kihagyható. Ha nincsenek megadva, a szöveges modellek az alapértelmezettek használatával kerülnek kezelésre.

Ugyanezeket a beállításokat közvetlenül a konfigurációs fájlba is beírhatja. A fő konfigurációban a szolgáltató a models.providers alatt található. Minden ügynöknek (agent) lehet saját models.json-je; az ügynök egy asszisztens példány, amely ténylegesen fogadja a feladatokat és meghívja a modelleket. A fájl a agent/models.json-ban található a megfelelő ügynök könyvtárán belül, a ~/.openclaw/agents/ alatt.

Ha ez a models.json nem üres baseUrl-t tartalmaz, az felülbírálja a fő konfigurációban lévő címet.

Telepítés ellenőrzése

Három parancs

• openclaw --version
• openclaw doctor
• gateway status

Konfiguráció

models.providers

• A baseUrl /v1-re végződik
• Állítsa az api-t completions-re
• Adja meg legalább a modellazonosítót

Kiválasztás

szolgáltató/modell

• Használja ezt a hivatkozást az elsődlegeshez
• Részesítse előnyben a környezeti változót a kulcshoz
• Használja a gateway listáját igazságforrásként

Valódi feladat ellenőrzése

Lépjen be egy normál projektkönyvtárba, és küldjön egy nagyon rövid üzenetet. Cserélje le a parancsban szereplő modellhivatkozást a teljes modellazonosítójára:

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

A --local helyben futtatja ezt az ügynökfeladatot, a --model meghatározza a futtatáshoz használandó modellt, a --timeout 300 pedig 300 másodpercben állítja be a maximális várakozási időt.

A terminálban meg kell jelennie egy tényleges modellválasznak. 2026-10-09-én az OpenClaw 2026.9.9 ezzel a paranccsal kapott választ. Az első hívás egy-két percet is igénybe vehet.

Ha az eredeti Request timed out before a response was generated hiba jelenik meg, növelje a --timeout-t, és küldje el újra a kérést. Ez általában azt jelenti, hogy a várakozási idő nem volt elegendő, és nem feltétlenül jelzi, hogy a cím helytelen.

Miután a rövid válasz sikeres volt, kérje meg, hogy olvasson el egy Ön által megadott helyi fájlt. Ezután nyissa meg az OmniProxy kérésrekordjait, és erősítse meg a rekordban látható forrást és modellazonosítót. Csak a verzióparancs vagy a doctor kimenete nem jelenti azt, hogy a modellkapcsolat teljesen konfigurálva lett.

Telepítés

A parancs válaszol

• A verziószám megjelenik
• a doctor nem jelent blokkolókat
• A Gateway állapota olvasható

Feladat

Befejezett egy kis feladatot

• Például olvasson el egy helyi fájlt
• A válasz nem hiba
• A modellhivatkozás helyes

Naplók

Látható a gateway-ben

• A forrás OpenClaw
• A modellazonosító egyezik
• A kulcs nem lett hozzáadva az adattárhoz

Gyakori hibák

• Nem található a openclaw: Adja hozzá az npm globális bin könyvtárát a PATH-hoz, majd nyissa meg újra a terminált. Ha egy megadott könyvtárba telepítette, futtassa a végrehajtható fájlt a könyvtár bin mappájából.
• A node -v 24.16 alatt van: Nem kell először eltávolítania a régi verziót. Ellenőrizze a telepítőszkript által előkészített Node-verziót, vagy használja a 24.16+ vagy 26.1+ verziót a telepítési oldalon leírtak szerint. A Node 26 ajánlott.
• A modell nem jelenik meg: A modellnek szerepelnie kell a models tömbben a models.providers alatt, és legalább ugyanazzal a id-vel kell rendelkeznie. Csak a agents.defaults.models beállítása önmagában nem regisztrál új modellt.
• A 400-as válasz említi a fejlesztői szerepet: Amikor a cím gazdagépe nem api.openai.com, tartsa meg az alapértelmezettet, és ne állítsa a supportsDeveloperRole-t igazra. Még ha igazra is van állítva, akkor is felülbírálásra kerül.
• Gyorsan időtúllépést okoz: Növelje a --timeout-t 300 másodpercnél többre, mielőtt megváltoztatná a címet.
• Az eszközhívások meghiúsulnak a gpt-6-luna kiválasztása után: Támogatja a Chat Completions-t; a függvényhívás a Chat Completions-ben csak akkor támogatott, ha a reasoning_effort értéke none. Ha a listában szereplő azonosító eltér ettől, használja a listában látható azonosítót.
• A cím nem érhető el: Győződjön meg arról, hogy az OmniProxy fut, hogy a baseUrl a /v1-re végződik, és hogy a konfigurációba beírt cím elérhető. Más magánhálózati címeket külön kell engedélyezni.
• A kérések a konfiguráció után is másik címre mennek: Ellenőrizze, hogy az adott ügynök models.json-je tartalmaz-e eltérő baseUrl-t.

Hivatalos hivatkozások

A telepítési lépésekért lásd az OpenClaw telepítést. Az egyéni szolgáltatói konfigurációért lásd az Egyéni szolgáltatók és a konfigurációs mezők részt. A példákban használt modellazonosítókért hasonlítsa össze a Claude modell áttekintésével és a GPT-6 Luna oldallal.

Helyettesítse az összes helykitöltőt a saját OmniProxy-konfigurációjából származó értékekkel. Soha ne publikáljon valódi kulcsot.

Egy mentett eredmény vagy HTTP 200 önmagában nem bizonyítja a teljes ügynök kompatibilitást. Ellenőrizze a forrást és a modellt az OmniProxy hívásnaplójában.

Hivatalos források · OpenClaw ↗