OpenClaw Config Edit: Kompletní průvodce nastavením (2026)

Q: Kde je uložen konfigurační soubor OpenClaw?

Výchozí umístění je ~/.openclaw/config.yaml. U některých instalací může být v ~/.config/openclaw/config.yaml. Spuštěním openclaw config show --path zjistíte přesné umístění.

Q: Jak aktualizovat OpenClaw?

```bash pip install --upgrade openclaw

Q: Jak resetuji konfiguraci na výchozí hodnoty?

```bash openclaw config reset ```

TL;DR

Rychlý přehled nejběžnějších konfiguračních příkazů OpenClaw:

bash

# Open the config editor
openclaw config edit

# Set a specific value
openclaw config set channels.whatsapp.enabled true
openclaw config set model.provider openai
openclaw config set model.name gpt-4o

# View current config
openclaw config show

# Validate and fix config issues
openclaw doctor
openclaw doctor --fix

# Reset to defaults
openclaw config reset

Co je OpenClaw?

OpenClaw je open-source framework pro AI asistenty, který propojuje velké jazykové modely s komunikačními kanály jako WhatsApp, Discord, Telegram a Slack. Podporuje více poskytovatelů modelů — OpenAI, Anthropic, Ollama (lokální modely), Google a další — a lze jej rozšířit o vlastní dovednosti a pluginy.

Jádrem OpenClaw je jeho konfigurační systém. Téměř vše — které kanály jsou aktivní, jaký model se má použít, které dovednosti jsou načteny — se ovládá pomocí konfiguračních souborů. Zvládnutí openclaw config edit je klíčem k tomu, aby OpenClaw běžel přesně podle vašich představ.

openclaw config edit: Základy

Otevření editoru konfigurace

Hlavní příkaz pro konfiguraci OpenClaw je:

bash

openclaw config edit

Tento příkaz otevře váš konfigurační soubor ve vašem výchozím terminálovém editoru (obvykle nano, vim nebo cokoli, co máte nastaveno v $EDITOR). Konfigurační soubor se obvykle nachází v ~/.openclaw/config.yaml nebo ~/.config/openclaw/config.yaml v závislosti na vaší instalaci.

Struktura konfiguračního souboru

Konfigurační soubor OpenClaw je ve formátu YAML a je rozdělen do sekcí:

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."

Nastavení jednotlivých hodnot

Místo upravování celého souboru můžete nastavit jednotlivé hodnoty konfigurace přímo z příkazové řádky:

bash

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

To je užitečné pro skriptování nebo rychlé změny bez nutnosti otevírat editor.

Nastavení kanálů

Integrace WhatsApp vyžaduje účet Meta Business a přístup k WhatsApp Business API.

bash

# Enable WhatsApp channel
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"

Běžný problém: WhatsApp vyžaduje URL adresu pro webhook. Musíte OpenClaw zpřístupnit internetu pomocí reverzní proxy (nginx, Caddy) nebo tunelovací služby (ngrok, Cloudflare Tunnel).

bash

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

Discord

Nastavení Discordu je jednodušší — stačí vám bot token z Discord Developer Portal.

bash

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

Tip: Ujistěte se, že váš Discord bot má v Developer Portal povolený „Message Content“ privileged intent, jinak nebude moci číst zprávy.

Telegram vyžaduje bot token od @BotFather:

bash

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

Telegram podporuje režimy polling i webhook. Polling je jednodušší pro vývoj (nevyžaduje veřejnou URL):

bash

openclaw config set channels.telegram.mode polling

Pro produkční nasazení použijte režim webhook:

bash

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

Slack

Integrace Slacku využívá Socket Mode (doporučeno) nebo 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"

Socket Mode je doporučen, protože nevyžaduje veřejnou URL adresu.

Konfigurace poskytovatelů modelů

OpenAI

bash

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

Nastavte svůj API klíč jako proměnnou prostředí (neukládejte jej přímo do konfiguračního souboru):

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 (Lokální modely)

Zde OpenClaw exceluje pro uživatele dbající na soukromí. Ollama vám umožňuje spouštět modely lokálně bez API klíčů a bez toho, aby vaše data opustila váš stroj.

bash

# Install Ollama first
# https://ollama.ai

# Pull a model
ollama pull llama3.3

# Configure OpenClaw to use Ollama
openclaw config set model.provider ollama
openclaw config set model.name llama3.3
openclaw config set model.base_url "http://localhost:11434"

Běžný problém: Pokud se OpenClaw nemůže k Ollama připojit, ujistěte se, že Ollama běží (ollama serve) a že base URL odpovídá. Výchozí port Ollama je 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 uses OpenAI-compatible API
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-..."   # Use xAI key with OpenAI provider

Běžné chyby v konfiguraci a jejich řešení

Chyba: "Unknown config key"

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

To obvykle znamená překlep v klíči konfigurace. Zkontrolujte pravopis. Časté chyby:

chanels → channels

providr → provider

telgram → telegram

Spuštěním openclaw config show zobrazíte všechny platné klíče.

Chyba: "Channel auto-enabled without credentials"

Některé verze OpenClaw automaticky aktivují kanály, jakmile nastavíte přihlašovací údaje, i když jste je explicitně nepovolili. To může způsobit chyby při spuštění, pokud jsou údaje neúplné.

Oprava:

bash

# Explicitly disable channels you're not using
openclaw config set channels.whatsapp.enabled false
openclaw config set channels.discord.enabled false
openclaw config set channels.slack.enabled false

Chyba: "Model provider not configured"

Error: Model provider 'anthropic' requires ANTHROPIC_API_KEY

Musíte nastavit odpovídající proměnnou prostředí. OpenClaw záměrně neukládá API klíče v konfiguračním souboru z bezpečnostních důvodů.

Oprava: Přidejte API klíč do svého profilu shellu (~/.bashrc, ~/.zshrc) nebo použijte soubor .env:

bash

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

Použití openclaw doctor

Příkaz openclaw doctor zkontroluje celou vaši konfiguraci a nahlásí problémy:

bash

openclaw doctor

Příklad výstupu:

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.

Příznak --fix se pokusí problémy vyřešit automaticky:

bash

openclaw doctor --fix

To zakáže kanály s chybějícími údaji, opraví známé problémy s formátováním a navrhne manuální opravy u problémů, které nelze vyřešit automaticky.

Pokročilá konfigurace

Vlastní dovednosti (Skills)

OpenClaw podporuje vlastní dovednosti (pluginy), které rozšiřují schopnosti asistenta:

yaml

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

Nebo přes příkazovou řádku:

bash

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

Konfigurace Speech-to-Text (STT)

Pro podporu hlasových zpráv na WhatsApp a Telegramu:

yaml

stt:
  provider: whisper          # whisper, deepgram, google
  model: whisper-1
  language: auto             # auto-detect or specify "en", "es", etc.

bash

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

Integrace chytré domácnosti Tuya

OpenClaw může ovládat zařízení chytré domácnosti kompatibilní s Tuya:

yaml

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

To vám umožní ovládat světla, spínače, termostaty a další zařízení Tuya prostřednictvím příkazů v přirozeném jazyce v jakémkoli připojeném kanálu.

Konfigurace více modelů

Můžete definovat předvolby modelů a přepínat mezi 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
# or switch at runtime
openclaw --model fast

Často kladené otázky

Kde je uložen konfigurační soubor OpenClaw?

Výchozí umístění je ~/.openclaw/config.yaml. U některých instalací může být v ~/.config/openclaw/config.yaml. Spuštěním openclaw config show --path zjistíte přesné umístění.

Mohu používat OpenClaw bez jakéhokoli cloudového API?

Ano. Nakonfigurujte Ollama jako poskytovatele modelu a používejte Telegram v režimu polling. Získáte tak plně lokálního, soukromého AI asistenta, přičemž žádná data neopustí váš počítač.

Jak aktualizovat OpenClaw?

bash

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

Po aktualizaci spusťte openclaw doctor, abyste zkontrolovali případné změny ve formátu konfigurace.

Mohu spustit více kanálů současně?

Ano. Povolte tolik kanálů, kolik chcete — OpenClaw je obsluhuje souběžně. Každý kanál sdílí stejnou konfiguraci modelu a dovedností.

Jak resetuji konfiguraci na výchozí hodnoty?

bash

openclaw config reset

Tímto se váš konfigurační soubor přepíše výchozí šablonou. V případě potřeby si stávající konfiguraci nejprve zazálohujte.

Chcete něco jednoduššího?

OpenClaw je výkonný, ale vyžaduje znalost terminálu a manuální konfiguraci. Pokud chcete stavět a dodávat AI produkty bez toho, abyste sami spravovali konfigurační soubory, poskytovatele modelů a integrace kanálů:

Y Build se postará o kompletní stack — nasazení, produktová videa, AI SEO a analytiku. Žádné konfigurační soubory. Žádný terminál. Jen tvořte a prodávejte. Začněte zdarma →

Zdroje:

TL;DR

Rychlý přehled nejběžnějších konfiguračních příkazů OpenClaw:

bash

# Open the config editor
openclaw config edit

# Set a specific value
openclaw config set channels.whatsapp.enabled true
openclaw config set model.provider openai
openclaw config set model.name gpt-4o

# View current config
openclaw config show

# Validate and fix config issues
openclaw doctor
openclaw doctor --fix

# Reset to defaults
openclaw config reset

Co je OpenClaw?

openclaw config edit: Základy

Otevření editoru konfigurace

Hlavní příkaz pro konfiguraci OpenClaw je:

bash

openclaw config edit

Struktura konfiguračního souboru

Konfigurační soubor OpenClaw je ve formátu YAML a je rozdělen do sekcí:

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."

Nastavení jednotlivých hodnot

Místo upravování celého souboru můžete nastavit jednotlivé hodnoty konfigurace přímo z příkazové řádky:

bash

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

To je užitečné pro skriptování nebo rychlé změny bez nutnosti otevírat editor.

Nastavení kanálů

Integrace WhatsApp vyžaduje účet Meta Business a přístup k WhatsApp Business API.

bash

# Enable WhatsApp channel
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"

Běžný problém: WhatsApp vyžaduje URL adresu pro webhook. Musíte OpenClaw zpřístupnit internetu pomocí reverzní proxy (nginx, Caddy) nebo tunelovací služby (ngrok, Cloudflare Tunnel).

bash

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

Discord

Nastavení Discordu je jednodušší — stačí vám bot token z Discord Developer Portal.

bash

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

Tip: Ujistěte se, že váš Discord bot má v Developer Portal povolený „Message Content“ privileged intent, jinak nebude moci číst zprávy.

Telegram vyžaduje bot token od @BotFather:

bash

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

Telegram podporuje režimy polling i webhook. Polling je jednodušší pro vývoj (nevyžaduje veřejnou URL):

bash

openclaw config set channels.telegram.mode polling

Pro produkční nasazení použijte režim webhook:

bash

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

Slack

Integrace Slacku využívá Socket Mode (doporučeno) nebo 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"

Socket Mode je doporučen, protože nevyžaduje veřejnou URL adresu.

Konfigurace poskytovatelů modelů

OpenAI

bash

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

Nastavte svůj API klíč jako proměnnou prostředí (neukládejte jej přímo do konfiguračního souboru):

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 (Lokální modely)

Zde OpenClaw exceluje pro uživatele dbající na soukromí. Ollama vám umožňuje spouštět modely lokálně bez API klíčů a bez toho, aby vaše data opustila váš stroj.

bash

# Install Ollama first
# https://ollama.ai

# Pull a model
ollama pull llama3.3

# Configure OpenClaw to use Ollama
openclaw config set model.provider ollama
openclaw config set model.name llama3.3
openclaw config set model.base_url "http://localhost:11434"

Běžný problém: Pokud se OpenClaw nemůže k Ollama připojit, ujistěte se, že Ollama běží (ollama serve) a že base URL odpovídá. Výchozí port Ollama je 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 uses OpenAI-compatible API
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-..."   # Use xAI key with OpenAI provider

Běžné chyby v konfiguraci a jejich řešení

Chyba: "Unknown config key"

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

To obvykle znamená překlep v klíči konfigurace. Zkontrolujte pravopis. Časté chyby:

chanels → channels

providr → provider

telgram → telegram

Spuštěním openclaw config show zobrazíte všechny platné klíče.

Chyba: "Channel auto-enabled without credentials"

Oprava:

bash

# Explicitly disable channels you're not using
openclaw config set channels.whatsapp.enabled false
openclaw config set channels.discord.enabled false
openclaw config set channels.slack.enabled false

Chyba: "Model provider not configured"

Error: Model provider 'anthropic' requires ANTHROPIC_API_KEY

Musíte nastavit odpovídající proměnnou prostředí. OpenClaw záměrně neukládá API klíče v konfiguračním souboru z bezpečnostních důvodů.

Oprava: Přidejte API klíč do svého profilu shellu (~/.bashrc, ~/.zshrc) nebo použijte soubor .env:

bash

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

Použití openclaw doctor

Příkaz openclaw doctor zkontroluje celou vaši konfiguraci a nahlásí problémy:

bash

openclaw doctor

Příklad výstupu:

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.

Příznak --fix se pokusí problémy vyřešit automaticky:

bash

openclaw doctor --fix

To zakáže kanály s chybějícími údaji, opraví známé problémy s formátováním a navrhne manuální opravy u problémů, které nelze vyřešit automaticky.

Pokročilá konfigurace

Vlastní dovednosti (Skills)

OpenClaw podporuje vlastní dovednosti (pluginy), které rozšiřují schopnosti asistenta:

yaml

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

Nebo přes příkazovou řádku:

bash

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

Konfigurace Speech-to-Text (STT)

Pro podporu hlasových zpráv na WhatsApp a Telegramu:

yaml

stt:
  provider: whisper          # whisper, deepgram, google
  model: whisper-1
  language: auto             # auto-detect or specify "en", "es", etc.

bash

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

Integrace chytré domácnosti Tuya

OpenClaw může ovládat zařízení chytré domácnosti kompatibilní s Tuya:

yaml

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

To vám umožní ovládat světla, spínače, termostaty a další zařízení Tuya prostřednictvím příkazů v přirozeném jazyce v jakémkoli připojeném kanálu.

Konfigurace více modelů

Můžete definovat předvolby modelů a přepínat mezi 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
# or switch at runtime
openclaw --model fast

Často kladené otázky

Kde je uložen konfigurační soubor OpenClaw?

Výchozí umístění je ~/.openclaw/config.yaml. U některých instalací může být v ~/.config/openclaw/config.yaml. Spuštěním openclaw config show --path zjistíte přesné umístění.

Mohu používat OpenClaw bez jakéhokoli cloudového API?

Jak aktualizovat OpenClaw?

bash

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

Po aktualizaci spusťte openclaw doctor, abyste zkontrolovali případné změny ve formátu konfigurace.

Mohu spustit více kanálů současně?

Ano. Povolte tolik kanálů, kolik chcete — OpenClaw je obsluhuje souběžně. Každý kanál sdílí stejnou konfiguraci modelu a dovedností.

Jak resetuji konfiguraci na výchozí hodnoty?

bash

openclaw config reset

Tímto se váš konfigurační soubor přepíše výchozí šablonou. V případě potřeby si stávající konfiguraci nejprve zazálohujte.

Chcete něco jednoduššího?

Y Build se postará o kompletní stack — nasazení, produktová videa, AI SEO a analytiku. Žádné konfigurační soubory. Žádný terminál. Jen tvořte a prodávejte. Začněte zdarma →

Zdroje: