Dotyczy OpenClaw v2026.2 | Artykuł zakłada posiadanie środowiska Node.js >= 22 oraz klucza API AI (zalecany Anthropic Claude).

TL;DR: Instalacja OpenClaw w 5 minut. Obsługuje cztery metody: npm/pnpm/bun/Docker, zalecane: npm install -g openclaw@latest && openclaw onboard. Plik konfiguracyjny znajduje się w ~/.openclaw/openclaw.json, uruchomienie przez openclaw gateway. Szczegółowo omówione: wdrożenie Docker, struktura pliku konfiguracyjnego, rozwiązywanie typowych problemów.

Wymagania wstępne

Wymagane środowisko

Zalecane środowisko

Klucz API AI

OpenClaw wymaga połączenia z modelem AI, aby działać. Zalecane:

💡 Zalecenie: Anthropic Claude Opus 4.6 oferuje najlepsze przetwarzanie długiego kontekstu i ochronę przed prompt injection.

Weryfikacja środowiska

# Sprawdzenie wersji Node.js
node --version
# Przykładowy wynik: v22.12.0

# Sprawdzenie wersji npm
npm --version
# Przykładowy wynik: 10.9.0

# Sprawdzenie informacji o systemie
uname -a  # Linux/macOS
# lub
systeminfo | findstr /B /C:"OS Name" /C:"OS Version"  # Windows

Porównanie metod instalacji

flowchart TB
    A[Wybór metody instalacji] --> B{Scenariusz użycia?}
    B -->|Szybki test| C[npm instalacja globalna]
    B -->|Codzienne użycie| D[pnpm/bun instalacja]
    B -->|Wdrożenie produkcyjne| E[Docker]
    B -->|Wkład w rozwój| F[Kompilacja ze źródeł]
    
    C --> G[5 minut]
    D --> H[Szybsze zarządzanie zależnościami]
    E --> I[Izolacja środowiska, reprodukowalność]
    F --> J[Pełna personalizacja, udział w rozwoju]

Tabela porównawcza metod

Metoda 1: Globalna instalacja npm (zalecana dla początkujących)

Kroki instalacji

# 1. Instalacja najnowszej stabilnej wersji
npm install -g openclaw@latest

# 2. Weryfikacja instalacji
openclaw --version
# Przykładowy wynik: 2026.2.26

# 3. Wyświetlenie pomocy
openclaw --help

Struktura katalogów po instalacji

/usr/local/lib/node_modules/openclaw/  # Katalog globalnej instalacji
├── bin/
│   └── openclaw                        # Plik wykonywalny
├── lib/
│   └── ...                             # Pliki bibliotek
└── package.json

~/.openclaw/                            # Katalog danych użytkownika (tworzony przy pierwszym uruchomieniu)
├── openclaw.json                       # Główny plik konfiguracyjny
├── credentials/                       # Magazyn poświadczeń kanałów
├── workspace/                          # Przestrzeń robocza agenta
│   ├── AGENTS.md                      # Wytyczne zachowania agenta
│   ├── SOUL.md                        # Osobowość agenta
│   └── skills/                        # Własne umiejętności
└── logs/                              # Katalog logów

Uruchomienie kreatora

# Uruchomienie interaktywnego kreatora konfiguracji
openclaw onboard --install-daemon

Kreator przeprowadzi Cię przez:

sequenceDiagram
    participant U as Użytkownik
    participant W as Kreator
    participant S as System
    
    U->>W: Uruchomienie onboard
    W->>U: Wybór dostawcy modelu
    U->>W: Wybór Anthropic
    W->>U: Wprowadzenie klucza API
    U->>W: Wklejenie klucza
    W->>U: Wybór portu Gateway
    U->>W: 18789 (domyślny)
    W->>U: Czy zainstalować demona?
    U->>W: Tak
    W->>S: Utworzenie usługi systemd/launchd
    S-->>W: Instalacja zakończona
    W-->>U: Konfiguracja ukończona!

Metoda 2: Instalacja pnpm (zalecana na co dzień)

Instalacja pnpm

# Instalacja pnpm przez npm
npm install -g pnpm

# Lub za pomocą niezależnego skryptu
curl -fsSL https://get.pnpm.io/install.sh | sh -

Instalacja OpenClaw

# Instalacja przez pnpm
pnpm add -g openclaw@latest

# Weryfikacja
openclaw --version

Zalety pnpm

Metoda 3: Instalacja bun (maksymalna szybkość)

Instalacja bun

# macOS/Linux
curl -fsSL https://bun.sh/install | bash

# Lub za pomocą npm
npm install -g bun

Instalacja OpenClaw

# Instalacja przez bun
bun add -g openclaw@latest

# Weryfikacja
openclaw --version

Zalety bun

Metoda 4: Wdrożenie Docker (zalecane na produkcję)

Pobranie obrazu

# Pobranie najnowszego obrazu
docker pull openclaw/openclaw:latest

# Lub konkretna wersja
docker pull openclaw/openclaw:2026.2

Podstawowe uruchomienie

# Minimalne uruchomienie
docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  -e ANTHROPIC_API_KEY=your_key_here \
  openclaw/openclaw:latest

# Podgląd logów
docker logs -f openclaw

Konfiguracja Docker Compose

Utwórz docker-compose.yml:

version: '3.8'

services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "18789:18789"
    volumes:
      - ./openclaw-data:/root/.openclaw
    environment:
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
      # Lub użyj pliku konfiguracyjnego
      # - OPENCLAW_CONFIG=/root/.openclaw/openclaw.json
    healthcheck:
      test: ["CMD", "openclaw", "health"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s

Uruchomienie usługi:

# Utworzenie pliku .env
echo "ANTHROPIC_API_KEY=your_key_here" > .env

# Uruchomienie
docker-compose up -d

# Sprawdzenie statusu
docker-compose ps

# Podgląd logów
docker-compose logs -f

Konfiguracja sieci Docker

# Rozszerzenie docker-compose.yml
services:
  openclaw:
    # ... pozostała konfiguracja
    networks:
      - openclaw-net

  # Opcjonalnie: reverse proxy
  caddy:
    image: caddy:latest
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
    networks:
      - openclaw-net

networks:
  openclaw-net:
    driver: bridge

Metoda 5: Kompilacja ze źródeł (dla deweloperów)

Klonowanie repozytorium

# Klonowanie głównego repozytorium
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# Instalacja zależności (zalecane pnpm)
pnpm install

# Kompilacja
pnpm build

# Uruchomienie
pnpm openclaw onboard

Tryb deweloperski

# Tryb deweloperski (automatyczne przeładowanie)
pnpm gateway:watch

# Uruchomienie testów
pnpm test

# Sprawdzanie kodu
pnpm lint

Szczegółowy opis pliku konfiguracyjnego

Priorytet konfiguracji

Parametry CLI > Zmienne środowiskowe > Plik konfiguracyjny > Wartości domyślne

Struktura katalogów

~/.openclaw/
├── openclaw.json           # Główny plik konfiguracyjny
├── openclaw.json.backup    # Automatyczna kopia zapasowa
├── credentials/            # Poufne poświadczenia (automatycznie szyfrowane)
│   ├── telegram.json
│   ├── whatsapp.json
│   └── discord.json
├── workspace/              # Przestrzeń robocza agenta
│   ├── AGENTS.md          # Globalne wytyczne zachowania
│   ├── SOUL.md            # Osobowość agenta
│   ├── TOOLS.md           # Opis własnych narzędzi
│   ├── USER.md            # Informacje o użytkowniku
│   └── skills/            # Katalog umiejętności
│       ├── gmail/
│       │   └── SKILL.md
│       └── calendar/
│           └── SKILL.md
├── sessions/              # Dane sesji
├── logs/                  # Pliki logów
│   ├── gateway.log
│   └── agent.log
└── cache/                 # Dane cache

Minimalna konfiguracja

~/.openclaw/openclaw.json:

{
  "agent": {
    "model": "anthropic/claude-opus-4-6"
  }
}

Pełny przykład konfiguracji

{
  "agent": {
    "model": "anthropic/claude-opus-4-6",
    "thinkingLevel": "high",
    "verboseLevel": "normal"
  },
  "gateway": {
    "port": 18789,
    "bind": "loopback",
    "host": "127.0.0.1"
  },
  "channels": {
    "telegram": {
      "botToken": "YOUR_BOT_TOKEN",
      "dmPolicy": "pairing",
      "allowFrom": []
    },
    "whatsapp": {
      "allowFrom": ["+8613800138000"],
      "groups": {
        "*": { "requireMention": true }
      }
    },
    "discord": {
      "token": "YOUR_DISCORD_TOKEN",
      "guilds": {}
    }
  },
  "agents": {
    "defaults": {
      "workspace": "~/.openclaw/workspace",
      "sandbox": {
        "mode": "off"
      }
    }
  },
  "models": {
    "fallback": [
      {
        "model": "anthropic/claude-sonnet-4",
        "condition": "rate_limit"
      }
    ]
  },
  "webhooks": [],
  "cron": []
}

Opis ustawień konfiguracyjnych

Zmienne środowiskowe

OpenClaw obsługuje nadpisywanie konfiguracji za pomocą zmiennych środowiskowych:

# Klucze API
export ANTHROPIC_API_KEY="sk-ant-..."
export OPENAI_API_KEY="sk-..."

# Konfiguracja kanałów
export TELEGRAM_BOT_TOKEN="123456:ABC..."
export DISCORD_BOT_TOKEN="..."

# Konfiguracja Gateway
export OPENCLAW_PORT=18789
export OPENCLAW_BIND="loopback"

Uruchamianie i weryfikacja

Uruchomienie Gateway

# Uruchomienie na pierwszym planie (tryb debugowania)
openclaw gateway --verbose

# Uruchomienie w tle (demon)
openclaw gateway --daemon

# Określenie portu
openclaw gateway --port 18790

Weryfikacja stanu

# Sprawdzenie stanu zdrowia
openclaw doctor

# Przykładowy wynik:
# ✓ Node.js version: v22.12.0
# ✓ OpenClaw version: 2026.2.26
# ✓ Gateway running on port 18789
# ✓ API key configured
# ✓ Workspace directory exists

Dostęp do konsoli webowej

Po uruchomieniu Gateway otwórz przeglądarkę:

http://127.0.0.1:18789

Zobaczysz Web Control UI:

Test rozmowy

# Test z wiersza poleceń
openclaw agent --message "Cześć, przedstaw się"

# Przykładowy wynik:
# Cześć! Jestem Twoim asystentem OpenClaw. Mogę pomóc Ci...

Rozwiązywanie typowych problemów

Problem 1: Port jest zajęty

Objawy:

Error: EADDRINUSE: address already in use 127.0.0.1:18789

Rozwiązanie:

# Znalezienie procesu zajmującego port
lsof -i :18789
# lub
netstat -tlnp | grep 18789

# Zakończenie procesu
kill -9 <PID>

# Lub użyj innego portu
openclaw gateway --port 18790

Problem 2: Nieprawidłowy klucz API

Objawy:

Error: Invalid API key

Rozwiązanie:

# Weryfikacja konfiguracji
openclaw config get agent.model

# Sprawdzenie zmiennej środowiskowej
echo $ANTHROPIC_API_KEY

# Ponowna konfiguracja
openclaw onboard

Problem 3: Za niska wersja Node

Objawy:

Error: OpenClaw requires Node.js >= 22.0.0

Rozwiązanie:

# Zmiana wersji za pomocą nvm
nvm install 22
nvm use 22
nvm alias default 22

# Weryfikacja
node --version

Problem 4: Problem z uprawnieniami

Objawy:

Error: EACCES: permission denied

Rozwiązanie:

# Naprawa uprawnień npm
sudo chown -R $(whoami) ~/.npm
sudo chown -R $(whoami) ~/.openclaw

# Lub zarządzaj Node.js przez nvm (zalecane)

Problem 5: Problem z siecią Docker

Objawy:

Error: Cannot connect to Gateway from container

Rozwiązanie:

# Sprawdzenie sieci
docker network ls
docker network inspect bridge

# Użycie sieci hosta
docker run --network host ...

# Lub prawidłowe mapowanie portów
docker run -p 127.0.0.1:18789:18789 ...

Problem 6: Utracone poświadczenia

Objawy:

Warning: Telegram credentials not found

Rozwiązanie:

# Ponowne logowanie do kanału
openclaw channels login telegram

# Sprawdzenie plików poświadczeń
ls ~/.openclaw/credentials/

# Kopia zapasowa poświadczeń
cp -r ~/.openclaw/credentials/ ~/.openclaw/credentials.backup/

Problem 7: Brak pamięci

Objawy:

Error: JavaScript heap out of memory

Rozwiązanie:

# Zwiększenie limitu pamięci Node.js
export NODE_OPTIONS="--max-old-space-size=8192"
openclaw gateway

# Lub w Dockerze
docker run -e NODE_OPTIONS="--max-old-space-size=8192" ...

Aktualizacja i konserwacja

Aktualizacja OpenClaw

# Aktualizacja npm
npm update -g openclaw@latest

# Aktualizacja pnpm
pnpm update -g openclaw@latest

# Aktualizacja Docker
docker pull openclaw/openclaw:latest
docker-compose up -d

# Sprawdzenie wersji
openclaw --version

Zmiana kanału wydań

# Wersja stabilna (zalecana)
openclaw update --channel stable

# Wersja beta
openclaw update --channel beta

# Wersja deweloperska (najnowsze funkcje, może być niestabilna)
openclaw update --channel dev

Kopia zapasowa i przywracanie

# Kopia zapasowa konfiguracji
tar -czvf openclaw-backup-$(date +%Y%m%d).tar.gz ~/.openclaw/

# Przywracanie konfiguracji
tar -xzvf openclaw-backup-20260226.tar.gz -C ~/

# Kopia zapasowa tylko kluczowych plików
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup
cp -r ~/.openclaw/credentials/ ~/.openclaw/credentials.backup/

Następne kroki

Gratulacje! Środowisko OpenClaw jest już gotowe. Dalej:

1. Skonfiguruj pierwszy kanał → Następny artykuł: Konfiguracja kanałów
2. Zainstaluj pierwszą umiejętność → Wyszukaj i zainstaluj w Web UI
3. Dostosuj osobowość agenta → Edytuj ~/.openclaw/workspace/SOUL.md

Podsumowanie artykułu:

• Poznałeś 5 metod instalacji i ich zastosowania
• Zrozumiałeś strukturę pliku konfiguracyjnego i priorytety
• Nauczyłeś się weryfikacji uruchomienia i rozwiązywania typowych problemów
• Poznałeś podstawowe operacje aktualizacji i konserwacji

Historia zmian:

• 2026-02-26: Pierwsza wersja, na podstawie OpenClaw v2026.2

Nawigacja po serii:

• ← Poprzedni artykuł: Wprowadzenie do OpenClaw
• → Następny artykuł: Konfiguracja kanałów: zaczynamy od Telegrama