14. března 2026·Y Build Team

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

Ovládněte příkazy openclaw config edit pro WhatsApp, Discord, Telegram, Ollama a další. Krok za krokem průvodce konfigurací kanálů, modelů, poskytovatelů a opravou běžných chyb konfigurace OpenClaw.

OpenClawConfigurationTutorialWhatsAppDiscordTelegramOllamaAI Assistant

Shrnutí

Rychlá reference nejběžnějších příkazů konfigurace OpenClaw:

bash

# Otevření editoru konfigurace
openclaw config edit

# Nastavení konkrétní hodnoty
openclaw config set channels.whatsapp.enabled true
openclaw config set model.provider openai
openclaw config set model.name gpt-4o

# Zobrazení aktuální konfigurace
openclaw config show

# Ověření a oprava konfigurace
openclaw doctor
openclaw doctor --fix

# Reset na výchozí hodnoty
openclaw config reset

Co je OpenClaw?

OpenClaw je open-source framework pro AI asistenta, který propojuje velké jazykové modely s kanály jako WhatsApp, Discord, Telegram a Slack. Podporuje více poskytovatelů modelů — OpenAI, Anthropic, Ollama (lokální modely), Google a další — a lze ho 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í, který model použít, které dovednosti jsou načteny — je řízeno konfiguračními soubory. Zvládnutí openclaw config edit je klíčem k tomu, aby OpenClaw fungoval podle vašich představ.

openclaw config edit: Základy

Otevření editoru konfigurace

Primární příkaz pro konfiguraci OpenClaw je:

bash

openclaw config edit

Toto otevře váš konfigurační soubor ve výchozím terminálovém editoru (obvykle nano, vim nebo cokoli je 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 organizován do sekcí:

yaml

# Konfigurace modelu
model:
  provider: openai        # openai, anthropic, ollama, google
  name: gpt-4o            # řetězec identifikátoru modelu
  temperature: 0.7
  max_tokens: 4096

# Konfigurace kanálů
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: ""

# Dovednosti a pluginy
skills:
  - web_search
  - calculator
  - weather

# Převod řeči na text
stt:
  provider: whisper
  model: whisper-1

# Systémový prompt
system_prompt: "You are a helpful assistant."

Nastavení jednotlivých hodnot

Místo editace celého souboru můžete nastavit jednotlivé konfigurační hodnoty z příkazového řádku:

bash

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

Toto je užitečné pro skriptování nebo rychlé změny bez otevírání editoru.

Early Access

Be first to build with AI

Y Build is the AI-era operating system for startups. Join the waitlist and get early access.

Nastavení kanálů

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

bash

# Povolení kanálu 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"

Běžný problém: WhatsApp vyžaduje URL webhooku. Musíte OpenClaw vystavit internetu pomocí reverzní proxy (nginx, Caddy) nebo tunelové služby (ngrok, Cloudflare Tunnel).

bash

# Nastavení URL webhooku
openclaw config set channels.whatsapp.webhook_url "https://your-domain.com/webhook/whatsapp"

Discord

Nastavení Discordu je jednodušší — potřebujete pouze token bota z Discord Developer Portalu.

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 Portalu povolený privilegovaný intent „Message Content", jinak nebude moci číst zprávy.

Telegram vyžaduje token bota od @BotFather:

bash

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

Telegram podporuje režim dotazování i webhooku. Dotazování je jednodušší pro vývoj (není třeba veřejná URL):

bash

openclaw config set channels.telegram.mode polling

Pro produkci použijte režim webhooku:

bash

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

Slack

Integrace Slack použí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.

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í (nedávejte ho 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 vyniká pro uživatele dbající na soukromí. Ollama vám umožňuje spouštět modely lokálně bez API klíčů a bez odchodu dat z vašeho počítače.

bash

# Nejprve nainstalujte Ollama
# https://ollama.ai

# Stáhněte model
ollama pull llama3.3

# Nakonfigurujte OpenClaw pro použití 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 připojit k Ollama, ujistěte se, že Ollama běží (ollama serve) a základní URL souhlasí. 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 používá API kompatibilní s 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-..."   # Použijte xAI klíč s poskytovatelem OpenAI

Běžné chyby konfigurace a jejich opravy

Chyba: "Unknown config key"

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

Toto obvykle znamená překlep v konfiguračním klíči. Zkontrolujte pravopis. Běžné chyby:

chanels → channels

providr → provider

telgram → telegram

Spusťte openclaw config show pro zobrazení všech platných klíčů.

Chyba: "Channel auto-enabled without credentials"

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

Oprava:

bash

# Explicitně zakažte kanály, které nepoužíváte
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 do konfiguračního souboru z bezpečnostních důvodů.

Oprava: Přidejte API klíč do 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 ověří 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í vyřešit problémy automaticky:

bash

openclaw doctor --fix

Toto zakáže kanály s chybějícími přihlašovacími údaji, opraví známé problémy formátování a navrhne ruční opravy problémů, které nelze vyřešit automaticky.

Pokročilá konfigurace

Vlastní dovednosti

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říkazový řádek:

bash

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

Konfigurace převodu řeči na text (STT)

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

yaml

stt:
  provider: whisper          # whisper, deepgram, google
  model: whisper-1
  language: auto             # automatická detekce nebo upřesněte "en", "es" atd.

bash

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

Integrace Tuya Smart Home

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"

Toto vám umožní ovládat světla, vypínače, termostaty a další zařízení Tuya pomocí 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
# nebo přepněte za běhu
openclaw --model fast

Často kladené dotazy

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. Spusťte openclaw config show --path pro zobrazení přesného umístění.

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

Ano. Nakonfigurujte Ollama jako poskytovatele modelu a použijte Telegram v režimu dotazování. Tím získáte plně lokálního, soukromého AI asistenta bez odchodu dat z vašeho počítače.

Jak aktualizuji OpenClaw?

bash

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

Po aktualizaci spusťte openclaw doctor pro kontrolu změn formátu konfigurace.

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

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

Jak resetuji konfiguraci na výchozí hodnoty?

bash

openclaw config reset

Toto přepíše váš konfigurační soubor výchozí šablonou. Pokud je potřeba, nejprve si zálohujte stávající konfiguraci.

Chcete něco jednoduššího?

OpenClaw je výkonný, ale vyžaduje pohodlí s terminálem a ruční konfiguraci. Pokud chcete stavět a dodávat produkty poháněné AI bez správy konfiguračních souborů, poskytovatelů modelů a integrací kanálů:

Y Build se postará o celý stack — nasazení, produktová videa, AI SEO a analytika. Žádné konfigurační soubory. Žádný terminál. Prostě stavte a dodávejte. Začněte zdarma →

Zdroje:

Early Access

Be first to build with AI

Y Build is the AI-era operating system for startups. Join the waitlist and get early access.

Zpět na blog

14. března 2026·Y Build Team

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

OpenClawConfigurationTutorialWhatsAppDiscordTelegramOllamaAI Assistant

Shrnutí

Rychlá reference nejběžnějších příkazů konfigurace OpenClaw:

bash

# Otevření editoru konfigurace
openclaw config edit

# Nastavení konkrétní hodnoty
openclaw config set channels.whatsapp.enabled true
openclaw config set model.provider openai
openclaw config set model.name gpt-4o

# Zobrazení aktuální konfigurace
openclaw config show

# Ověření a oprava konfigurace
openclaw doctor
openclaw doctor --fix

# Reset na výchozí hodnoty
openclaw config reset

Co je OpenClaw?

openclaw config edit: Základy

Otevření editoru konfigurace

Primární 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 organizován do sekcí:

yaml

# Konfigurace modelu
model:
  provider: openai        # openai, anthropic, ollama, google
  name: gpt-4o            # řetězec identifikátoru modelu
  temperature: 0.7
  max_tokens: 4096

# Konfigurace kanálů
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: ""

# Dovednosti a pluginy
skills:
  - web_search
  - calculator
  - weather

# Převod řeči na text
stt:
  provider: whisper
  model: whisper-1

# Systémový prompt
system_prompt: "You are a helpful assistant."

Nastavení jednotlivých hodnot

Místo editace celého souboru můžete nastavit jednotlivé konfigurační hodnoty z příkazového řádku:

bash

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

Toto je užitečné pro skriptování nebo rychlé změny bez otevírání editoru.

Early Access

Be first to build with AI

Y Build is the AI-era operating system for startups. Join the waitlist and get early access.

Nastavení kanálů

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

bash

# Povolení kanálu 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"

Běžný problém: WhatsApp vyžaduje URL webhooku. Musíte OpenClaw vystavit internetu pomocí reverzní proxy (nginx, Caddy) nebo tunelové služby (ngrok, Cloudflare Tunnel).

bash

# Nastavení URL webhooku
openclaw config set channels.whatsapp.webhook_url "https://your-domain.com/webhook/whatsapp"

Discord

Nastavení Discordu je jednodušší — potřebujete pouze token bota z Discord Developer Portalu.

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 Portalu povolený privilegovaný intent „Message Content", jinak nebude moci číst zprávy.

Telegram vyžaduje token bota od @BotFather:

bash

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

Telegram podporuje režim dotazování i webhooku. Dotazování je jednodušší pro vývoj (není třeba veřejná URL):

bash

openclaw config set channels.telegram.mode polling

Pro produkci použijte režim webhooku:

bash

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

Slack

Integrace Slack použí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.

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í (nedávejte ho 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 vyniká pro uživatele dbající na soukromí. Ollama vám umožňuje spouštět modely lokálně bez API klíčů a bez odchodu dat z vašeho počítače.

bash

# Nejprve nainstalujte Ollama
# https://ollama.ai

# Stáhněte model
ollama pull llama3.3

# Nakonfigurujte OpenClaw pro použití 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 připojit k Ollama, ujistěte se, že Ollama běží (ollama serve) a základní URL souhlasí. 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 používá API kompatibilní s 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-..."   # Použijte xAI klíč s poskytovatelem OpenAI

Běžné chyby konfigurace a jejich opravy

Chyba: "Unknown config key"

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

Toto obvykle znamená překlep v konfiguračním klíči. Zkontrolujte pravopis. Běžné chyby:

chanels → channels

providr → provider

telgram → telegram

Spusťte openclaw config show pro zobrazení všech platných klíčů.

Chyba: "Channel auto-enabled without credentials"

Oprava:

bash

# Explicitně zakažte kanály, které nepoužíváte
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 do konfiguračního souboru z bezpečnostních důvodů.

Oprava: Přidejte API klíč do 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 ověří 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í vyřešit problémy automaticky:

bash

openclaw doctor --fix

Toto zakáže kanály s chybějícími přihlašovacími údaji, opraví známé problémy formátování a navrhne ruční opravy problémů, které nelze vyřešit automaticky.

Pokročilá konfigurace

Vlastní dovednosti

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říkazový řádek:

bash

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

Konfigurace převodu řeči na text (STT)

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

yaml

stt:
  provider: whisper          # whisper, deepgram, google
  model: whisper-1
  language: auto             # automatická detekce nebo upřesněte "en", "es" atd.

bash

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

Integrace Tuya Smart Home

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"

Toto vám umožní ovládat světla, vypínače, termostaty a další zařízení Tuya pomocí 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
# nebo přepněte za běhu
openclaw --model fast

Často kladené dotazy

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

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

Ano. Nakonfigurujte Ollama jako poskytovatele modelu a použijte Telegram v režimu dotazování. Tím získáte plně lokálního, soukromého AI asistenta bez odchodu dat z vašeho počítače.

Jak aktualizuji OpenClaw?

bash

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

Po aktualizaci spusťte openclaw doctor pro kontrolu změn formátu konfigurace.

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

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

Jak resetuji konfiguraci na výchozí hodnoty?

bash

openclaw config reset

Toto přepíše váš konfigurační soubor výchozí šablonou. Pokud je potřeba, nejprve si zálohujte stávající konfiguraci.

Chcete něco jednoduššího?

Y Build se postará o celý stack — nasazení, produktová videa, AI SEO a analytika. Žádné konfigurační soubory. Žádný terminál. Prostě stavte a dodávejte. Začněte zdarma →

Zdroje:

Early Access

Be first to build with AI

Y Build is the AI-era operating system for startups. Join the waitlist and get early access.