OpenClaw Config Edit: Volledige Installatiegids (2026)

Q: Waar wordt het OpenClaw-configuratiebestand opgeslagen?

De standaardlocatie is ~/.openclaw/config.yaml. Bij sommige installaties kan dit ~/.config/openclaw/config.yaml zijn. Voer openclaw config show --path uit om de exacte locatie te zien.

Q: Hoe update ik OpenClaw?

```bash pip install --upgrade openclaw

Q: Hoe zet ik mijn configuratie terug naar de standaardinstellingen?

```bash openclaw config reset ```

TL;DR

Snelle referentie voor de meest voorkomende OpenClaw-configuratiecommando's:

bash

# Open de configuratie-editor
openclaw config edit

# Stel een specifieke waarde in
openclaw config set channels.whatsapp.enabled true
openclaw config set model.provider openai
openclaw config set model.name gpt-4o

# Bekijk de huidige configuratie
openclaw config show

# Valideer en herstel configuratieproblemen
openclaw doctor
openclaw doctor --fix

# Terugzetten naar standaardinstellingen
openclaw config reset

Wat is OpenClaw?

OpenClaw is een open-source AI-assistent framework dat grote taalmodellen (LLM's) verbindt met berichtenkanalen zoals WhatsApp, Discord, Telegram en Slack. Het ondersteunt meerdere modelproviders — OpenAI, Anthropic, Ollama (lokale modellen), Google en meer — en kan worden uitgebreid met aangepaste skills en plugins.

De kern van OpenClaw is het configuratiesysteem. Bijna alles — welke kanalen actief zijn, welk model wordt gebruikt, welke skills zijn geladen — wordt beheerd via configuratiebestanden. Het beheersen van openclaw config edit is de sleutel om OpenClaw precies zo te laten werken als jij wilt.

openclaw config edit: De basis

De configuratie-editor openen

Het primaire commando om OpenClaw te configureren is:

bash

openclaw config edit

Dit opent je configuratiebestand in de standaard editor van je terminal (meestal nano, vim, of wat er is ingesteld in $EDITOR). Het configuratiebestand bevindt zich doorgaans op ~/.openclaw/config.yaml of ~/.config/openclaw/config.yaml, afhankelijk van je installatie.

Structuur van het configuratiebestand

Het OpenClaw-configuratiebestand is geformatteerd in YAML en verdeeld in secties:

yaml

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

# Kanaal configuratie
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 en plugins
skills:
  - web_search
  - calculator
  - weather

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

# Systeemprompt
system_prompt: "You are a helpful assistant."

Individuele waarden instellen

In plaats van het hele bestand te bewerken, kun je individuele configuratiewaarden instellen via de opdrachtregel:

bash

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

Dit is handig voor automatisering of snelle wijzigingen zonder een editor te openen.

Kanalen instellen

WhatsApp-integratie vereist een Meta Business-account en toegang tot de WhatsApp Business API.

bash

# Schakel WhatsApp-kanaal in
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"

Veelvoorkomend probleem: WhatsApp vereist een webhook-URL. Je moet OpenClaw aan het internet blootstellen via een reverse proxy (nginx, Caddy) of een tunnel-service (ngrok, Cloudflare Tunnel).

bash

# Stel de webhook-URL in
openclaw config set channels.whatsapp.webhook_url "https://your-domain.com/webhook/whatsapp"

Discord

De installatie voor Discord is eenvoudiger — je hebt alleen een bot-token nodig van de Discord Developer Portal.

bash

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

Tip: Zorg ervoor dat je Discord-bot de "Message Content" privileged intent heeft ingeschakeld in de Developer Portal, anders kan hij geen berichten lezen.

Telegram vereist een bot-token van @BotFather:

bash

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

Telegram ondersteunt zowel polling- als webhook-modi. Polling is gemakkelijker voor ontwikkeling (geen publieke URL nodig):

bash

openclaw config set channels.telegram.mode polling

Gebruik voor productie de webhook-modus:

bash

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

Slack

Slack-integratie maakt gebruik van Socket Mode (aanbevolen) of de 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 wordt aanbevolen omdat er geen publieke URL voor nodig is.

Modelproviders configureren

OpenAI

bash

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

Stel je API-key in als een omgevingsvariabele (zet deze niet in het configuratiebestand):

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 (Lokale modellen)

Dit is waar OpenClaw uitblinkt voor privacybewuste gebruikers. Met Ollama kun je modellen lokaal draaien zonder dat er API-keys of gegevens je machine verlaten.

bash

# Installeer eerst Ollama
# https://ollama.ai

# Download een model
ollama pull llama3.3

# Configureer OpenClaw om Ollama te gebruiken
openclaw config set model.provider ollama
openclaw config set model.name llama3.3
openclaw config set model.base_url "http://localhost:11434"

Veelvoorkomend probleem: Als OpenClaw geen verbinding kan maken met Ollama, controleer dan of Ollama draait (ollama serve) en of de base_url overeenkomt. De standaardpoort van Ollama is 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 gebruikt een OpenAI-compatibele 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-..."   # Gebruik xAI-sleutel met de OpenAI provider

Veelvoorkomende configuratiefouten en oplossingen

Fout: "Unknown config key"

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

Dit betekent meestal een typefout in de configuratiesleutel. Controleer de spelling. Veelgemaakte fouten:

chanels → channels

providr → provider

telgram → telegram

Voer openclaw config show uit om alle geldige sleutels te zien.

Fout: "Channel auto-enabled without credentials"

Sommige OpenClaw-versies schakelen kanalen automatisch in wanneer je inloggegevens instelt, zelfs als je ze niet expliciet hebt geactiveerd. Dit kan leiden tot fouten bij het opstarten als de gegevens onvolledig zijn.

Oplossing:

bash

# Schakel kanalen die je niet gebruikt expliciet uit
openclaw config set channels.whatsapp.enabled false
openclaw config set channels.discord.enabled false
openclaw config set channels.slack.enabled false

Fout: "Model provider not configured"

Error: Model provider 'anthropic' requires ANTHROPIC_API_KEY

Je moet de bijbehorende omgevingsvariabele instellen. OpenClaw slaat om veiligheidsredenen opzettelijk geen API-keys op in het configuratiebestand.

Oplossing: Voeg de API-key toe aan je shell-profiel (~/.bashrc, ~/.zshrc) of gebruik een .env bestand:

bash

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

openclaw doctor gebruiken

Het commando openclaw doctor valideert je volledige configuratie en rapporteert problemen:

bash

openclaw doctor

Voorbeeld van de output:

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.

De --fix vlag probeert problemen automatisch op te lossen:

bash

openclaw doctor --fix

Dit zal kanalen met ontbrekende inloggegevens uitschakelen, bekende formatteringsfouten corrigeren en handmatige oplossingen voorstellen voor problemen die niet automatisch kunnen worden verholpen.

Geavanceerde configuratie

Custom Skills

OpenClaw ondersteunt aangepaste skills (plugins) die de mogelijkheden van de assistent uitbreiden:

yaml

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

Of via de opdrachtregel:

bash

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

Speech-to-Text (STT) configuratie

Voor ondersteuning van spraakberichten op WhatsApp en Telegram:

yaml

stt:
  provider: whisper          # whisper, deepgram, google
  model: whisper-1
  language: auto             # auto-detectie of specificeer "nl", "en", etc.

bash

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

Tuya Smart Home integratie

OpenClaw kan Tuya-compatibele smart home-apparaten bedienen:

yaml

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

Hiermee kun je lampen, schakelaars, thermostaten en andere Tuya-apparaten bedienen via natuurlijke taalcommando's in elk verbonden kanaal.

Meerdere modelconfiguraties

Je kunt model-presets definiëren en tussen deze schakelen:

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
# of switch tijdens runtime
openclaw --model fast

Veelgestelde vragen (FAQ)

Waar wordt het OpenClaw-configuratiebestand opgeslagen?

De standaardlocatie is ~/.openclaw/config.yaml. Bij sommige installaties kan dit ~/.config/openclaw/config.yaml zijn. Voer openclaw config show --path uit om de exacte locatie te zien.

Kan ik OpenClaw gebruiken zonder cloud-API?

Ja. Configureer Ollama als je modelprovider en gebruik Telegram in polling-modus. Dit geeft je een volledig lokale, private AI-assistent waarbij geen gegevens je machine verlaten.

Hoe update ik OpenClaw?

bash

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

Voer na het updaten openclaw doctor uit om te controleren op wijzigingen in het configuratieformaat.

Kan ik meerdere kanalen tegelijkertijd draaien?

Ja. Schakel zoveel kanalen in als je wilt — OpenClaw verwerkt ze gelijktijdig. Elk kanaal deelt dezelfde model- en skills-configuratie.

Hoe zet ik mijn configuratie terug naar de standaardinstellingen?

bash

openclaw config reset

Dit overschrijft je configuratiebestand met het standaardsjabloon. Maak indien nodig eerst een back-up van je bestaande configuratie.

Wilt u iets simpelers?

OpenClaw is krachtig, maar vereist ervaring met de terminal en handmatige configuratie. Als u AI-gestuurde producten wilt bouwen en lanceren zonder zelf configuratiebestanden, modelproviders en kanaalintegraties te beheren:

Y Build beheert de volledige stack — implementatie, productvideo's, AI SEO en analytics. Geen configuratiebestanden. Geen terminal. Gewoon bouwen en lanceren. Start gratis →

Bronnen:

TL;DR

Snelle referentie voor de meest voorkomende OpenClaw-configuratiecommando's:

bash

# Open de configuratie-editor
openclaw config edit

# Stel een specifieke waarde in
openclaw config set channels.whatsapp.enabled true
openclaw config set model.provider openai
openclaw config set model.name gpt-4o

# Bekijk de huidige configuratie
openclaw config show

# Valideer en herstel configuratieproblemen
openclaw doctor
openclaw doctor --fix

# Terugzetten naar standaardinstellingen
openclaw config reset

Wat is OpenClaw?

openclaw config edit: De basis

De configuratie-editor openen

Het primaire commando om OpenClaw te configureren is:

bash

openclaw config edit

Structuur van het configuratiebestand

Het OpenClaw-configuratiebestand is geformatteerd in YAML en verdeeld in secties:

yaml

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

# Kanaal configuratie
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 en plugins
skills:
  - web_search
  - calculator
  - weather

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

# Systeemprompt
system_prompt: "You are a helpful assistant."

Individuele waarden instellen

In plaats van het hele bestand te bewerken, kun je individuele configuratiewaarden instellen via de opdrachtregel:

bash

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

Dit is handig voor automatisering of snelle wijzigingen zonder een editor te openen.

Kanalen instellen

WhatsApp-integratie vereist een Meta Business-account en toegang tot de WhatsApp Business API.

bash

# Schakel WhatsApp-kanaal in
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"

Veelvoorkomend probleem: WhatsApp vereist een webhook-URL. Je moet OpenClaw aan het internet blootstellen via een reverse proxy (nginx, Caddy) of een tunnel-service (ngrok, Cloudflare Tunnel).

bash

# Stel de webhook-URL in
openclaw config set channels.whatsapp.webhook_url "https://your-domain.com/webhook/whatsapp"

Discord

De installatie voor Discord is eenvoudiger — je hebt alleen een bot-token nodig van de Discord Developer Portal.

bash

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

Tip: Zorg ervoor dat je Discord-bot de "Message Content" privileged intent heeft ingeschakeld in de Developer Portal, anders kan hij geen berichten lezen.

Telegram vereist een bot-token van @BotFather:

bash

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

Telegram ondersteunt zowel polling- als webhook-modi. Polling is gemakkelijker voor ontwikkeling (geen publieke URL nodig):

bash

openclaw config set channels.telegram.mode polling

Gebruik voor productie de webhook-modus:

bash

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

Slack

Slack-integratie maakt gebruik van Socket Mode (aanbevolen) of de 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 wordt aanbevolen omdat er geen publieke URL voor nodig is.

Modelproviders configureren

OpenAI

bash

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

Stel je API-key in als een omgevingsvariabele (zet deze niet in het configuratiebestand):

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 (Lokale modellen)

Dit is waar OpenClaw uitblinkt voor privacybewuste gebruikers. Met Ollama kun je modellen lokaal draaien zonder dat er API-keys of gegevens je machine verlaten.

bash

# Installeer eerst Ollama
# https://ollama.ai

# Download een model
ollama pull llama3.3

# Configureer OpenClaw om Ollama te gebruiken
openclaw config set model.provider ollama
openclaw config set model.name llama3.3
openclaw config set model.base_url "http://localhost:11434"

Veelvoorkomend probleem: Als OpenClaw geen verbinding kan maken met Ollama, controleer dan of Ollama draait (ollama serve) en of de base_url overeenkomt. De standaardpoort van Ollama is 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 gebruikt een OpenAI-compatibele 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-..."   # Gebruik xAI-sleutel met de OpenAI provider

Veelvoorkomende configuratiefouten en oplossingen

Fout: "Unknown config key"

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

Dit betekent meestal een typefout in de configuratiesleutel. Controleer de spelling. Veelgemaakte fouten:

chanels → channels

providr → provider

telgram → telegram

Voer openclaw config show uit om alle geldige sleutels te zien.

Fout: "Channel auto-enabled without credentials"

Oplossing:

bash

# Schakel kanalen die je niet gebruikt expliciet uit
openclaw config set channels.whatsapp.enabled false
openclaw config set channels.discord.enabled false
openclaw config set channels.slack.enabled false

Fout: "Model provider not configured"

Error: Model provider 'anthropic' requires ANTHROPIC_API_KEY

Je moet de bijbehorende omgevingsvariabele instellen. OpenClaw slaat om veiligheidsredenen opzettelijk geen API-keys op in het configuratiebestand.

Oplossing: Voeg de API-key toe aan je shell-profiel (~/.bashrc, ~/.zshrc) of gebruik een .env bestand:

bash

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

openclaw doctor gebruiken

Het commando openclaw doctor valideert je volledige configuratie en rapporteert problemen:

bash

openclaw doctor

Voorbeeld van de output:

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.

De --fix vlag probeert problemen automatisch op te lossen:

bash

openclaw doctor --fix

Dit zal kanalen met ontbrekende inloggegevens uitschakelen, bekende formatteringsfouten corrigeren en handmatige oplossingen voorstellen voor problemen die niet automatisch kunnen worden verholpen.

Geavanceerde configuratie

Custom Skills

OpenClaw ondersteunt aangepaste skills (plugins) die de mogelijkheden van de assistent uitbreiden:

yaml

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

Of via de opdrachtregel:

bash

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

Speech-to-Text (STT) configuratie

Voor ondersteuning van spraakberichten op WhatsApp en Telegram:

yaml

stt:
  provider: whisper          # whisper, deepgram, google
  model: whisper-1
  language: auto             # auto-detectie of specificeer "nl", "en", etc.

bash

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

Tuya Smart Home integratie

OpenClaw kan Tuya-compatibele smart home-apparaten bedienen:

yaml

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

Hiermee kun je lampen, schakelaars, thermostaten en andere Tuya-apparaten bedienen via natuurlijke taalcommando's in elk verbonden kanaal.

Meerdere modelconfiguraties

Je kunt model-presets definiëren en tussen deze schakelen:

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
# of switch tijdens runtime
openclaw --model fast

Veelgestelde vragen (FAQ)

Waar wordt het OpenClaw-configuratiebestand opgeslagen?

De standaardlocatie is ~/.openclaw/config.yaml. Bij sommige installaties kan dit ~/.config/openclaw/config.yaml zijn. Voer openclaw config show --path uit om de exacte locatie te zien.

Kan ik OpenClaw gebruiken zonder cloud-API?

Ja. Configureer Ollama als je modelprovider en gebruik Telegram in polling-modus. Dit geeft je een volledig lokale, private AI-assistent waarbij geen gegevens je machine verlaten.

Hoe update ik OpenClaw?

bash

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

Voer na het updaten openclaw doctor uit om te controleren op wijzigingen in het configuratieformaat.

Kan ik meerdere kanalen tegelijkertijd draaien?

Ja. Schakel zoveel kanalen in als je wilt — OpenClaw verwerkt ze gelijktijdig. Elk kanaal deelt dezelfde model- en skills-configuratie.

Hoe zet ik mijn configuratie terug naar de standaardinstellingen?

bash

openclaw config reset

Dit overschrijft je configuratiebestand met het standaardsjabloon. Maak indien nodig eerst een back-up van je bestaande configuratie.

Wilt u iets simpelers?

Y Build beheert de volledige stack — implementatie, productvideo's, AI SEO en analytics. Geen configuratiebestanden. Geen terminal. Gewoon bouwen en lanceren. Start gratis →

Bronnen: