OpenClaw v2026.2 için geçerlidir | Bu makale, Node.js >= 22 ortamınız olduğunu ve bir AI API Key’iniz (Anthropic Claude önerilir) olduğunu varsayar.

TL;DR: 5 dakikada OpenClaw kurulumunu tamamlayın. npm/pnpm/bun/Docker olmak üzere dört yöntem desteklenir, önerilen: npm install -g openclaw@latest && openclaw onboard. Yapılandırma dosyası ~/.openclaw/openclaw.json konumundadır, openclaw gateway ile başlatılır. Docker dağıtımı, yapılandırma dosyası yapısı, sık sorulan sorun giderme detaylı olarak ele alınmıştır.

Ön Gereksinimler

Gerekli Ortam

Önerilen Ortam

AI API Key

OpenClaw’ın çalışması için bir AI modeline bağlanması gerekir. Önerilen:

💡 Öneri: Anthropic Claude Opus 4.6, en iyi uzun bağlam işleme ve prompt enjeksiyon koruması sunar.

Ortam Doğrulama

# Node.js sürümünü kontrol et
node --version
# Örnek çıktı: v22.12.0

# npm sürümünü kontrol et
npm --version
# Örnek çıktı: 10.9.0

# Sistem bilgisini kontrol et
uname -a  # Linux/macOS
# veya
systeminfo | findstr /B /C:"OS Name" /C:"OS Version"  # Windows

Kurulum Yöntemi Karşılaştırması

flowchart TB
    A[Kurulum yöntemi seç] --> B{Kullanım senaryosu?}
    B -->|Hızlı deneyim| C[npm global kurulum]
    B -->|Günlük kullanım| D[pnpm/bun kurulum]
    B -->|Üretim dağıtımı| E[Docker dağıtımı]
    B -->|Geliştirme katkısı| F[Kaynak koddan derleme]
    
    C --> G[5 dakikada tamamla]
    D --> H[Daha hızlı bağımlılık yönetimi]
    E --> I[Ortam izolasyonu ve tekrarlanabilirlik]
    F --> J[Özelleştirilebilir ve geliştirmeye katılım]

Yöntem Karşılaştırma Tablosu

Yöntem 1: npm Global Kurulum (Yeni Başlayanlar İçin Önerilir)

Kurulum Adımları

# 1. En son kararlı sürümü kur
npm install -g openclaw@latest

# 2. Kurulumu doğrula
openclaw --version
# Örnek çıktı: 2026.2.26

# 3. Yardımı görüntüle
openclaw --help

Kurulum Sonrası Dizin Yapısı

/usr/local/lib/node_modules/openclaw/  # Global kurulum dizini
├── bin/
│   └── openclaw                        # Çalıştırılabilir dosya
├── lib/
│   └── ...                             # Çekirdek kütüphane dosyaları
└── package.json

~/.openclaw/                            # Kullanıcı veri dizini (ilk çalıştırmada oluşturulur)
├── openclaw.json                       # Ana yapılandırma dosyası
├── credentials/                       # Kanal kimlik bilgisi deposu
├── workspace/                          # Agent çalışma alanı
│   ├── AGENTS.md                      # Agent davranış kılavuzu
│   ├── SOUL.md                        # Agent kişilik ayarları
│   └── skills/                        # Özel beceriler
└── logs/                              # Günlük dizini

Başlangıç Sihirbazını Çalıştır

# Etkileşimli yapılandırma sihirbazını başlat
openclaw onboard --install-daemon

Sihirbaz aşağıdaki adımlarda size rehberlik eder:

sequenceDiagram
    participant U as Kullanıcı
    participant W as Sihirbaz
    participant S as Sistem
    
    U->>W: onboard başlat
    W->>U: Model sağlayıcısını seç
    U->>W: Anthropic seç
    W->>U: API Key gir
    U->>W: Key'i yapıştır
    W->>U: Gateway portunu seç
    U->>W: 18789 (varsayılan)
    W->>U: Daemon kurmak ister misin?
    U->>W: Evet
    W->>S: systemd/launchd servisi oluştur
    S-->>W: Kurulum başarılı
    W-->>U: Yapılandırma tamamlandı!

Yöntem 2: pnpm Kurulumu (Günlük Kullanım İçin Önerilir)

pnpm Kurulumu

# npm ile pnpm kur
npm install -g pnpm

# Veya bağımsız script ile
curl -fsSL https://get.pnpm.io/install.sh | sh -

OpenClaw Kurulumu

# pnpm ile kur
pnpm add -g openclaw@latest

# Doğrula
openclaw --version

pnpm’in Avantajları

Yöntem 3: bun Kurulumu (Maksimum Hız İçin)

bun Kurulumu

# macOS/Linux
curl -fsSL https://bun.sh/install | bash

# Veya npm ile
npm install -g bun

OpenClaw Kurulumu

# bun ile kur
bun add -g openclaw@latest

# Doğrula
openclaw --version

bun’ın Avantajları

Yöntem 4: Docker Dağıtımı (Üretim İçin Önerilir)

İmajı İndir

# En son imajı çek
docker pull openclaw/openclaw:latest

# Veya belirli sürümü çek
docker pull openclaw/openclaw:2026.2

Temel Çalıştırma

# Minimal çalıştırma
docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  -e ANTHROPIC_API_KEY=your_key_here \
  openclaw/openclaw:latest

# Günlükleri görüntüle
docker logs -f openclaw

Docker Compose Yapılandırması

docker-compose.yml oluşturun:

version: '3.8'

services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "18789:18789"
    volumes:
      - ./openclaw-data:/root/.openclaw
    environment:
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
      # Veya yapılandırma dosyası kullan
      # - OPENCLAW_CONFIG=/root/.openclaw/openclaw.json
    healthcheck:
      test: ["CMD", "openclaw", "health"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s

Servisi başlat:

# .env dosyası oluştur
echo "ANTHROPIC_API_KEY=your_key_here" > .env

# Başlat
docker-compose up -d

# Durumu görüntüle
docker-compose ps

# Günlükleri görüntüle
docker-compose logs -f

Docker Ağ Yapılandırması

# docker-compose.yml genişletilmiş yapılandırma
services:
  openclaw:
    # ... diğer yapılandırma
    networks:
      - openclaw-net

  # İsteğe bağlı: Ters proxy
  caddy:
    image: caddy:latest
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
    networks:
      - openclaw-net

networks:
  openclaw-net:
    driver: bridge

Yöntem 5: Kaynak Koddan Derleme (Geliştiriciler İçin)

Depoyu Klonla

# Ana depoyu klonla
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# Bağımlılıkları kur (pnpm önerilir)
pnpm install

# Derle
pnpm build

# Çalıştır
pnpm openclaw onboard

Geliştirme Modu

# Geliştirme modu (otomatik yeniden yükleme)
pnpm gateway:watch

# Testleri çalıştır
pnpm test

# Kod kontrolü
pnpm lint

Yapılandırma Dosyası Detayları

Yapılandırma Önceliği

CLI parametreleri > Ortam değişkenleri > Yapılandırma dosyası > Varsayılan değerler

Dizin Yapısı

~/.openclaw/
├── openclaw.json           # Ana yapılandırma dosyası
├── openclaw.json.backup    # Otomatik yedekleme
├── credentials/            # Hassas kimlik bilgileri (otomatik şifreli)
│   ├── telegram.json
│   ├── whatsapp.json
│   └── discord.json
├── workspace/              # Agent çalışma alanı
│   ├── AGENTS.md          # Global davranış kılavuzu
│   ├── SOUL.md            # Agent kişiliği
│   ├── TOOLS.md           # Özel araç açıklamaları
│   ├── USER.md            # Kullanıcı bilgileri
│   └── skills/            # Beceri dizini
│       ├── gmail/
│       │   └── SKILL.md
│       └── calendar/
│           └── SKILL.md
├── sessions/              # Oturum verileri
├── logs/                  # Günlük dosyaları
│   ├── gateway.log
│   └── agent.log
└── cache/                 # Önbellek verileri

Minimum Yapılandırma

~/.openclaw/openclaw.json:

{
  "agent": {
    "model": "anthropic/claude-opus-4-6"
  }
}

Tam Yapılandırma Örneği

{
  "agent": {
    "model": "anthropic/claude-opus-4-6",
    "thinkingLevel": "high",
    "verboseLevel": "normal"
  },
  "gateway": {
    "port": 18789,
    "bind": "loopback",
    "host": "127.0.0.1"
  },
  "channels": {
    "telegram": {
      "botToken": "YOUR_BOT_TOKEN",
      "dmPolicy": "pairing",
      "allowFrom": []
    },
    "whatsapp": {
      "allowFrom": ["+8613800138000"],
      "groups": {
        "*": { "requireMention": true }
      }
    },
    "discord": {
      "token": "YOUR_DISCORD_TOKEN",
      "guilds": {}
    }
  },
  "agents": {
    "defaults": {
      "workspace": "~/.openclaw/workspace",
      "sandbox": {
        "mode": "off"
      }
    }
  },
  "models": {
    "fallback": [
      {
        "model": "anthropic/claude-sonnet-4",
        "condition": "rate_limit"
      }
    ]
  },
  "webhooks": [],
  "cron": []
}

Yapılandırma Seçenekleri Açıklaması

Ortam Değişkenleri

OpenClaw, ortam değişkenleri aracılığıyla yapılandırmayı geçersiz kılmayı destekler:

# API Key'ler
export ANTHROPIC_API_KEY="sk-ant-..."
export OPENAI_API_KEY="sk-..."

# Kanal yapılandırması
export TELEGRAM_BOT_TOKEN="123456:ABC..."
export DISCORD_BOT_TOKEN="..."

# Gateway yapılandırması
export OPENCLAW_PORT=18789
export OPENCLAW_BIND="loopback"

Başlatma ve Doğrulama

Gateway’i Başlat

# Ön planda çalıştır (hata ayıklama modu)
openclaw gateway --verbose

# Arka planda çalıştır (daemon)
openclaw gateway --daemon

# Port belirt
openclaw gateway --port 18790

Çalışma Durumunu Doğrula

# Sağlık durumunu kontrol et
openclaw doctor

# Örnek çıktı:
# ✓ Node.js version: v22.12.0
# ✓ OpenClaw version: 2026.2.26
# ✓ Gateway running on port 18789
# ✓ API key configured
# ✓ Workspace directory exists

Web Konsoluna Eriş

Gateway’i başlattıktan sonra tarayıcıyı açın:

http://127.0.0.1:18789

Web Control UI’ı göreceksiniz:

Sohbeti Test Et

# Komut satırı testi
openclaw agent --message "Merhaba, lütfen kendini tanıt"

# Örnek çıktı:
# Merhaba! Ben senin OpenClaw asistanınım. Sana yardımcı olabilirim...

Sık Karşılaşılan Sorun Giderme

Sorun 1: Port Meşgul

Belirti:

Error: EADDRINUSE: address already in use 127.0.0.1:18789

Çözüm:

# Portu kullanan süreci bul
lsof -i :18789
# veya
netstat -tlnp | grep 18789

# Süreci sonlandır
kill -9 <PID>

# Veya başka bir port kullan
openclaw gateway --port 18790

Sorun 2: Geçersiz API Key

Belirti:

Error: Invalid API key

Çözüm:

# Yapılandırmayı doğrula
openclaw config get agent.model

# Ortam değişkenini kontrol et
echo $ANTHROPIC_API_KEY

# Yeniden yapılandır
openclaw onboard

Sorun 3: Düşük Node Sürümü

Belirti:

Error: OpenClaw requires Node.js >= 22.0.0

Çözüm:

# nvm ile sürüm değiştir
nvm install 22
nvm use 22
nvm alias default 22

# Doğrula
node --version

Sorun 4: Yetki Sorunu

Belirti:

Error: EACCES: permission denied

Çözüm:

# npm yetkilerini düzelt
sudo chown -R $(whoami) ~/.npm
sudo chown -R $(whoami) ~/.openclaw

# Veya Node.js yönetimi için nvm kullan (önerilir)

Sorun 5: Docker Ağ Sorunu

Belirti:

Error: Cannot connect to Gateway from container

Çözüm:

# Ağı kontrol et
docker network ls
docker network inspect bridge

# Host ağını kullan
docker run --network host ...

# Veya portu doğru şekilde eşle
docker run -p 127.0.0.1:18789:18789 ...

Sorun 6: Kayıp Kimlik Bilgileri

Belirti:

Warning: Telegram credentials not found

Çözüm:

# Kanala yeniden giriş yap
openclaw channels login telegram

# Kimlik bilgisi dosyalarını kontrol et
ls ~/.openclaw/credentials/

# Kimlik bilgilerini yedekle
cp -r ~/.openclaw/credentials/ ~/.openclaw/credentials.backup/

Sorun 7: Yetersiz Bellek

Belirti:

Error: JavaScript heap out of memory

Çözüm:

# Node.js bellek limitini artır
export NODE_OPTIONS="--max-old-space-size=8192"
openclaw gateway

# Veya Docker'da
docker run -e NODE_OPTIONS="--max-old-space-size=8192" ...

Güncelleme ve Bakım

OpenClaw’ı Güncelle

# npm güncelleme
npm update -g openclaw@latest

# pnpm güncelleme
pnpm update -g openclaw@latest

# Docker güncelleme
docker pull openclaw/openclaw:latest
docker-compose up -d

# Sürümü kontrol et
openclaw --version

Yayın Kanalını Değiştir

# Kararlı sürüm (önerilir)
openclaw update --channel stable

# Beta sürüm
openclaw update --channel beta

# Geliştirme sürümü (en son özellikler, kararsız olabilir)
openclaw update --channel dev

Yedekleme ve Geri Yükleme

# Yapılandırmayı yedekle
tar -czvf openclaw-backup-$(date +%Y%m%d).tar.gz ~/.openclaw/

# Yapılandırmayı geri yükle
tar -xzvf openclaw-backup-20260226.tar.gz -C ~/

# Yalnızca kritik dosyaları yedekle
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup
cp -r ~/.openclaw/credentials/ ~/.openclaw/credentials.backup/

Sonraki Adım

Tebrikler! OpenClaw ortamını başarıyla kurdunuz. Sırada:

1. İlk kanalı yapılandır → Sonraki makale: Kanal Yapılandırma Rehberi
2. İlk Skill’i kur → Web UI’da arayın ve kurun
3. Agent kişiliğini özelleştir → ~/.openclaw/workspace/SOUL.md dosyasını düzenleyin

Bu Bölümün Özeti:

• 5 kurulum yöntemini ve uygun senaryolarını öğrendiniz
• Yapılandırma dosyası yapısını ve önceliğini anladınız
• Başlatma doğrulaması ve sık sorulan sorun gidermeyi öğrendiniz
• Güncelleme bakımının temel işlemlerini kavradınız

Güncelleme Kayıtları:

• 2026-02-26: İlk sürüm yayınlandı, OpenClaw v2026.2 temel alınmıştır

Seri Navigasyonu:

• ← Önceki makale: OpenClaw’a Giriş
• → Sonraki makale: Kanal Yapılandırma: Telegram ile Başla