OpenClaw Config Edit: Pełny przewodnik konfiguracji (2026)

Q: Gdzie jest przechowywany plik konfiguracyjny OpenClaw?

Domyślna lokalizacja to ~/.openclaw/config.yaml. W niektórych instalacjach może to być ~/.config/openclaw/config.yaml. Uruchom openclaw config show --path, aby zobaczyć dokładną ścieżkę.

Q: Jak zaktualizować OpenClaw?

```bash pip install --upgrade openclaw

Q: Jak zresetować konfigurację do ustawień domyślnych?

```bash openclaw config reset ```

TL;DR

Szybka ściąga z najczęstszymi poleceniami konfiguracji OpenClaw:

bash

# Otwórz edytor konfiguracji
openclaw config edit

# Ustaw konkretną wartość
openclaw config set channels.whatsapp.enabled true
openclaw config set model.provider openai
openclaw config set model.name gpt-4o

# Wyświetl aktualną konfigurację
openclaw config show

# Walidacja i naprawa problemów z konfiguracją
openclaw doctor
openclaw doctor --fix

# Przywróć ustawienia domyślne
openclaw config reset

Czym jest OpenClaw?

OpenClaw to framework asystenta AI typu open-source, który łączy duże modele językowe z kanałami komunikacji, takimi jak WhatsApp, Discord, Telegram i Slack. Obsługuje wielu dostawców modeli — OpenAI, Anthropic, Ollama (modele lokalne), Google i innych — oraz może być rozszerzany o własne umiejętności (skills) i wtyczki.

Sercem OpenClaw jest jego system konfiguracji. Prawie wszystko — to, które kanały są aktywne, jakiego modelu użyć, jakie umiejętności są załadowane — jest kontrolowane za pomocą plików konfiguracyjnych. Opanowanie openclaw config edit jest kluczem do uruchomienia OpenClaw dokładnie tak, jak tego chcesz.

openclaw config edit: Podstawy

Otwieranie edytora konfiguracji

Podstawowym poleceniem do konfiguracji OpenClaw jest:

bash

openclaw config edit

Otwiera ono plik konfiguracyjny w domyślnym edytorze terminala (zazwyczaj nano, vim lub cokolwiek, co jest ustawione w zmiennej $EDITOR). Plik konfiguracji zazwyczaj znajduje się w ~/.openclaw/config.yaml lub ~/.config/openclaw/config.yaml, w zależności od Twojej instalacji.

Struktura pliku konfiguracyjnego

Plik konfiguracyjny OpenClaw jest sformatowany w YAML i podzielony na sekcje:

yaml

# Model configuration
model:
  provider: openai        # openai, anthropic, ollama, google
  name: gpt-4o            # model identifier string
  temperature: 0.7
  max_tokens: 4096

# Channel configuration
channels:
  whatsapp:
    enabled: false
    phone_number_id: ""
    access_token: ""
  discord:
    enabled: false
    bot_token: ""
  telegram:
    enabled: false
    bot_token: ""
  slack:
    enabled: false
    bot_token: ""
    app_token: ""

# Skills and plugins
skills:
  - web_search
  - calculator
  - weather

# Speech-to-text
stt:
  provider: whisper
  model: whisper-1

# System prompt
system_prompt: "You are a helpful assistant."

Ustawianie pojedynczych wartości

Zamiast edytować cały plik, możesz ustawić poszczególne wartości konfiguracji z poziomu wiersza poleceń:

bash

openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6
openclaw config set model.temperature 0.5

Jest to przydatne w skryptach lub przy szybkich zmianach bez otwierania edytora.

Konfiguracja kanałów

Integracja z WhatsApp wymaga konta Meta Business oraz dostępu do WhatsApp Business API.

bash

# Włącz kanał WhatsApp
openclaw config set channels.whatsapp.enabled true
openclaw config set channels.whatsapp.phone_number_id "YOUR_PHONE_NUMBER_ID"
openclaw config set channels.whatsapp.access_token "YOUR_ACCESS_TOKEN"
openclaw config set channels.whatsapp.verify_token "YOUR_VERIFY_TOKEN"

Częsty problem: WhatsApp wymaga adresu URL webhooka. Musisz wystawić OpenClaw na świat za pomocą reverse proxy (nginx, Caddy) lub usługi tunelowania (ngrok, Cloudflare Tunnel).

bash

# Ustaw URL webhooka
openclaw config set channels.whatsapp.webhook_url "https://your-domain.com/webhook/whatsapp"

Discord

Konfiguracja Discorda jest prostsza — potrzebujesz jedynie tokena bota z Discord Developer Portal.

bash

openclaw config set channels.discord.enabled true
openclaw config set channels.discord.bot_token "YOUR_DISCORD_BOT_TOKEN"

Wskazówka: Upewnij się, że Twój bot na Discordzie ma włączony uprzywilejowany intent "Message Content" w Developer Portal, inaczej nie będzie mógł czytać wiadomości.

Telegram wymaga tokena bota od @BotFather:

bash

openclaw config set channels.telegram.enabled true
openclaw config set channels.telegram.bot_token "YOUR_TELEGRAM_BOT_TOKEN"

Telegram obsługuje zarówno tryb polling, jak i webhook. Polling jest łatwiejszy podczas programowania (nie wymaga publicznego adresu URL):

bash

openclaw config set channels.telegram.mode polling

W środowisku produkcyjnym użyj trybu webhook:

bash

openclaw config set channels.telegram.mode webhook
openclaw config set channels.telegram.webhook_url "https://your-domain.com/webhook/telegram"

Slack

Integracja ze Slackiem wykorzystuje tryb Socket Mode (zalecany) lub Events API:

bash

openclaw config set channels.slack.enabled true
openclaw config set channels.slack.bot_token "xoxb-YOUR-BOT-TOKEN"
openclaw config set channels.slack.app_token "xapp-YOUR-APP-TOKEN"

Zaleca się tryb Socket Mode, ponieważ nie wymaga on publicznego adresu URL.

Konfiguracja dostawców modeli

OpenAI

bash

openclaw config set model.provider openai
openclaw config set model.name gpt-4o

Ustaw klucz API jako zmienną środowiskową (nie umieszczaj go w pliku konfiguracyjnym ze względów bezpieczeństwa):

bash

export OPENAI_API_KEY="sk-..."

Anthropic (Claude)

bash

openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6

bash

export ANTHROPIC_API_KEY="sk-ant-..."

Ollama (Lokalne modele)

To tutaj OpenClaw błyszczy dla użytkowników dbających o prywatność. Ollama pozwala uruchamiać modele lokalnie bez kluczy API i bez wysyłania danych poza Twoją maszynę.

bash

# Najpierw zainstaluj Ollama
# https://ollama.ai

# Pobierz model
ollama pull llama3.3

# Skonfiguruj OpenClaw do korzystania z Ollama
openclaw config set model.provider ollama
openclaw config set model.name llama3.3
openclaw config set model.base_url "http://localhost:11434"

Częsty problem: Jeśli OpenClaw nie może połączyć się z Ollama, upewnij się, że Ollama działa (ollama serve) i że adres base URL jest poprawny. Domyślny port Ollama to 11434.

Google (Gemini)

bash

openclaw config set model.provider google
openclaw config set model.name gemini-2.5-pro

bash

export GOOGLE_API_KEY="..."

xAI (Grok)

bash

openclaw config set model.provider openai   # xAI używa API kompatybilnego z OpenAI
openclaw config set model.name grok-4.1
openclaw config set model.base_url "https://api.x.ai/v1"

bash

export OPENAI_API_KEY="xai-..."   # Użyj klucza xAI z dostawcą OpenAI

Typowe błędy konfiguracji i ich rozwiązania

Błąd: "Unknown config key"

Error: Unknown config key 'chanels.whatsapp.enabled'

Zazwyczaj oznacza to literówkę w kluczu konfiguracji. Sprawdź pisownię. Częste błędy:

chanels → channels

providr → provider

telgram → telegram

Uruchom openclaw config show, aby zobaczyć wszystkie poprawne klucze.

Błąd: "Channel auto-enabled without credentials"

Niektóre wersje OpenClaw automatycznie włączają kanały po ustawieniu danych uwierzytelniających, nawet jeśli nie zostały one jawnie włączone. Może to powodować błędy przy uruchamianiu, jeśli dane są niekompletne.

Rozwiązanie:

bash

# Jawnie wyłącz kanały, których nie używasz
openclaw config set channels.whatsapp.enabled false
openclaw config set channels.discord.enabled false
openclaw config set channels.slack.enabled false

Błąd: "Model provider not configured"

Error: Model provider 'anthropic' requires ANTHROPIC_API_KEY

Musisz ustawić odpowiednią zmienną środowiskową. OpenClaw celowo nie przechowuje kluczy API w pliku konfiguracyjnym ze względów bezpieczeństwa.

Rozwiązanie: Dodaj klucz API do swojego profilu powłoki (~/.bashrc, ~/.zshrc) lub użyj pliku .env:

bash

echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc
source ~/.zshrc

Korzystanie z openclaw doctor

Polecenie openclaw doctor waliduje całą konfigurację i zgłasza problemy:

bash

openclaw doctor

Przykład wyniku:

Checking configuration...
  ✓ Config file found
  ✓ Model provider configured
  ✗ WhatsApp: enabled but missing access_token
  ✗ Discord: bot token invalid format
  ✓ Telegram: configured correctly
  ✓ Ollama: connection successful

2 issues found. Run 'openclaw doctor --fix' to attempt auto-fix.

Flaga --fix próbuje automatycznie rozwiązać problemy:

bash

openclaw doctor --fix

Spowoduje to wyłączenie kanałów z brakującymi danymi uwierzytelniającymi, poprawienie znanych błędów formatowania i zasugerowanie ręcznych napraw dla problemów, których nie można rozwiązać automatycznie.

Zaawansowana konfiguracja

Własne umiejętności (Skills)

OpenClaw obsługuje własne umiejętności (wtyczki), które rozszerzają możliwości asystenta:

yaml

skills:
  - web_search
  - calculator
  - weather
  - custom_skill:
      path: ./my-skills/custom_tool.py
      config:
        api_key_env: CUSTOM_API_KEY

Lub za pomocą wiersza poleceń:

bash

openclaw skills add web_search
openclaw skills add ./my-skills/custom_tool.py
openclaw skills list
openclaw skills remove calculator

Konfiguracja Speech-to-Text (STT)

Dla obsługi wiadomości głosowych w WhatsApp i Telegramie:

yaml

stt:
  provider: whisper          # whisper, deepgram, google
  model: whisper-1
  language: auto             # automatyczne wykrywanie lub np. "pl", "en"

bash

openclaw config set stt.provider whisper
openclaw config set stt.model whisper-1

Integracja Smart Home Tuya

OpenClaw może kontrolować urządzenia inteligentnego domu kompatybilne z Tuya:

yaml

tuya:
  enabled: true
  access_id: "YOUR_TUYA_ACCESS_ID"
  access_key: "YOUR_TUYA_ACCESS_KEY"
  endpoint: "https://openapi.tuyaus.com"

Pozwala to kontrolować światła, przełączniki, termostaty i inne urządzenia Tuya za pomocą poleceń w języku naturalnym w dowolnym połączonym kanale.

Wiele konfiguracji modeli

Możesz zdefiniować zestawy modeli i przełączać się między nimi:

yaml

models:
  default:
    provider: openai
    name: gpt-4o
  fast:
    provider: ollama
    name: llama3.3
  reasoning:
    provider: anthropic
    name: claude-opus-4-6

bash

openclaw config set model.active default
# lub przełącz w trakcie działania
openclaw --model fast

Najczęściej zadawane pytania (FAQ)

Gdzie jest przechowywany plik konfiguracyjny OpenClaw?

Domyślna lokalizacja to ~/.openclaw/config.yaml. W niektórych instalacjach może to być ~/.config/openclaw/config.yaml. Uruchom openclaw config show --path, aby zobaczyć dokładną ścieżkę.

Czy mogę używać OpenClaw bez żadnego API w chmurze?

Tak. Skonfiguruj Ollama jako dostawcę modelu i używaj Telegrama w trybie polling. Daje Ci to w pełni lokalnego, prywatnego asystenta AI, a żadne dane nie opuszczają Twojej maszyny.

Jak zaktualizować OpenClaw?

bash

pip install --upgrade openclaw
# lub
npm update -g openclaw

Po aktualizacji uruchom openclaw doctor, aby sprawdzić, czy nie zmienił się format konfiguracji.

Czy mogę uruchomić wiele kanałów jednocześnie?

Tak. Możesz włączyć dowolną liczbę kanałów — OpenClaw obsługuje je równocześnie. Każdy kanał korzysta z tej samej konfiguracji modelu i umiejętności.

Jak zresetować konfigurację do ustawień domyślnych?

bash

openclaw config reset

To polecenie nadpisze Twój plik konfiguracyjny domyślnym szablonem. W razie potrzeby najpierw utwórz kopię zapasową istniejącej konfiguracji.

Szukasz czegoś prostszego?

OpenClaw jest potężny, ale wymaga swobody w pracy z terminalem i ręcznej konfiguracji. Jeśli chcesz tworzyć i wdrażać produkty oparte na AI bez samodzielnego zarządzania plikami konfiguracyjnymi, dostawcami modeli i integracjami kanałów:

Y Build obsługuje pełny stos — wdrożenie, filmy produktowe, AI SEO i analitykę. Bez plików konfiguracyjnych. Bez terminala. Po prostu buduj i wdrażaj. Zacznij za darmo →

Źródła:

TL;DR

Szybka ściąga z najczęstszymi poleceniami konfiguracji OpenClaw:

bash

# Otwórz edytor konfiguracji
openclaw config edit

# Ustaw konkretną wartość
openclaw config set channels.whatsapp.enabled true
openclaw config set model.provider openai
openclaw config set model.name gpt-4o

# Wyświetl aktualną konfigurację
openclaw config show

# Walidacja i naprawa problemów z konfiguracją
openclaw doctor
openclaw doctor --fix

# Przywróć ustawienia domyślne
openclaw config reset

Czym jest OpenClaw?

openclaw config edit: Podstawy

Otwieranie edytora konfiguracji

Podstawowym poleceniem do konfiguracji OpenClaw jest:

bash

openclaw config edit

Struktura pliku konfiguracyjnego

Plik konfiguracyjny OpenClaw jest sformatowany w YAML i podzielony na sekcje:

yaml

# Model configuration
model:
  provider: openai        # openai, anthropic, ollama, google
  name: gpt-4o            # model identifier string
  temperature: 0.7
  max_tokens: 4096

# Channel configuration
channels:
  whatsapp:
    enabled: false
    phone_number_id: ""
    access_token: ""
  discord:
    enabled: false
    bot_token: ""
  telegram:
    enabled: false
    bot_token: ""
  slack:
    enabled: false
    bot_token: ""
    app_token: ""

# Skills and plugins
skills:
  - web_search
  - calculator
  - weather

# Speech-to-text
stt:
  provider: whisper
  model: whisper-1

# System prompt
system_prompt: "You are a helpful assistant."

Ustawianie pojedynczych wartości

Zamiast edytować cały plik, możesz ustawić poszczególne wartości konfiguracji z poziomu wiersza poleceń:

bash

openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6
openclaw config set model.temperature 0.5

Jest to przydatne w skryptach lub przy szybkich zmianach bez otwierania edytora.

Konfiguracja kanałów

Integracja z WhatsApp wymaga konta Meta Business oraz dostępu do WhatsApp Business API.

bash

# Włącz kanał WhatsApp
openclaw config set channels.whatsapp.enabled true
openclaw config set channels.whatsapp.phone_number_id "YOUR_PHONE_NUMBER_ID"
openclaw config set channels.whatsapp.access_token "YOUR_ACCESS_TOKEN"
openclaw config set channels.whatsapp.verify_token "YOUR_VERIFY_TOKEN"

Częsty problem: WhatsApp wymaga adresu URL webhooka. Musisz wystawić OpenClaw na świat za pomocą reverse proxy (nginx, Caddy) lub usługi tunelowania (ngrok, Cloudflare Tunnel).

bash

# Ustaw URL webhooka
openclaw config set channels.whatsapp.webhook_url "https://your-domain.com/webhook/whatsapp"

Discord

Konfiguracja Discorda jest prostsza — potrzebujesz jedynie tokena bota z Discord Developer Portal.

bash

openclaw config set channels.discord.enabled true
openclaw config set channels.discord.bot_token "YOUR_DISCORD_BOT_TOKEN"

Wskazówka: Upewnij się, że Twój bot na Discordzie ma włączony uprzywilejowany intent "Message Content" w Developer Portal, inaczej nie będzie mógł czytać wiadomości.

Telegram wymaga tokena bota od @BotFather:

bash

openclaw config set channels.telegram.enabled true
openclaw config set channels.telegram.bot_token "YOUR_TELEGRAM_BOT_TOKEN"

Telegram obsługuje zarówno tryb polling, jak i webhook. Polling jest łatwiejszy podczas programowania (nie wymaga publicznego adresu URL):

bash

openclaw config set channels.telegram.mode polling

W środowisku produkcyjnym użyj trybu webhook:

bash

openclaw config set channels.telegram.mode webhook
openclaw config set channels.telegram.webhook_url "https://your-domain.com/webhook/telegram"

Slack

Integracja ze Slackiem wykorzystuje tryb Socket Mode (zalecany) lub Events API:

bash

openclaw config set channels.slack.enabled true
openclaw config set channels.slack.bot_token "xoxb-YOUR-BOT-TOKEN"
openclaw config set channels.slack.app_token "xapp-YOUR-APP-TOKEN"

Zaleca się tryb Socket Mode, ponieważ nie wymaga on publicznego adresu URL.

Konfiguracja dostawców modeli

OpenAI

bash

openclaw config set model.provider openai
openclaw config set model.name gpt-4o

Ustaw klucz API jako zmienną środowiskową (nie umieszczaj go w pliku konfiguracyjnym ze względów bezpieczeństwa):

bash

export OPENAI_API_KEY="sk-..."

Anthropic (Claude)

bash

openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6

bash

export ANTHROPIC_API_KEY="sk-ant-..."

Ollama (Lokalne modele)

To tutaj OpenClaw błyszczy dla użytkowników dbających o prywatność. Ollama pozwala uruchamiać modele lokalnie bez kluczy API i bez wysyłania danych poza Twoją maszynę.

bash

# Najpierw zainstaluj Ollama
# https://ollama.ai

# Pobierz model
ollama pull llama3.3

# Skonfiguruj OpenClaw do korzystania z Ollama
openclaw config set model.provider ollama
openclaw config set model.name llama3.3
openclaw config set model.base_url "http://localhost:11434"

Częsty problem: Jeśli OpenClaw nie może połączyć się z Ollama, upewnij się, że Ollama działa (ollama serve) i że adres base URL jest poprawny. Domyślny port Ollama to 11434.

Google (Gemini)

bash

openclaw config set model.provider google
openclaw config set model.name gemini-2.5-pro

bash

export GOOGLE_API_KEY="..."

xAI (Grok)

bash

openclaw config set model.provider openai   # xAI używa API kompatybilnego z OpenAI
openclaw config set model.name grok-4.1
openclaw config set model.base_url "https://api.x.ai/v1"

bash

export OPENAI_API_KEY="xai-..."   # Użyj klucza xAI z dostawcą OpenAI

Typowe błędy konfiguracji i ich rozwiązania

Błąd: "Unknown config key"

Error: Unknown config key 'chanels.whatsapp.enabled'

Zazwyczaj oznacza to literówkę w kluczu konfiguracji. Sprawdź pisownię. Częste błędy:

chanels → channels

providr → provider

telgram → telegram

Uruchom openclaw config show, aby zobaczyć wszystkie poprawne klucze.

Błąd: "Channel auto-enabled without credentials"

Rozwiązanie:

bash

# Jawnie wyłącz kanały, których nie używasz
openclaw config set channels.whatsapp.enabled false
openclaw config set channels.discord.enabled false
openclaw config set channels.slack.enabled false

Błąd: "Model provider not configured"

Error: Model provider 'anthropic' requires ANTHROPIC_API_KEY

Musisz ustawić odpowiednią zmienną środowiskową. OpenClaw celowo nie przechowuje kluczy API w pliku konfiguracyjnym ze względów bezpieczeństwa.

Rozwiązanie: Dodaj klucz API do swojego profilu powłoki (~/.bashrc, ~/.zshrc) lub użyj pliku .env:

bash

echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc
source ~/.zshrc

Korzystanie z openclaw doctor

Polecenie openclaw doctor waliduje całą konfigurację i zgłasza problemy:

bash

openclaw doctor

Przykład wyniku:

Checking configuration...
  ✓ Config file found
  ✓ Model provider configured
  ✗ WhatsApp: enabled but missing access_token
  ✗ Discord: bot token invalid format
  ✓ Telegram: configured correctly
  ✓ Ollama: connection successful

2 issues found. Run 'openclaw doctor --fix' to attempt auto-fix.

Flaga --fix próbuje automatycznie rozwiązać problemy:

bash

openclaw doctor --fix

Zaawansowana konfiguracja

Własne umiejętności (Skills)

OpenClaw obsługuje własne umiejętności (wtyczki), które rozszerzają możliwości asystenta:

yaml

skills:
  - web_search
  - calculator
  - weather
  - custom_skill:
      path: ./my-skills/custom_tool.py
      config:
        api_key_env: CUSTOM_API_KEY

Lub za pomocą wiersza poleceń:

bash

openclaw skills add web_search
openclaw skills add ./my-skills/custom_tool.py
openclaw skills list
openclaw skills remove calculator

Konfiguracja Speech-to-Text (STT)

Dla obsługi wiadomości głosowych w WhatsApp i Telegramie:

yaml

stt:
  provider: whisper          # whisper, deepgram, google
  model: whisper-1
  language: auto             # automatyczne wykrywanie lub np. "pl", "en"

bash

openclaw config set stt.provider whisper
openclaw config set stt.model whisper-1

Integracja Smart Home Tuya

OpenClaw może kontrolować urządzenia inteligentnego domu kompatybilne z Tuya:

yaml

tuya:
  enabled: true
  access_id: "YOUR_TUYA_ACCESS_ID"
  access_key: "YOUR_TUYA_ACCESS_KEY"
  endpoint: "https://openapi.tuyaus.com"

Pozwala to kontrolować światła, przełączniki, termostaty i inne urządzenia Tuya za pomocą poleceń w języku naturalnym w dowolnym połączonym kanale.

Wiele konfiguracji modeli

Możesz zdefiniować zestawy modeli i przełączać się między nimi:

yaml

models:
  default:
    provider: openai
    name: gpt-4o
  fast:
    provider: ollama
    name: llama3.3
  reasoning:
    provider: anthropic
    name: claude-opus-4-6

bash

openclaw config set model.active default
# lub przełącz w trakcie działania
openclaw --model fast

Najczęściej zadawane pytania (FAQ)

Gdzie jest przechowywany plik konfiguracyjny OpenClaw?

Czy mogę używać OpenClaw bez żadnego API w chmurze?

Tak. Skonfiguruj Ollama jako dostawcę modelu i używaj Telegrama w trybie polling. Daje Ci to w pełni lokalnego, prywatnego asystenta AI, a żadne dane nie opuszczają Twojej maszyny.

Jak zaktualizować OpenClaw?

bash

pip install --upgrade openclaw
# lub
npm update -g openclaw

Po aktualizacji uruchom openclaw doctor, aby sprawdzić, czy nie zmienił się format konfiguracji.

Czy mogę uruchomić wiele kanałów jednocześnie?

Tak. Możesz włączyć dowolną liczbę kanałów — OpenClaw obsługuje je równocześnie. Każdy kanał korzysta z tej samej konfiguracji modelu i umiejętności.

Jak zresetować konfigurację do ustawień domyślnych?

bash

openclaw config reset

To polecenie nadpisze Twój plik konfiguracyjny domyślnym szablonem. W razie potrzeby najpierw utwórz kopię zapasową istniejącej konfiguracji.

Szukasz czegoś prostszego?

Y Build obsługuje pełny stos — wdrożenie, filmy produktowe, AI SEO i analitykę. Bez plików konfiguracyjnych. Bez terminala. Po prostu buduj i wdrażaj. Zacznij za darmo →

Źródła: