OpenClaw Config Edit: Kompletny przewodnik konfiguracji (2026)

Podsumowanie

Szybka referencja najczesciej uzywanych polecen konfiguracji OpenClaw:

# Otworz edytor konfiguracji
openclaw config edit

# Ustaw konkretna wartosc
openclaw config set channels.whatsapp.enabled true
openclaw config set model.provider openai
openclaw config set model.name gpt-4o

# Wyswietl biezaca konfiguracje
openclaw config show

# Zweryfikuj i napraw problemy konfiguracyjne
openclaw doctor
openclaw doctor --fix

# Zresetuj do domyslnych
openclaw config reset

Czym jest OpenClaw?

OpenClaw to framework asystenta AI o otwartym kodzie zrodlowym, ktory laczy duze modele jezykowe z kanalami komunikacji, takimi jak WhatsApp, Discord, Telegram i Slack. Obsluguje wielu dostawcow modeli — OpenAI, Anthropic, Ollama (modele lokalne), Google i inne — oraz moze byc rozszerzony o niestandardowe umiejetnosci i wtyczki.

Jádrem OpenClaw jest system konfiguracji. Prawie wszystko — ktore kanaly sa aktywne, ktory model jest uzywany, ktore umiejetnosci sa zaladowane — jest kontrolowane przez pliki konfiguracyjne. Opanowanie openclaw config edit jest kluczem do uruchomienia OpenClaw wedlug Twoich potrzeb.

openclaw config edit: Podstawy

Otwieranie edytora konfiguracji

Glowne polecenie do konfiguracji OpenClaw to:

openclaw config edit

Otwiera plik konfiguracyjny w domyslnym edytorze terminala (zwykle nano, vim lub cokolwiek ustawione w $EDITOR). Plik konfiguracyjny znajduje sie zwykle w ~/.openclaw/config.yaml lub ~/.config/openclaw/config.yaml w zaleznosci od instalacji.

Struktura pliku konfiguracyjnego

Plik konfiguracyjny OpenClaw jest w formacie YAML i zorganizowany w sekcje:

# Konfiguracja modelu
model:
  provider: openai        # openai, anthropic, ollama, google
  name: gpt-4o            # ciag identyfikatora modelu
  temperature: 0.7
  max_tokens: 4096

# Konfiguracja kanalow
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: ""

# Umiejetnosci i wtyczki
skills:
  - web_search
  - calculator
  - weather

# Mowa na tekst
stt:
  provider: whisper
  model: whisper-1

# Prompt systemowy
system_prompt: "You are a helpful assistant."

Ustawianie indywidualnych wartosci

Zamiast edytowac caly plik, mozesz ustawiac indywidualne wartosci konfiguracji z wiersza polecen:

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 do skryptow lub szybkich zmian bez otwierania edytora.

Konfiguracja kanalow

WhatsApp

Integracja z WhatsApp wymaga konta Meta Business i dostepu do API WhatsApp Business.

# Wlacz kanal 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"

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

Discord

Konfiguracja Discord jest prostsza — potrzebujesz tylko tokenu bota z Discord Developer Portal.

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

Telegram

Telegram wymaga tokenu bota od @BotFather:

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

Telegram obsluguje tryby polling i webhook. Polling jest latwiejszy do programowania (nie wymaga publicznego URL):

openclaw config set channels.telegram.mode polling

Do produkcji uzyj trybu webhook:

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

Slack

Integracja Slack uzywa Socket Mode (zalecany) lub Events API:

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"

Socket Mode jest zalecany, poniewaz nie wymaga publicznego URL.

Konfiguracja dostawcow modeli

OpenAI

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

Ustaw klucz API jako zmienna srodowiskowa (nie umieszczaj go w pliku konfiguracyjnym):

export OPENAI_API_KEY="sk-..."

Anthropic (Claude)

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

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

Ollama (modele lokalne)

Tutaj OpenClaw swietnie sprawdza sie dla uzytkownikow dbajacych o prywatnosc. Ollama pozwala uruchamiac modele lokalnie bez kluczy API i bez danych opuszczajacych Twoja maszyne.

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

# Pobierz model
ollama pull llama3.3

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

Google (Gemini)

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

export GOOGLE_API_KEY="..."

xAI (Grok)

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

export OPENAI_API_KEY="xai-..."   # Uzyj klucza xAI z dostawca OpenAI

Typowe bledy konfiguracji i rozwiazania

Blad: "Unknown config key"

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

Zwykle oznacza to literowke w kluczu konfiguracji. Sprawdz pisownie. Typowe bledy:

• chanels → channels


• providr → provider


• telgram → telegram

Blad: "Channel auto-enabled without credentials"

Niektore wersje OpenClaw automatycznie wlaczaja kanaly po ustawieniu poswiadczen, nawet jesli nie wlaczyles ich jawnie. Moze to powodowac bledy uruchamiania, jesli poswiadczenia sa niekompletne.

# Jawnie wylacz kanaly, ktorych nie uzywasz
openclaw config set channels.whatsapp.enabled false
openclaw config set channels.discord.enabled false
openclaw config set channels.slack.enabled false

Blad: "Model provider not configured"

Error: Model provider 'anthropic' requires ANTHROPIC_API_KEY

Musisz ustawic odpowiednia zmienna srodowiskowa. OpenClaw celowo nie przechowuje kluczy API w pliku konfiguracyjnym ze wzgledow bezpieczenstwa.

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

Uzycie openclaw doctor

Polecenie openclaw doctor waliduje cala konfiguracje i raportuje problemy:

openclaw doctor

Przyklad wyjscia:

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 probuje automatycznie rozwiazac problemy:

openclaw doctor --fix

Wylacza kanaly z brakujacymi poswiadczeniami, koryguje znane problemy formatowania i sugeruje reczne poprawki dla problemow, ktorych nie moze rozwiazac automatycznie.

Zaawansowana konfiguracja

Niestandardowe umiejetnosci

OpenClaw obsluguje niestandardowe umiejetnosci (wtyczki), ktore rozszerzaja mozliwosci asystenta:

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

Lub przez wiersz polecen:

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

Konfiguracja mowy na tekst (STT)

Dla obslugi wiadomosci glosowych na WhatsApp i Telegram:

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

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

Integracja smart home Tuya

OpenClaw moze sterowac urzadzeniami smart home kompatybilnymi z Tuya:

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

Pozwala to sterowac swiatlem, przelacznikami, termostatami i innymi urzadzeniami Tuya za pomoca polecen w jezyku naturalnym w dowolnym podlaczonym kanale.

Wiele konfiguracji modeli

Mozesz definiowac presety modeli i przełaczac sie miedzy nimi:

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

openclaw config set model.active default
# lub przelacz w czasie dzialania
openclaw --model fast

Czesto zadawane pytania

Gdzie jest przechowywany plik konfiguracyjny OpenClaw?

Domyslna lokalizacja to ~/.openclaw/config.yaml. W niektorych instalacjach moze byc w ~/.config/openclaw/config.yaml. Uruchom openclaw config show --path, aby zobaczyc dokladna lokalizacje.

Czy moge uzywac OpenClaw bez zadnego API chmurowego?

Tak. Skonfiguruj Ollama jako dostawce modeli i uzyj Telegram w trybie polling. Daje to w pelni lokalnego, prywatnego asystenta AI bez danych opuszczajacych Twoja maszyne.

Jak zaktualizowac OpenClaw?

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

Po aktualizacji uruchom openclaw doctor, aby sprawdzic zmiany formatu konfiguracji.

Czy moge uruchomiac wiele kanalow jednoczesnie?

Tak. Wlacz tyle kanalow, ile chcesz — OpenClaw obsluguje je rownoczesnie. Kazdy kanal wspoldzieli ta sama konfiguracje modelu i umiejetnosci.

Jak zresetowac konfiguracje do domyslnych?

openclaw config reset

Nadpisuje plik konfiguracyjny domyslnym szablonem. W razie potrzeby najpierw wykonaj kopie zapasowa istniejacej konfiguracji.

Chcesz czegos prostszego?

OpenClaw jest potezny, ale wymaga komfortu z terminalem i recznej konfiguracji. Jesli chcesz budowac i wysylac produkty oparte na AI bez samodzielnego zarzadzania plikami konfiguracyjnymi, dostawcami modeli i integracjami kanalow:

• OpenClaw GitHub Repository
• OpenClaw Documentation
• Ollama Installation Guide
• WhatsApp Business API Docs