OpenClaw Guide: Build Your AI Assistant
Samouczek krok po kroku, jak zainstalować, skonfigurować i używać OpenClaw (dawniej Moltbot/Clawdbot) – wiralowego asystenta AI o otwartym kodzie źródłowym z ponad 135 tys. gwiazdek na GitHub. Połącz się z WhatsApp, Telegramem, Discordem i zautomatyzuj swoje życie.
TL;DR
- OpenClaw to asystent AI open-source z ponad 135 tys. gwiazdek na GitHub
- Działa lokalnie na Twojej maszynie — Twoje dane pozostają prywatne
- Możliwość połączenia przez WhatsApp, Telegram, Discord, Slack, iMessage i inne
- Ponad 3000 umiejętności społeczności do automatyzacji, programowania, inteligentnego domu i nie tylko
- Bezpłatny (płacisz tylko za tokeny API AI, zazwyczaj 10-50 USD miesięcznie)
- Konfiguracja zajmuje około 30 minut z tym przewodnikiem
Czym jest OpenClaw?
OpenClaw (dawniej znany jako Clawdbot, a następnie Moltbot) to najgorętszy projekt AI o otwartym kodzie źródłowym w 2026 roku. Jest to osobisty asystent AI, który:
- Działa na Twoim własnym komputerze lub serwerze
- Łączy się z Twoimi ulubionymi komunikatorami (WhatsApp, Telegram, Discord itp.)
- Ma pełny dostęp do Twojego systemu plików, terminala i przeglądarki
- Potrafi automatyzować zadania niczym osobisty asystent na sterydach
Historia: Clawdbot → Moltbot → OpenClaw
Projekt przeszedł sporą przygodę z nazewnictwem:
| Data | Nazwa | Powód |
|---|---|---|
| Listopad 2025 | Clawdbot | Oryginalna nazwa twórcy, Petera Steinbergera |
| Grudzień 2025 | Moltbot | Zmiana nazwy po wniosku Anthropic o ochronę znaku towarowego |
| Styczeń 2026 | OpenClaw | Społecznościowy rebranding w celu uzyskania niezależności |
Niezależnie od tego, jak go nazwiesz, funkcjonalność pozostaje taka sama — to niezwykle potężny asystent AI działający lokalnie.
Dlaczego OpenClaw?
vs. ChatGPT / Claude Web
| Funkcja | ChatGPT/Claude | OpenClaw |
|---|---|---|
| Działa lokalnie | ❌ | ✅ |
| Dostęp do Twoich plików | ❌ | ✅ |
| Uruchamianie poleceń terminala | ❌ | ✅ |
| Sterowanie komputerem | ❌ | ✅ |
| Działa w WhatsApp | ❌ | ✅ |
| Prywatność danych | W chmurze | 100% lokalnie |
| Rozszerzalny o umiejętności | Ograniczony | 3000+ umiejętności |
vs. Inne agenty AI
Kluczowe funkcje OpenClaw:
- Wielokanałowa skrzynka odbiorcza: Jedno AI dostępne z poziomu WhatsApp, Telegram, Discord, Slack, iMessage i ponad 12 innych platform
- Trwała pamięć: Pamięta kontekst między rozmowami
- Ekosystem umiejętności: Ponad 3000 wtyczek społecznościowych dostępnych przez ClawHub
- Agnostyczny modelowo: Współpracuje z Claude, GPT, Gemini, DeepSeek, lokalnymi modelami Ollama itp.
- Open source: Licencja MIT, w pełni audytowalny kod
Wymagania wstępne
Zanim zaczniemy, upewnij się, że posiadasz:
- [ ] Komputer (Mac, Windows z WSL2 lub Linux)
- [ ] Zainstalowany Node.js v22+ (pobierz tutaj)
- [ ] Klucz API AI (Anthropic Claude, OpenAI lub inne)
- [ ] Około 30 minut wolnego czasu
Wymagania sprzętowe
| Konfiguracja | RAM | Miejsce na dysku | Uwagi |
|---|---|---|---|
| Minimum | 4GB | 1GB | Podstawowa funkcjonalność |
| Zalecane | 8GB+ | 2GB+ | Płynne działanie |
| Z lokalnymi modelami | 16GB+ | 50GB+ | Do uruchamiania Ollama |
Metody instalacji
Metoda 1: Instalacja jednym poleceniem (Zalecana)
Najszybszy sposób na rozpoczęcie:
curl -fsSL https://openclaw.bot/install.sh | bash
Ten skrypt:
- Sprawdzi wymagania systemowe
- Zainstaluje OpenClaw
- Uruchomi kreatora konfiguracji (onboarding wizard)
Metoda 2: Docker (Zalecana dla serwerów)
Jeśli preferujesz wdrożenie kontenerowe:
# Sklonuj repozytorium
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# Uruchom konfigurację Docker
./docker-setup.sh
Konfiguracja Docker tworzy dwa ważne katalogi:
~/.openclaw/— Konfiguracja, pamięć, klucze API~/openclaw/workspace/— Pliki dostępne dla agenta AI
Metoda 3: Budowanie ze źródeł
Dla programistów chcących pełnej kontroli:
# Sklonuj repozytorium
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# Zainstaluj zależności
pnpm install
# Zbuduj interfejs użytkownika
pnpm ui:build
# Zbuduj projekt
pnpm build
# Uruchom konfigurację
pnpm openclaw onboard --install-daemon
Konfiguracja krok po kroku
Krok 1: Uruchom kreatora konfiguracji (Onboarding Wizard)
Po instalacji kreator uruchomi się automatycznie. Jeśli tak się nie stanie, uruchom:
openclaw onboard --install-daemon
Kreator przeprowadzi Cię przez:
- Wybór dostawcy modelu
- Konfigurację klucza API
- Konfigurację platform komunikacyjnych
- Ustawienia bezpieczeństwa
Krok 2: Skonfiguruj swój model AI
OpenClaw obsługuje wielu dostawców AI. Wybierz jednego:
Opcja A: Anthropic Claude (Zalecane)
# Ustaw swój klucz API
export ANTHROPIC_API_KEY=sk-ant-xxxxx
# Lub użyj polecenia config
openclaw config set 'models.default' 'claude-sonnet-4'
Opcja B: OpenAI
export OPENAI_API_KEY=sk-xxxxx
openclaw config set 'models.default' 'gpt-4o'
Opcja C: DeepSeek (Opcja budżetowa)
openclaw config set 'models.providers.deepseek' --json '{
"baseUrl": "https://api.deepseek.com/v1",
"apiKey": "your-api-key",
"api": "openai-completions",
"models": [
{ "id": "deepseek-chat", "name": "DeepSeek Chat" },
{ "id": "deepseek-reasoner", "name": "DeepSeek Reasoner" }
]
}'
Opcja D: Lokalne modele z Ollama
Dla pełnej prywatności uruchamiaj modele lokalnie:
# Najpierw zainstaluj Ollama: https://ollama.ai
ollama pull llama3.3
# Skonfiguruj OpenClaw do korzystania z niego
openclaw config set 'models.providers.ollama' --json '{
"baseUrl": "http://localhost:11434/v1",
"api": "openai-completions",
"models": [
{ "id": "llama3.3", "name": "Llama 3.3" }
]
}'
Krok 3: Połącz platformy komunikacyjne
To tutaj OpenClaw pokazuje swoją siłę — rozmawiaj ze swoim AI z dowolnego miejsca.
Telegram (Najprostszy)
- Wyślij wiadomość do @BotFather na Telegramie
- Wyślij
/newboti postępuj zgodnie z instrukcjami - Skopiuj token swojego bota
- Skonfiguruj OpenClaw:
openclaw config set 'channels.telegram.token' 'TWÓJ_TOKEN_BOTA'
openclaw config set 'channels.telegram.allowlist' '["twoja_nazwa_uzytkownika_telegram"]'
OpenClaw używa WhatsApp Web do połączenia:
# Włącz kanał WhatsApp
openclaw config set 'channels.whatsapp.enabled' true
# Zrestartuj bramę (gateway)
openclaw gateway restart
# Zeskanuj kod QR, który się pojawi
W Twoim terminalu pojawi się kod QR. Zeskanuj go za pomocą WhatsApp na telefonie (Ustawienia → Powiązane urządzenia → Powiąż urządzenie).
Discord
- Utwórz aplikację Discord na discord.com/developers
- Utwórz bota i skopiuj token
- Skonfiguruj:
openclaw config set 'channels.discord.token' 'TWÓJ_TOKEN_BOTA'
openclaw config set 'channels.discord.allowlist' '["twój_id_użytkownika_discord"]'
iMessage (Tylko Mac)
Dla użytkowników Mac, OpenClaw może połączyć się bezpośrednio z iMessage:
openclaw config set 'channels.imessage.enabled' true
Krok 4: Uruchom bramę (Gateway)
Gateway to usługa działająca w tle, która utrzymuje aktywność OpenClaw:
# Uruchom jako demon (usługa w tle)
openclaw gateway start
# Lub uruchom w konsoli w celu debugowania
openclaw gateway
# Sprawdź status
openclaw gateway status
# Wyświetl logi
openclaw logs --follow
Krok 5: Dostęp do panelu webowego (Dashboard)
OpenClaw zawiera interfejs webowy do konfiguracji i bezpośredniego czatu:
# Otwórz panel w przeglądarce
openclaw dashboard
To otworzy adres http://127.0.0.1:18789/ z tymczasowym tokenem logowania.
Z poziomu panelu możesz:
- Rozmawiać bezpośrednio ze swoim AI
- Zarządzać ustawieniami
- Przeglądać historię rozmów
- Instalować umiejętności
Twoja pierwsza rozmowa
Gdy wszystko zostanie skonfigurowane, wyślij wiadomość do swojego bota (przez Telegram, WhatsApp lub interfejs webowy):
Cześć! Możesz mi powiedzieć, co potrafisz?
OpenClaw przedstawi siebie i swoje możliwości. Wypróbuj kilka konkretnych zadań:
Jakie pliki znajdują się w moim folderze Pobrane?
Przeszukaj moje dokumenty pod kątem wszystkiego związanego z "podatki 2025"
Stwórz skrypt w Pythonie, który konwertuje CSV na JSON
Co zajmuje najwięcej miejsca na dysku mojego komputera?
Instalowanie umiejętności (Skills)
Umiejętności rozszerzają możliwości OpenClaw. Przeglądaj rejestr ClawHub lub instaluj bezpośrednio:
Popularne umiejętności
# Integracja z GitHub
openclaw skill install github
# Automatyzacja przeglądarki internetowej
openclaw skill install agent-browser
# Zarządzanie kalendarzem
openclaw skill install calendar
# Automatyzacja e-mail
openclaw skill install email
# Sterowanie inteligentnym domem
openclaw skill install homeassistant
# Generowanie obrazów
openclaw skill install dalle
# Rozmowy głosowe (Discord)
openclaw skill install discord-voice
Kategorie umiejętności
| Kategoria | Popularne umiejętności | Zastosowania |
|---|---|---|
| Programowanie | github, gitlab, jira, linear | Recenzje PR, zarządzanie zgłoszeniami |
| Produktywność | calendar, email, notion, todoist | Harmonogramowanie, zarządzanie zadaniami |
| Automatyzacja | agent-browser, puppeteer, selenium | Scraping stron, wypełnianie formularzy |
| Inteligentny dom | homeassistant, philips-hue, tuya | Sterowanie oświetleniem, sceny |
| Finanse | crypto-prices, stock-tracker | Monitorowanie portfela |
| Multimedia | spotify, youtube-dl, plex | Sterowanie muzyką, pobieranie |
Ostrzeżenie dotyczące bezpieczeństwa
⚠️ Ważne: Sprawdź umiejętności przed ich instalacją. Otwarty charakter ClawHub oznacza, że mogą istnieć złośliwe umiejętności. Użyj openclaw skill inspect , aby przejrzeć kod, lub poproś Claude Code / Codex o jego audyt.
Zaawansowana konfiguracja
Struktura pliku konfiguracyjnego
OpenClaw przechowuje konfigurację w ~/.openclaw/:
~/.openclaw/
├── openclaw.json # Główna konfiguracja
├── env # Zmienne środowiskowe (klucze API)
├── memory/ # Trwałe przechowywanie pamięci
├── skills/ # Zainstalowane umiejętności
├── backups/ # Kopie zapasowe konfiguracji
└── logs/ # Pliki logów
Edycja konfiguracji
# Wyświetl aktualną konfigurację
openclaw config get
# Ustaw wartość
openclaw config set 'sciezka.klucza' 'wartosc'
# Edytuj w domyślnym edytorze
openclaw config edit
Zarządzanie pamięcią
OpenClaw utrzymuje trwałą pamięć między rozmowami:
# Wyświetl statystyki pamięci
openclaw memory stats
# Wyczyść całą pamięć (ostrożnie!)
openclaw memory clear
# Eksportuj pamięć do kopii zapasowej
openclaw memory export > memory-backup.json
Uruchamianie testów poprawności (Health Checks)
# Kompleksowy test poprawności
openclaw doctor
# Sprawdź konkretne komponenty
openclaw doctor --check api
openclaw doctor --check channels
openclaw doctor --check skills
Najlepsze praktyki bezpieczeństwa
OpenClaw ma pełny dostęp do systemu — to właśnie czyni go potężnym, ale i ryzykownym. Postępuj zgodnie z poniższymi wytycznymi:
1. Używaj dedykowanej maszyny
Nie uruchamiaj OpenClaw na swoim głównym komputerze służbowym. Opcje:
- VPS: DigitalOcean, Vultr, AWS (5-20 USD/miesiąc)
- Stary laptop: Wykorzystaj stary sprzęt
- Raspberry Pi: Sprawdza się przy lekkim użytkowaniu
- Docker: Zapewnia pewną izolację
2. Włącz tryb piaskownicy (Sandbox Mode)
Dla niezaufanych sesji (czaty grupowe, kanały):
openclaw config set 'agents.defaults.sandbox.mode' 'non-main'
To spowoduje uruchamianie sesji grupowych/kanałowych wewnątrz piaskownic Docker.
3. Używaj list dozwolonych (Allowlists)
Pozwalaj na interakcję z botem tylko określonym użytkownikom:
# Telegram
openclaw config set 'channels.telegram.allowlist' '["uzytkownik1", "uzytkownik2"]'
# Discord
openclaw config set 'channels.discord.allowlist' '["id_uzytkownika_1", "id_uzytkownika_2"]'
4. Aktualizuj na bieżąco
W starszych wersjach znaleziono luki bezpieczeństwa. Zawsze korzystaj z najnowszej wersji:
# Sprawdź aktualizacje
openclaw update --check
# Zaktualizuj do najnowszej wersji
openclaw update
Uwaga: Wersje sprzed 29.01.2026 mają znaną lukę bezpieczeństwa. Jeśli korzystasz ze starszej wersji, zaktualizuj ją natychmiast.
5. Audytuj umiejętności przed instalacją
# Sprawdź kod umiejętności
openclaw skill inspect <nazwa-umiejętności>
# Sprawdź reputację umiejętności
openclaw skill info <nazwa-umiejętności>
Przykłady automatyzacji
Tutaj OpenClaw staje się naprawdę potężny:
Poranny brief (Morning Briefing)
Skonfiguruj codzienne podsumowanie o 8:00 rano:
# W swojej konfiguracji dodaj zadanie cron
openclaw config set 'automations.morning-briefing' --json '{
"cron": "0 8 * * *",
"action": "Wyślij mi podsumowanie: prognoza pogody, dzisiejsze wydarzenia w kalendarzu, nieprzeczytane ważne e-maile i 3 najważniejsze nagłówki wiadomości"
}'
Bot do recenzji GitHub PR
Automatycznie recenzuj PR-y, gdy zostaniesz do nich przypisany:
openclaw skill install github
# Skonfiguruj webhook lub odpytywanie
openclaw config set 'automations.pr-review' --json '{
"trigger": "github.pr.assigned",
"action": "Przejrzyj PR, sprawdź pod kątem błędów, problemów z bezpieczeństwem i naruszeń stylu. Opublikuj komentarz z podsumowaniem."
}'
Sceny inteligentnego domu
openclaw skill install homeassistant
# Automatyzacja "Wyjście z domu"
openclaw config set 'automations.leaving-home' --json '{
"trigger": "location.leave_home",
"action": "Wyłącz wszystkie światła, ustaw termostat w tryb eco, uzbrój system bezpieczeństwa"
}'
Organizacja plików
Powiedz OpenClaw, aby uporządkował Twój folder Pobrane:
Uporządkuj mój folder Pobrane: przenieś obrazy do ~/Pictures, dokumenty do ~/Documents i usuń wszystko starsze niż 30 dni
Rozwiązywanie problemów
Typowe problemy
"Command not found: openclaw"# Dodaj do PATH
export PATH="$HOME/.openclaw/bin:$PATH"
# Dodaj do swojego profilu powłoki (.bashrc, .zshrc)
# Sprawdź zmienne środowiskowe
openclaw config get models
# Ponownie uruchom konfigurację
openclaw onboard
# Sprawdź logi
openclaw logs --channel whatsapp
# Zrestartuj bramę
openclaw gateway restart
# Przebuduj indeks umiejętności
openclaw skill rebuild
# Sprawdź konflikty
openclaw doctor --check skills
Uzyskiwanie pomocy
- Dokumentacja: docs.openclaw.ai
- Zgłoszenia GitHub: github.com/openclaw/openclaw/issues
- Społeczność Discord: discord.gg/openclaw
- Reddit: r/OpenClaw
Zestawienie kosztów
Sam OpenClaw jest bezpłatny. Twoje koszty wynikają z użycia API AI:
| Poziom użycia | Miesięczna liczba tokenów | Szacowany koszt |
|---|---|---|
| Niskie | ~1M tokenów | 3-10 USD |
| Średnie | ~5M tokenów | 15-40 USD |
| Wysokie | ~20M tokenów | 60-150 USD |
| Zaawansowany użytkownik | 50M+ tokenów | 150+ USD |
Porady dotyczące oszczędności
- Używaj DeepSeek do rutynowych zadań (0,14 USD/1M tokenów vs 3 USD/1M w Claude)
- Lokalne modele dla prostych zapytań (bezpłatne po zakupie sprzętu)
- Ustaw limity tokenów na rozmowę
- Korzystaj z buforowania (caching) dla powtarzających się zapytań
Co dalej?
Skoro OpenClaw już działa, oto kilka pomysłów:
Twórz własne umiejętności
Twórz niestandardowe umiejętności dla swoich potrzeb:
# Utwórz nową umiejętność
openclaw skill create my-custom-skill
# Edytuj umiejętność
code ~/.openclaw/skills/my-custom-skill/SKILL.md
Połącz więcej platform
- Dodaj wiele kont WhatsApp (prywatne + służbowe)
- Połącz Slacka do pracy i Discorda do celów prywatnych
- Skonfiguruj iMessage dla ekosystemu Apple
Eksploruj ekosystem
- Przeglądaj ClawHub w poszukiwaniu ponad 3000 umiejętności
- Dołącz do społeczności Discord po wskazówki i triki
- Obserwuj @OpenClaw, aby otrzymywać aktualizacje
Idąc krok dalej: Wdrażaj własne produkty AI
Gdy już doświadczysz mocy asystentów AI, możesz chcieć budować produkty dla innych. Tu z pomocą przychodzi Y Build.
Y Build pomaga przejść od pomysłu opartego na AI do gotowego produktu:
- Kodowanie AI: Opisz, czego chcesz, a AI wygeneruje kod
- Wdrożenie jednym kliknięciem: Bądź online natychmiast dzięki globalnej sieci CDN
- Narzędzia wzrostu: Filmy demonstracyjne, optymalizacja SEO, analityka
- Narzędzie SaaS oparte na AI
- Platformę automatyzacji taką jak OpenClaw
- Niestandardowy chatbot dla swojej firmy
Podsumowanie
OpenClaw reprezentuje nowy paradygmat w osobistej sztucznej inteligencji — asystenta, który jest:
- Lokalny: Twoje dane nigdy nie opuszczają Twojej maszyny
- Potężny: Pełny dostęp do systemu oznacza prawdziwą automatyzację
- Rozszerzalny: Ponad 3000 umiejętności i ta liczba rośnie
- Wieloplatformowy: Jedno AI, dostępne wszędzie
- Odpowiadać na pytania z Twojego WhatsAppa
- Przeszukiwać i organizować Twoje pliki
- Automatyzować powtarzalne zadania
- Sterować Twoim inteligentnym domem
- I wiele więcej
Witaj w społeczności OpenClaw. 🦞
Źródła: