English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Install overview

Instalacja

Edit source

Wymagania systemowe

  • Node 24 (zalecane) lub Node 22.16+ - skrypt instalatora obsługuje to automatycznie
  • macOS, Linux lub Windows - obsługiwane są zarówno natywny Windows, jak i WSL2; WSL2 jest stabilniejszy. Zobacz Windows.
  • pnpm jest potrzebny tylko wtedy, gdy budujesz ze źródeł

Zalecane: skrypt instalatora

Najszybszy sposób instalacji. Wykrywa system operacyjny, instaluje Node w razie potrzeby, instaluje OpenClaw i uruchamia onboarding.

macOS / Linux / WSL2

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

Windows (PowerShell)

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

Aby zainstalować bez uruchamiania onboardingu:

macOS / Linux / WSL2

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

Windows (PowerShell)

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

Wszystkie flagi oraz opcje CI/automatyzacji znajdziesz w sekcji Wewnętrzne działanie instalatora.

Alternatywne metody instalacji

Instalator z lokalnym prefiksem (install-cli.sh)

Użyj tego, gdy chcesz, aby OpenClaw i Node były przechowywane pod lokalnym prefiksem, takim jak ~/.openclaw, bez zależności od systemowej instalacji Node:

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

Domyślnie obsługuje instalacje npm, a także instalacje z git checkout w ramach tego samego przepływu z prefiksem. Pełna dokumentacja: Wewnętrzne działanie instalatora.

Masz już instalację? Przełączaj się między instalacjami z pakietu i z git za pomocą openclaw update --channel dev oraz openclaw update --channel stable. Zobacz Aktualizacja.

npm, pnpm lub bun

Jeśli samodzielnie zarządzasz już Node:

npm

bash
npm install -g openclaw@latestopenclaw onboard --install-daemon

pnpm

bash
pnpm add -g openclaw@latestpnpm approve-builds -gopenclaw onboard --install-daemon

bun

bash
bun add -g openclaw@latestopenclaw onboard --install-daemon
Troubleshooting: sharp build errors (npm)

Jeśli sharp nie działa z powodu globalnie zainstalowanego libvips:

bash
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

Ze źródeł

Dla kontrybutorów lub każdego, kto chce uruchamiać z lokalnego checkoutu:

bash
git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm install && pnpm build && pnpm ui:buildpnpm link --globalopenclaw onboard --install-daemon

Możesz też pominąć linkowanie i używać pnpm openclaw ... z wnętrza repozytorium. Zobacz Konfiguracja, aby poznać pełne przepływy pracy deweloperskiej.

Instalacja z GitHub main

bash
npm install -g github:openclaw/openclaw#main

Kontenery i menedżery pakietów

Docker

Wdrożenia w kontenerach lub bez interfejsu graficznego.
Podman

Bezrootowa alternatywa kontenerowa dla Docker.
Nix

Deklaratywna instalacja przez Nix flake.
Ansible

Automatyczne wdrażanie floty.
Bun

Użycie wyłącznie CLI przez środowisko uruchomieniowe Bun.

Weryfikacja instalacji

bash
openclaw --version      # confirm the CLI is availableopenclaw doctor         # check for config issuesopenclaw gateway status # verify the Gateway is running

Jeśli po instalacji chcesz mieć zarządzane uruchamianie:

  • macOS: LaunchAgent przez openclaw onboard --install-daemon lub openclaw gateway install
  • Linux/WSL2: usługa użytkownika systemd przez te same polecenia
  • Natywny Windows: najpierw Zaplanowane zadanie, z awaryjną pozycją logowania w folderze Autostart dla danego użytkownika, jeśli utworzenie zadania zostanie odrzucone

Hosting i wdrażanie

Wdróż OpenClaw na serwerze w chmurze lub VPS:

VPS
Docker VM
Kubernetes

OPENCLAW_DOCS_MARKER:cardOpen:IHRpdGxlPSJGbHkuaW8iIGhyZWY9Ii9wbC9pbnN0YWxsL2ZseSI Fly.io OPENCLAW_DOCS_MARKER:cardClose:

Hetzner
GCP
Azure
Railway
Render
Northflank

Aktualizacja, migracja lub odinstalowanie

Updating

Utrzymuj OpenClaw na bieżąco.
Migrating

Przenieś na nową maszynę.
Uninstall

Całkowicie usuń OpenClaw.

Rozwiązywanie problemów: nie znaleziono openclaw

Jeśli instalacja się powiodła, ale openclaw nie jest znajdowany w terminalu:

bash
node -v           # Node installed?npm prefix -g     # Where are global packages?echo "$PATH"      # Is the global bin dir in PATH?

Jeśli $(npm prefix -g)/bin nie znajduje się w Twoim $PATH, dodaj go do pliku startowego powłoki (~/.zshrc lub ~/.bashrc):

bash
export PATH="$(npm prefix -g)/bin:$PATH"

Następnie otwórz nowy terminal. Więcej szczegółów znajdziesz w sekcji Konfiguracja Node.

Was this useful?