Przejdź do głównej treści

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
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. 
curl -fsSL https://openclaw.ai/install.sh | bash
Aby zainstalować bez uruchamiania onboardingu: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
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: 
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 install -g openclaw@latest
openclaw onboard --install-daemon
Jeśli sharp nie działa z powodu globalnie zainstalowanego libvips:
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: 
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw 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

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

openclaw --version      # confirm the CLI is available
openclaw doctor         # check for config issues
openclaw 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

Dowolny VPS z Linux

Docker VM

Wspólne kroki Docker

Kubernetes

K8s

Fly.io

Fly.io

Hetzner

Hetzner

GCP

Google Cloud

Azure

Azure

Railway

Railway

Render

Render

Northflank

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: 
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): 
export PATH="$(npm prefix -g)/bin:$PATH"
Następnie otwórz nowy terminal. Więcej szczegółów znajdziesz w sekcji Konfiguracja Node.