OpenClaw Yapılandırma Düzenleme: Tam Kurulum Kılavuzu (2026)
WhatsApp, Discord, Telegram ve Ollama için eksiksiz OpenClaw yapılandırma düzenleme kılavuzu. Kanal, model ve sağlayıcıları yapılandırmak için komutları kopyalayıp yapıştırın. Yaygın yapılandırma hataları giderildi.
Kısaca (TL;DR)
En yaygın OpenClaw yapılandırma komutları için hızlı referans:
# Yapılandırma düzenleyiciyi açın
openclaw config edit
# Belirli bir değeri ayarlayın
openclaw config set channels.whatsapp.enabled true
openclaw config set model.provider openai
openclaw config set model.name gpt-4o
# Mevcut yapılandırmayı görüntüleyin
openclaw config show
# Yapılandırma sorunlarını doğrulayın ve düzeltin
openclaw doctor
openclaw doctor --fix
# Varsayılan ayarlara sıfırlayın
openclaw config reset
OpenClaw Nedir?
OpenClaw; büyük dil modellerini WhatsApp, Discord, Telegram ve Slack gibi mesajlaşma kanallarına bağlayan açık kaynaklı bir yapay zeka asistanı çerçevesidir (framework). OpenAI, Anthropic, Ollama (yerel modeller), Google ve daha fazlası gibi birden fazla model sağlayıcısını destekler; ayrıca özel beceriler (skills) ve eklentilerle genişletilebilir.
OpenClaw'un çekirdeği yapılandırma sistemidir. Neredeyse her şey — hangi kanalların aktif olduğu, hangi modelin kullanılacağı, hangi becerilerin yükleneceği — yapılandırma dosyaları aracılığıyla kontrol edilir. openclaw config edit komutunda ustalaşmak, OpenClaw'u tam istediğiniz gibi çalıştırmanın anahtarıdır.
openclaw config edit: Temel Bilgiler
Yapılandırma Düzenleyiciyi Açma
OpenClaw'u yapılandırmak için kullanılan birincil komut şudur:
openclaw config edit
Bu komut, yapılandırma dosyanızı varsayılan terminal düzenleyicinizde (genellikle nano, vim veya $EDITOR değişkenine ne atanmışsa) açar. Yapılandırma dosyası, kurulumunuza bağlı olarak genellikle ~/.openclaw/config.yaml veya ~/.config/openclaw/config.yaml dizininde bulunur.
Yapılandırma Dosyası Yapısı
OpenClaw yapılandırma dosyası YAML formatındadır ve bölümlere ayrılmıştır:
# Model yapılandırması
model:
provider: openai # openai, anthropic, ollama, google
name: gpt-4o # model tanımlayıcı dize
temperature: 0.7
max_tokens: 4096
# Kanal yapılandırması
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: ""
# Beceriler ve eklentiler
skills:
- web_search
- calculator
- weather
# Konuşmadan metne (Speech-to-text)
stt:
provider: whisper
model: whisper-1
# Sistem istemi
system_prompt: "Sen yardımsever bir asistansın."
Bireysel Değerleri Ayarlama
Tüm dosyayı düzenlemek yerine, komut satırından bireysel yapılandırma değerlerini ayarlayabilirsiniz:
openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6
openclaw config set model.temperature 0.5
Bu yöntem, bir düzenleyici açmadan hızlı değişiklikler yapmak veya betik (scripting) yazmak için kullanışlıdır.
Kanalları Kurma
WhatsApp entegrasyonu bir Meta Business hesabı ve WhatsApp Business API erişimi gerektirir.
# WhatsApp kanalını etkinleştirin
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'sini ayarlayın
openclaw config set channels.whatsapp.webhook_url "https://your-domain.com/webhook/whatsapp"
Discord
Discord kurulumu daha basittir — Discord Geliştirici Portalı'ndan bir bot token'ı almanız yeterlidir.
openclaw config set channels.discord.enabled true
openclaw config set channels.discord.bot_token "YOUR_DISCORD_BOT_TOKEN"
Telegram
Telegram, @BotFather'dan alınan bir bot token'ı gerektirir:
openclaw config set channels.telegram.enabled true
openclaw config set channels.telegram.bot_token "YOUR_TELEGRAM_BOT_TOKEN"
Telegram hem polling hem de webhook modlarını destekler. Polling, geliştirme aşamasında daha kolaydır (genel bir URL gerektirmez):
openclaw config set channels.telegram.mode polling
Prodüksiyon için webhook modunu kullanın:
openclaw config set channels.telegram.mode webhook
openclaw config set channels.telegram.webhook_url "https://your-domain.com/webhook/telegram"
Slack
Slack entegrasyonu Socket Mode (önerilen) veya Events API kullanır:
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, genel bir URL gerektirmediği için önerilir.
Model Sağlayıcılarını Yapılandırma
OpenAI
openclaw config set model.provider openai
openclaw config set model.name gpt-4o
API anahtarınızı bir ortam değişkeni (environment variable) olarak ayarlayın (yapılandırma dosyasına koymayın):
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 (Yerel Modeller)
Burası OpenClaw'un gizliliğe önem veren kullanıcılar için öne çıktığı yerdir. Ollama, modelleri herhangi bir API anahtarı olmadan veya veriler makinenizden çıkmadan yerel olarak çalıştırmanıza olanak tanır.
# Önce Ollama'yı kurun
# https://ollama.ai
# Bir model indirin
ollama pull llama3.3
# OpenClaw'u Ollama kullanacak şekilde yapılandırın
openclaw config set model.provider ollama
openclaw config set model.name llama3.3
openclaw config set model.base_url "http://localhost:11434"
ollama serve) ve temel URL'nin (base_url) eşleştiğinden emin olun. Varsayılan Ollama portu 11434'tür.
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, OpenAI uyumlu API kullanır
openclaw config set model.name grok-4.1
openclaw config set model.base_url "https://api.x.ai/v1"
export OPENAI_API_KEY="xai-..." # OpenAI sağlayıcısıyla xAI anahtarını kullanın
Yaygın Yapılandırma Hataları ve Çözümleri
Hata: "Unknown config key"
Error: Unknown config key 'chanels.whatsapp.enabled'
Bu genellikle yapılandırma anahtarında bir yazım hatası olduğu anlamına gelir. Yazımınızı kontrol edin. Yaygın hatalar:
chanels→channelsprovidr→providertelgram→telegram
Tüm geçerli anahtarları görmek için
openclaw config show komutunu çalıştırın.
Hata: "Channel auto-enabled without credentials"
Bazı OpenClaw sürümleri, kimlik bilgilerini ayarladığınızda, bunları açıkça etkinleştirmemiş olsanız bile kanalları otomatik olarak etkinleştirir. Kimlik bilgileri eksikse bu durum başlatma hatalarına neden olabilir.
Çözüm:# Kullanmadığınız kanalları açıkça devre dışı bırakın
openclaw config set channels.whatsapp.enabled false
openclaw config set channels.discord.enabled false
openclaw config set channels.slack.enabled false
Hata: "Model provider not configured"
Error: Model provider 'anthropic' requires ANTHROPIC_API_KEY
İlgili ortam değişkenini ayarlamanız gerekir. OpenClaw, güvenlik nedenleriyle API anahtarlarını yapılandırma dosyasında kasıtlı olarak saklamaz.
Çözüm: API anahtarını kabuk profilinize (~/.bashrc, ~/.zshrc) ekleyin veya bir .env dosyası kullanın:
echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc
source ~/.zshrc
openclaw doctor Kullanımı
openclaw doctor komutu tüm yapılandırmanızı doğrular ve sorunları raporlar:
openclaw doctor
Çıktı örneği:
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.
--fix bayrağı sorunları otomatik olarak çözmeye çalışır:
openclaw doctor --fix
Bu komut, kimlik bilgileri eksik olan kanalları devre dışı bırakır, bilinen biçimlendirme hatalarını düzeltir ve otomatik olarak çözemediği sorunlar için manuel çözümler önerir.
Gelişmiş Yapılandırma
Özel Beceriler (Custom Skills)
OpenClaw, asistanın yeteneklerini genişleten özel becerileri (eklentileri) destekler:
skills:
- web_search
- calculator
- weather
- custom_skill:
path: ./my-skills/custom_tool.py
config:
api_key_env: CUSTOM_API_KEY
Veya komut satırı üzerinden:
openclaw skills add web_search
openclaw skills add ./my-skills/custom_tool.py
openclaw skills list
openclaw skills remove calculator
Konuşmadan Metne (STT) Yapılandırması
WhatsApp ve Telegram'daki sesli mesaj desteği için:
stt:
provider: whisper # whisper, deepgram, google
model: whisper-1
language: auto # otomatik algıla veya "tr", "en" vb. belirtin
openclaw config set stt.provider whisper
openclaw config set stt.model whisper-1
Tuya Akıllı Ev Entegrasyonu
OpenClaw, Tuya uyumlu akıllı ev cihazlarını kontrol edebilir:
tuya:
enabled: true
access_id: "YOUR_TUYA_ACCESS_ID"
access_key: "YOUR_TUYA_ACCESS_KEY"
endpoint: "https://openapi.tuyaus.com"
Bu, herhangi bir bağlı kanal üzerinden doğal dil komutlarıyla ışıkları, anahtarları, termostatları ve diğer Tuya cihazlarını kontrol etmenizi sağlar.
Çoklu Model Yapılandırmaları
Model ön ayarları tanımlayabilir ve bunlar arasında geçiş yapabilirsiniz:
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
# veya çalışma zamanında geçiş yapın
openclaw --model fast
Sıkça Sorulan Sorular
OpenClaw yapılandırma dosyası nerede saklanır?
Varsayılan konum ~/.openclaw/config.yaml dizinidir. Bazı kurulumlarda ~/.config/openclaw/config.yaml altında olabilir. Tam konumu görmek için openclaw config show --path komutunu çalıştırın.
OpenClaw'u herhangi bir bulut API'si olmadan kullanabilir miyim?
Evet. Model sağlayıcınız olarak Ollama'yı yapılandırın ve Telegram'ı polling modunda kullanın. Bu, verilerinizin makinenizden dışarı çıkmadığı, tamamen yerel ve özel bir yapay zeka asistanı sağlar.
OpenClaw'u nasıl güncellerim?
pip install --upgrade openclaw
# veya
npm update -g openclaw
Güncellemeden sonra, yapılandırma formatı değişikliklerini kontrol etmek için openclaw doctor komutunu çalıştırın.
Aynı anda birden fazla kanalı çalıştırabilir miyim?
Evet. İstediğiniz kadar kanalı etkinleştirebilirsiniz — OpenClaw bunları eşzamanlı olarak yönetir. Her kanal aynı model ve beceri yapılandırmasını paylaşır.
Yapılandırmamı varsayılan ayarlara nasıl sıfırlarım?
openclaw config reset
Bu işlem, yapılandırma dosyanızın üzerine varsayılan şablonu yazar. Gerekirse önce mevcut yapılandırmanızı yedekleyin.
Daha Basit Bir Şey mi İstiyorsunuz?
OpenClaw güçlüdür ancak terminal kullanımı ve manuel yapılandırma gerektirir. Yapılandırma dosyalarıyla, model sağlayıcılarıyla ve kanal entegrasyonlarıyla uğraşmadan yapay zeka destekli ürünler oluşturmak ve yayınlamak istiyorsanız:
Y Build tüm süreci yönetir — dağıtım (deployment), ürün videoları, yapay zeka destekli SEO ve analitik. Yapılandırma dosyası yok. Terminal yok. Sadece inşa edin ve yayınlayın. Ücretsiz başlayın →Kaynaklar: