OpenClaw Guide: Build Your AI Assistant

Özet (TL;DR)

• OpenClaw, 135 binden fazla GitHub yıldızına sahip açık kaynaklı bir yapay zeka asistanıdır.
• Makinenizde yerel (locally) olarak çalışır — verileriniz gizli kalır.
• WhatsApp, Telegram, Discord, Slack, iMessage ve daha fazlası üzerinden bağlanın.
• Otomasyon, kodlama, akıllı ev ve daha fazlası için 3.000'den fazla topluluk yeteneği (skills) mevcuttur.
• Ücretsizdir (sadece yapay zeka API token'ları için ödeme yaparsınız, genellikle aylık 10-50 dolar arası).
• Kurulum bu rehberle yaklaşık 30 dakika sürer.

OpenClaw Nedir?

OpenClaw (eski adıyla Clawdbot, ardından Moltbot), 2026'nın en popüler açık kaynaklı yapay zeka projesidir. Şunları yapabilen kişisel bir yapay zeka asistanıdır:

• Kendi bilgisayarınızda veya sunucunuzda çalışır.
• Favori mesajlaşma uygulamalarınıza (WhatsApp, Telegram, Discord vb.) bağlanır.
• Dosya sisteminize, terminalinize ve tarayıcınıza tam erişime sahiptir.
• Kişisel bir asistan gibi görevleri otomatize edebilir.

Yolculuk: Clawdbot → Moltbot → OpenClaw

Projenin isim yolculuğu oldukça hareketli geçti:

Adına ne derseniz deyin, işlevsellik aynı kalıyor — yerel olarak çalışan inanılmaz derecede güçlü bir yapay zeka asistanı.

Neden OpenClaw?

ChatGPT / Claude Web'e Karşı

Diğer Yapay Zeka Ajanlarına Karşı

OpenClaw'un vurucu özellikleri:

1. Çok kanallı gelen kutusu: WhatsApp, Telegram, Discord, Slack, iMessage ve 12'den fazla platformdan erişilebilen tek bir yapay zeka.
2. Kalıcı bellek: Konuşmalar boyunca bağlamı hatırlar.
3. Yetenek ekosistemi: ClawHub üzerinden 3.000'den fazla topluluk eklentisi.
4. Modelden bağımsız: Claude, GPT, Gemini, DeepSeek, yerel Ollama modelleri vb. ile çalışır.
5. Açık kaynak: MIT lisansı, tamamen denetlenebilir kod.

Ön Koşullar

Başlamadan önce şunlara sahip olduğunuzdan emin olun:

• [ ] Bir bilgisayar (Mac, WSL2 ile Windows veya Linux)
• [ ] Node.js v22+ yüklü (buradan indirin)
• [ ] Bir yapay zeka API anahtarı (Anthropic Claude, OpenAI veya diğerleri)
• [ ] Yaklaşık 30 dakika zaman

Donanım Gereksinimleri

Kurulum Yöntemleri

Yöntem 1: Tek Satırda Kurulum (Önerilen)

Başlamak için en hızlı yol:

curl -fsSL https://openclaw.bot/install.sh | bash

Bu betik şunları yapacaktır:

1. Sistem gereksinimlerinizi kontrol eder.


2. OpenClaw uygulamasını kurar.


3. Kurulum sihirbazını (onboarding wizard) başlatır.

Yöntem 2: Docker (Sunucular için Önerilen)

Konteyner yapısında kurulumu tercih ediyorsanız:

# Depoyu klonlayın
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# Docker kurulumunu çalıştırın
./docker-setup.sh

Docker kurulumu iki önemli dizin oluşturur:

• ~/.openclaw/ — Yapılandırma, bellek, API anahtarları.


• ~/openclaw/workspace/ — Yapay zeka ajanının erişebildiği dosyalar.

Yöntem 3: Kaynaktan Derleme

Tam kontrol isteyen geliştiriciler için:

# Depoyu klonlayın
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# Bağımlılıkları yükleyin
pnpm install

# Kullanıcı arayüzünü (UI) derleyin
pnpm ui:build

# Projeyi derleyin
pnpm build

# Kurulum sihirbazını çalıştırın
pnpm openclaw onboard --install-daemon

Adım Adım Kurulum

Adım 1: Kurulum Sihirbazını Çalıştırın

Kurulumdan sonra sihirbaz otomatik olarak başlar. Başlamazsa şu komutu çalıştırın:

openclaw onboard --install-daemon

Sihirbaz size şu konularda rehberlik eder:

1. Model Sağlayıcı Seçimi
2. API Anahtarı Yapılandırması
3. Mesajlaşma Platformu Kurulumu
4. Güvenlik Ayarları

Adım 2: Yapay Zeka Modelinizi Yapılandırın

OpenClaw birden fazla yapay zeka sağlayıcısını destekler. Birini seçin:

Seçenek A: Anthropic Claude (Önerilen)

# API anahtarınızı ayarlayın
export ANTHROPIC_API_KEY=sk-ant-xxxxx

# Veya config komutunu kullanın
openclaw config set 'models.default' 'claude-sonnet-4'

Seçenek B: OpenAI

export OPENAI_API_KEY=sk-xxxxx
openclaw config set 'models.default' 'gpt-4o'

Seçenek C: DeepSeek (Ekonomik)

openclaw config set 'models.providers.deepseek' --json '{
  "baseUrl": "https://api.deepseek.com/v1",
  "apiKey": "your-api-key",
  "api": "openai-completions",
  "models": [
    { "id": "deepseek-chat", "name": "DeepSeek Chat" },
    { "id": "deepseek-reasoner", "name": "DeepSeek Reasoner" }
  ]
}'

Seçenek D: Ollama ile Yerel Modeller

Tam gizlilik için modelleri yerel olarak çalıştırın:

# Önce Ollama'yı kurun: https://ollama.ai
ollama pull llama3.3

# OpenClaw'u onu kullanacak şekilde yapılandırın
openclaw config set 'models.providers.ollama' --json '{
  "baseUrl": "http://localhost:11434/v1",
  "api": "openai-completions",
  "models": [
    { "id": "llama3.3", "name": "Llama 3.3" }
  ]
}'

Adım 3: Mesajlaşma Platformlarını Bağlayın

Burası OpenClaw'un parladığı yerdir — yapay zekanızla her yerden sohbet edin.

Telegram (En Kolayı)

1. Telegram'da @BotFather adresine mesaj gönderin.
2. /newbot yazın ve yönergeleri izleyin.
3. Bot token'ınızı kopyalayın.
4. OpenClaw'u yapılandırın:

openclaw config set 'channels.telegram.token' 'YOUR_BOT_TOKEN'
openclaw config set 'channels.telegram.allowlist' '["your_telegram_username"]'

WhatsApp

OpenClaw bağlantı için WhatsApp Web'i kullanır:

# WhatsApp kanalını etkinleştirin
openclaw config set 'channels.whatsapp.enabled' true

# Gateway'i yeniden başlatın
openclaw gateway restart

# Görünen QR kodu taratın

Terminalinizde bir QR kodu belirecektir. Bunu telefonunuzdaki WhatsApp ile taratın (Ayarlar → Bağlı Cihazlar → Cihaz Bağla).

Discord

1. discord.com/developers adresinde bir Discord uygulaması oluşturun.
2. Bir bot oluşturun ve token'ı kopyalayın.
3. Yapılandırın:

openclaw config set 'channels.discord.token' 'YOUR_BOT_TOKEN'
openclaw config set 'channels.discord.allowlist' '["your_discord_user_id"]'

iMessage (Yalnızca Mac)

Mac kullanıcıları için OpenClaw doğrudan iMessage'a bağlanabilir:

openclaw config set 'channels.imessage.enabled' true

Adım 4: Gateway'i Başlatın

Gateway, OpenClaw'un çalışmasını sağlayan arka plan servisidir:

# Daemon (arka plan servisi) olarak başlatın
openclaw gateway start

# Veya hata ayıklama için ön planda çalıştırın
openclaw gateway

# Durumu kontrol edin
openclaw gateway status

# Günlükleri (logs) görüntüleyin
openclaw logs --follow

Adım 5: Web Paneline Erişin

OpenClaw, yapılandırma ve doğrudan sohbet için bir web arayüzü içerir:

# Paneli tarayıcınızda açın
openclaw dashboard

Bu komut, geçici bir oturum açma token'ı ile http://127.0.0.1:18789/ adresini açar.

Panelden şunları yapabilirsiniz:

• Yapay zekanızla doğrudan sohbet edin.


• Ayarları yönetin.


• Konuşma geçmişini görüntüleyin.


• Yetenekleri (skills) yükleyin.

İlk Konuşmanız

Her şey ayarlandıktan sonra botunuza bir mesaj gönderin (Telegram, WhatsApp veya web kullanıcı arayüzü üzerinden):

Merhaba! Neler yapabileceğini söyler misin?

OpenClaw kendisini ve yeteneklerini tanıtacaktır. Bazı gerçek görevleri deneyin:

İndirilenler klasörümde hangi dosyalar var?

Belgelerimde "2025 vergileri" ile ilgili her şeyi ara.

CSV'yi JSON'a dönüştüren bir Python betiği oluştur.

Bilgisayarımda en çok disk alanını ne kaplıyor?

Yetenekleri (Skills) Yükleme

Yetenekler OpenClaw'un kabiliyetlerini genişletir. ClawHub dizinine göz atın veya doğrudan yükleyin:

Popüler Yetenekler

# GitHub entegrasyonu
openclaw skill install github

# Web tarayıcı otomasyonu
openclaw skill install agent-browser

# Takvim yönetimi
openclaw skill install calendar

# E-posta otomasyonu
openclaw skill install email

# Akıllı ev kontrolü
openclaw skill install homeassistant

# Görsel oluşturma
openclaw skill install dalle

# Sesli sohbetler (Discord)
openclaw skill install discord-voice

Yetenek Kategorileri

Güvenlik Uyarısı

⚠️ Önemli: Yetenekleri yüklemeden önce inceleyin. ClawHub'ın açık yapısı, kötü niyetli yeteneklerin var olabileceği anlamına gelir. Kodu incelemek için openclaw skill inspect komutunu kullanın veya Claude Code / Codex'ten kodu denetlemesini isteyin.

Gelişmiş Yapılandırma

Yapılandırma Dosyası Yapısı

OpenClaw, yapılandırmaları ~/.openclaw/ dizininde saklar:

~/.openclaw/
├── openclaw.json    # Ana yapılandırma
├── env              # Ortam değişkenleri (API anahtarları)
├── memory/          # Kalıcı bellek deposu
├── skills/          # Yüklü yetenekler
├── backups/         # Yapılandırma yedekleri
└── logs/            # Günlük dosyaları

Yapılandırmayı Düzenleme

# Mevcut yapılandırmayı görüntüleyin
openclaw config get

# Bir değer atayın
openclaw config set 'key.path' 'value'

# Varsayılan düzenleyicinizde düzenleyin
openclaw config edit

Bellek Yönetimi

OpenClaw konuşmalar arasında kalıcı bellek tutar:

# Bellek istatistiklerini görüntüleyin
openclaw memory stats

# Tüm belleği temizleyin (Dikkatli olun!)
openclaw memory clear

# Yedekleme için belleği dışa aktarın
openclaw memory export > memory-backup.json

Sağlık Kontrollerini Çalıştırma

# Kapsamlı sağlık kontrolü
openclaw doctor

# Belirli bileşenleri kontrol edin
openclaw doctor --check api
openclaw doctor --check channels
openclaw doctor --check skills

Güvenlik En İyi Uygulamaları

OpenClaw tam sistem erişimine sahiptir — onu güçlü kılan budur ancak aynı zamanda risklidir. Şu yönergeleri izleyin:

1. Özel Bir Makine Kullanın

OpenClaw'u ana iş bilgisayarınızda çalıştırmayın. Seçenekler:

• VPS: DigitalOcean, Vultr, AWS ($5-20/ay)
• Eski dizüstü bilgisayar: Eski donanımları yeniden değerlendirin
• Raspberry Pi: Hafif kullanım için uygundur
• Docker: Bir miktar izolasyon sağlar

2. Sandbox Modunu Etkinleştirin

Güvenilmeyen oturumlar (grup sohbetleri, kanallar) için:

openclaw config set 'agents.defaults.sandbox.mode' 'non-main'

Bu, grup/kanal oturumlarını Docker sandbox'ları içinde çalıştırır.

3. İzin Listelerini (Allowlists) Kullanın

Sadece belirli kullanıcıların botunuzla etkileşime girmesine izin verin:

# Telegram
openclaw config set 'channels.telegram.allowlist' '["username1", "username2"]'

# Discord
openclaw config set 'channels.discord.allowlist' '["user_id_1", "user_id_2"]'

4. Güncel Tutun

Eski sürümlerde güvenlik açıkları bulunmuştur. Her zaman en son sürümü çalıştırın:

# Güncellemeleri kontrol edin
openclaw update --check

# En son sürüme güncelleyin
openclaw update

Not: 2026.1.29'dan önceki sürümlerde bilinen bir güvenlik açığı vardır. Eski bir sürümdeyseniz derhal güncelleyin.

5. Yetenekleri Yüklemeden Önce Denetleyin

# Bir yeteneğin kodunu inceleyin
openclaw skill inspect <skill-name>

# Yetenek itibarını kontrol edin
openclaw skill info <skill-name>

Otomasyon Örnekleri

İşte OpenClaw'un gerçekten güçlendiği yerler:

Sabah Özeti

Her sabah saat 08:00'de bir günlük özet ayarlayın:

# Yapılandırmanıza bir cron görevi ekleyin
openclaw config set 'automations.morning-briefing' --json '{
  "cron": "0 8 * * *",
  "action": "Bana şunların özetini gönder: hava durumu tahmini, bugünkü takvim etkinlikleri, okunmamış önemli e-postalar ve en önemli 3 haber başlığı"
}'

GitHub PR İnceleme Botu

Atandığınızda PR'ları otomatik olarak inceleyin:

openclaw skill install github

# Webhook veya polling'i yapılandırın
openclaw config set 'automations.pr-review' --json '{
  "trigger": "github.pr.assigned",
  "action": "PR'ı incele; hataları, güvenlik sorunlarını ve stil ihlallerini kontrol et. Bir özet yorumu gönder."
}'

Akıllı Ev Sahneleri

openclaw skill install homeassistant

# "Evden çıkış" otomasyonu
openclaw config set 'automations.leaving-home' --json '{
  "trigger": "location.leave_home",
  "action": "Tüm ışıkları kapat, termostatı eko moduna al, güvenlik sistemini devreye sok"
}'

Dosya Düzenleme

OpenClaw'a İndirilenler klasörünüzü düzenlemesini söyleyin:

İndirilenler klasörümü düzenle: resimleri ~/Pictures klasörüne, belgeleri ~/Documents klasörüne taşı ve 30 günden eski her şeyi sil.

Sorun Giderme

Sık Karşılaşılan Sorunlar

# PATH'e ekleyin
export PATH="$HOME/.openclaw/bin:$PATH"
# Kabuk profilinize (.bashrc, .zshrc) ekleyin

# Ortam değişkenlerinizi kontrol edin
openclaw config get models

# Onboarding'i tekrar çalıştırın
openclaw onboard

# Günlükleri kontrol edin
openclaw logs --channel whatsapp

# Gateway'i yeniden başlatın
openclaw gateway restart

# Yetenek dizinini yeniden oluşturun
openclaw skill rebuild

# Çakışmaları kontrol edin
openclaw doctor --check skills

Yardım Alma

• Dokümantasyon: docs.openclaw.ai
• GitHub Sorunları: github.com/openclaw/openclaw/issues
• Discord Topluluğu: discord.gg/openclaw
• Reddit: r/OpenClaw

Maliyet Dökümü

OpenClaw'un kendisi ücretsizdir. Maliyetleriniz yapay zeka API kullanımından kaynaklanır:

Maliyet Tasarrufu İpuçları

1. Rutin görevler için DeepSeek kullanın (Claude'un 3$/M fiyatına kıyasla 0.14$/M token).
2. Basit sorgular için yerel modeller kullanın (donanımdan sonra ücretsizdir).
3. Konuşma başına token sınırları belirleyin.
4. Tekrarlanan sorgular için önbelleğe alma (caching) kullanın.

Sırada Ne Var?

OpenClaw'u çalıştırdığınıza göre, işte bazı fikirler:

Kendi Yeteneklerinizi Oluşturun

Özel ihtiyaçlarınız için özel yetenekler oluşturun:

# Yeni bir yetenek oluşturun
openclaw skill create my-custom-skill

# Yeteneği düzenleyin
code ~/.openclaw/skills/my-custom-skill/SKILL.md

Daha Fazla Platform Bağlayın

• Birden fazla WhatsApp hesabı ekleyin (kişisel + iş).
• İş için Slack, kişisel kullanım için Discord bağlayın.
• Apple ekosistemi için iMessage kurun.

Ekosistemi Keşfedin

• 3.000'den fazla yetenek için ClawHub adresine göz atın.
• İpuçları ve püf noktaları için Discord topluluğuna katılın.
• Güncellemeler için @OpenClaw hesabını takip edin.

Daha İleriye Taşıyın: Kendi Yapay Zeka Ürünlerinizi Dağıtın

Yapay zeka asistanlarının gücünü bir kez deneyimledikten sonra, başkaları için ürünler oluşturmak isteyebilirsiniz. İşte burada Y Build devreye giriyor.

Y Build, yapay zeka destekli fikirden yayına alınmış ürüne geçmenize yardımcı olur:

1. Yapay Zeka ile Kodlama: Ne istediğinizi açıklayın, yapay zeka kodu oluştursun.
2. Tek Tıkla Dağıtım: Global CDN ile anında canlıya geçin.
3. Büyüme Araçları: Demo videoları, SEO optimizasyonu, analitik.

• Yapay zeka destekli bir SaaS aracı
• OpenClaw gibi bir otomasyon platformu
• İşletmeniz için özel bir sohbet robotu

Sonuç

OpenClaw, kişisel yapay zekada yeni bir paradigmayı temsil ediyor — şu özelliklere sahip bir asistan:

• Yerel: Verileriniz asla makinenizden ayrılmaz.
• Güçlü: Tam sistem erişimi, gerçek otomasyon anlamına gelir.
• Genişletilebilir: 3.000'den fazla yetenek ve her geçen gün artıyor.
• Çok platformlu: Tek bir yapay zeka, her yerden erişilebilir.

• WhatsApp'ınızdan soruları yanıtlar.
• Dosyalarınızı arar ve düzenler.
• Tekrarlayan görevleri otomatize eder.
• Akıllı evinizi kontrol eder.
• Ve çok daha fazlası.

OpenClaw topluluğuna hoş geldiniz. 🦞

• OpenClaw Resmi Dokümantasyonu
• OpenClaw GitHub Deposu
• ClawHub Yetenek Dizini
• Codecademy: OpenClaw Eğitimi
• DigitalOcean: OpenClaw Nedir?
• Hostinger: OpenClaw Nasıl Kurulur?
• CNBC: Clawdbot'tan OpenClaw'a
• Medium: OpenClaw'u Docker ile Güvenli Çalıştırmak