OpenClaw Config Edit: Vollständiger Setup-Guide (2026)
Vollständige Anleitung zur Bearbeitung der OpenClaw-Konfiguration für WhatsApp, Discord, Telegram und Ollama. Copy-Paste-Befehle zum Konfigurieren von Kanälen, Modellen und Providern. Lösungen für häufige Konfigurationsfehler.
TL;DR
Schnellreferenz für die am häufigsten verwendeten OpenClaw-Konfigurationsbefehle:
# Den Konfigurations-Editor öffnen
openclaw config edit
# Einen spezifischen Wert setzen
openclaw config set channels.whatsapp.enabled true
openclaw config set model.provider openai
openclaw config set model.name gpt-4o
# Aktuelle Konfiguration anzeigen
openclaw config show
# Konfigurationsprobleme validieren und beheben
openclaw doctor
openclaw doctor --fix
# Auf Standardeinstellungen zurücksetzen
openclaw config reset
Was ist OpenClaw?
OpenClaw ist ein Open-Source-Framework für KI-Assistenten, das Large Language Models mit Messaging-Kanälen wie WhatsApp, Discord, Telegram und Slack verbindet. Es unterstützt mehrere Modell-Provider — OpenAI, Anthropic, Ollama (lokale Modelle), Google und mehr — und kann durch benutzerdefinierte Skills und Plugins erweitert werden.
Der Kern von OpenClaw ist sein Konfigurationssystem. Fast alles — welche Kanäle aktiv sind, welches Modell verwendet wird, welche Skills geladen sind — wird über Konfigurationsdateien gesteuert. Die Beherrschung von openclaw config edit ist der Schlüssel dazu, OpenClaw so zum Laufen zu bringen, wie Sie es möchten.
openclaw config edit: Die Grundlagen
Öffnen des Konfigurations-Editors
Der primäre Befehl zum Konfigurieren von OpenClaw lautet:
openclaw config edit
Dies öffnet Ihre Konfigurationsdatei in Ihrem Standard-Terminal-Editor (normalerweise nano, vim oder was auch immer unter $EDITOR eingestellt ist). Die Konfigurationsdatei befindet sich normalerweise unter ~/.openclaw/config.yaml oder ~/.config/openclaw/config.yaml, abhängig von Ihrer Installation.
Struktur der Konfigurationsdatei
Die OpenClaw-Konfigurationsdatei ist im YAML-Format und in Abschnitte unterteilt:
# Modellkonfiguration
model:
provider: openai # openai, anthropic, ollama, google
name: gpt-4o # Modell-Identifikations-String
temperature: 0.7
max_tokens: 4096
# Kanalkonfiguration
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 und Plugins
skills:
- web_search
- calculator
- weather
# Speech-to-text
stt:
provider: whisper
model: whisper-1
# System-Prompt
system_prompt: "You are a helpful assistant."
Einzelne Werte setzen
Anstatt die gesamte Datei zu bearbeiten, können Sie einzelne Konfigurationswerte über die Befehlszeile setzen:
openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6
openclaw config set model.temperature 0.5
Dies ist nützlich für Scripting oder schnelle Änderungen, ohne einen Editor öffnen zu müssen.
Kanäle einrichten
Die WhatsApp-Integration erfordert ein Meta Business-Konto und Zugriff auf die WhatsApp Business API.
# WhatsApp-Kanal aktivieren
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"
# Webhook-URL setzen
openclaw config set channels.whatsapp.webhook_url "https://your-domain.com/webhook/whatsapp"
Discord
Das Discord-Setup ist einfacher — Sie benötigen lediglich einen Bot-Token aus dem Discord Developer Portal.
openclaw config set channels.discord.enabled true
openclaw config set channels.discord.bot_token "YOUR_DISCORD_BOT_TOKEN"
Telegram
Telegram erfordert einen Bot-Token von @BotFather:
openclaw config set channels.telegram.enabled true
openclaw config set channels.telegram.bot_token "YOUR_TELEGRAM_BOT_TOKEN"
Telegram unterstützt sowohl den Polling- als auch den Webhook-Modus. Polling ist einfacher für die Entwicklung (keine öffentliche URL erforderlich):
openclaw config set channels.telegram.mode polling
Verwenden Sie für die Produktion den Webhook-Modus:
openclaw config set channels.telegram.mode webhook
openclaw config set channels.telegram.webhook_url "https://your-domain.com/webhook/telegram"
Slack
Die Slack-Integration verwendet den Socket Mode (empfohlen) oder die 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"
Der Socket Mode wird empfohlen, da er keine öffentliche URL erfordert.
Konfiguration der Modell-Provider
OpenAI
openclaw config set model.provider openai
openclaw config set model.name gpt-4o
Setzen Sie Ihren API-Key als Umgebungsvariable (speichern Sie ihn nicht in der Konfigurationsdatei):
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 (Lokale Modelle)
Hier glänzt OpenClaw für datenschutzbewusste Nutzer. Mit Ollama können Sie Modelle lokal ausführen, ohne dass API-Keys benötigt werden oder Daten Ihren Rechner verlassen.
# Zuerst Ollama installieren
# https://ollama.ai
# Ein Modell herunterladen
ollama pull llama3.3
# OpenClaw für die Nutzung von Ollama konfigurieren
openclaw config set model.provider ollama
openclaw config set model.name llama3.3
openclaw config set model.base_url "http://localhost:11434"
ollama serve) und die Base-URL übereinstimmt. Der Standard-Port von Ollama ist 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 verwendet eine OpenAI-kompatible API
openclaw config set model.name grok-4.1
openclaw config set model.base_url "https://api.x.ai/v1"
export OPENAI_API_KEY="xai-..." # Verwenden Sie den xAI-Key mit dem OpenAI-Provider
Häufige Konfigurationsfehler und Lösungen
Fehler: "Unknown config key"
Error: Unknown config key 'chanels.whatsapp.enabled'
Dies deutet normalerweise auf einen Tippfehler im Konfigurationsschlüssel hin. Überprüfen Sie die Schreibweise. Häufige Fehler:
chanels→channelsprovidr→providertelgram→telegram
Führen Sie
openclaw config show aus, um alle gültigen Schlüssel zu sehen.
Fehler: "Channel auto-enabled without credentials"
Einige OpenClaw-Versionen aktivieren Kanäle automatisch, wenn Sie Anmeldedaten festlegen, selbst wenn Sie diese nicht explizit aktiviert haben. Dies kann zu Fehlern beim Start führen, wenn die Anmeldedaten unvollständig sind.
Lösung:# Deaktivieren Sie explizit Kanäle, die Sie nicht verwenden
openclaw config set channels.whatsapp.enabled false
openclaw config set channels.discord.enabled false
openclaw config set channels.slack.enabled false
Fehler: "Model provider not configured"
Error: Model provider 'anthropic' requires ANTHROPIC_API_KEY
Sie müssen die entsprechende Umgebungsvariable setzen. OpenClaw speichert API-Keys aus Sicherheitsgründen absichtlich nicht in der Konfigurationsdatei.
Lösung: Fügen Sie den API-Key zu Ihrem Shell-Profil hinzu (~/.bashrc, ~/.zshrc) oder verwenden Sie eine .env-Datei:
echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc
source ~/.zshrc
Verwendung von openclaw doctor
Der Befehl openclaw doctor validiert Ihre gesamte Konfiguration und meldet Probleme:
openclaw doctor
Beispiel für die Ausgabe:
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.
Das Flag --fix versucht, Probleme automatisch zu beheben:
openclaw doctor --fix
Dies deaktiviert Kanäle mit fehlenden Anmeldedaten, korrigiert bekannte Formatierungsprobleme und schlägt manuelle Korrekturen für Probleme vor, die nicht automatisch gelöst werden können.
Erweiterte Konfiguration
Benutzerdefinierte Skills
OpenClaw unterstützt benutzerdefinierte Skills (Plugins), die die Fähigkeiten des Assistenten erweitern:
skills:
- web_search
- calculator
- weather
- custom_skill:
path: ./my-skills/custom_tool.py
config:
api_key_env: CUSTOM_API_KEY
Oder über die Befehlszeile:
openclaw skills add web_search
openclaw skills add ./my-skills/custom_tool.py
openclaw skills list
openclaw skills remove calculator
Speech-to-Text (STT) Konfiguration
Für die Unterstützung von Sprachnachrichten auf WhatsApp und Telegram:
stt:
provider: whisper # whisper, deepgram, google
model: whisper-1
language: auto # Automatische Erkennung oder Angabe von "en", "de", etc.
openclaw config set stt.provider whisper
openclaw config set stt.model whisper-1
Tuya Smart Home Integration
OpenClaw kann Tuya-kompatible Smart-Home-Geräte steuern:
tuya:
enabled: true
access_id: "YOUR_TUYA_ACCESS_ID"
access_key: "YOUR_TUYA_ACCESS_KEY"
endpoint: "https://openapi.tuyaus.com"
Dies ermöglicht es Ihnen, Lichter, Schalter, Thermostate und andere Tuya-Geräte über Befehle in natürlicher Sprache in jedem verbundenen Kanal zu steuern.
Mehrere Modellkonfigurationen
Sie können Modell-Presets definieren und zwischen ihnen wechseln:
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
# oder zur Laufzeit wechseln
openclaw --model fast
Häufig gestellte Fragen (FAQ)
Wo wird die OpenClaw-Konfigurationsdatei gespeichert?
Der Standardort ist ~/.openclaw/config.yaml. Bei einigen Installationen kann sie sich unter ~/.config/openclaw/config.yaml befinden. Führen Sie openclaw config show --path aus, um den genauen Ort zu sehen.
Kann ich OpenClaw ohne Cloud-API verwenden?
Ja. Konfigurieren Sie Ollama als Ihren Modell-Provider und verwenden Sie Telegram im Polling-Modus. Dies bietet Ihnen einen vollständig lokalen, privaten KI-Assistenten, bei dem keine Daten Ihren Rechner verlassen.
Wie aktualisiere ich OpenClaw?
pip install --upgrade openclaw
# oder
npm update -g openclaw
Führen Sie nach dem Update openclaw doctor aus, um auf Änderungen im Konfigurationsformat zu prüfen.
Kann ich mehrere Kanäle gleichzeitig betreiben?
Ja. Aktivieren Sie so viele Kanäle, wie Sie möchten — OpenClaw verarbeitet diese gleichzeitig. Jeder Kanal nutzt dieselbe Modell- und Skill-Konfiguration.
Wie setze ich meine Konfiguration auf die Standardwerte zurück?
openclaw config reset
Dies überschreibt Ihre Konfigurationsdatei mit der Standardvorlage. Sichern Sie bei Bedarf zuerst Ihre bestehende Konfiguration.
Lust auf etwas Einfacheres?
OpenClaw ist leistungsstark, erfordert jedoch den Umgang mit dem Terminal und manuelle Konfiguration. Wenn Sie KI-gestützte Produkte entwickeln und veröffentlichen möchten, ohne Konfigurationsdateien, Modell-Provider und Kanal-Integrationen selbst zu verwalten:
Y Build kümmert sich um den gesamten Stack — Deployment, Produktvideos, KI-SEO und Analytics. Keine Konfigurationsdateien. Kein Terminal. Einfach bauen und veröffentlichen. Kostenlos starten →Quellen: