Kişisel Yapay Zeka Altyapınızı Oluşturun

Bilgisayarınızı otonom bir yapay zeka komuta merkezine dönüştürün. Bu kılavuz, kurulum, yapılandırma ve ilk otomatik göreviniz boyunca size rehberlik eder—bir sistem yöneticisi olduğunuzu varsaymadan.

⏱️ Estimated Time: 30 minutes

Başlamadan Önce: Neler İnşa Ettiğinizi Anlamak

Most AI installation guides treat software as a black box: download, install, forget. clawbot is different because you're not installing an app—you're establishing infrastructure . Think of this as setting up your own private email server, except instead of managing messages, you're orchestrating an AI that can genuinely control your digital environment.

This guide explains what each step does and why it matters. Understanding the architecture makes troubleshooting intuitive and customization straightforward.

What You'll Have After 30 Minutes

  • A Gateway service running persistently on your device, coordinating all AI activity
  • Connection to your chosen AI model (Claude, GPT-4, or free local Ollama)
  • At least one messaging channel (WhatsApp, Telegram, etc.) linked to your AI
  • A functioning automation that demonstrates genuine system control
  • Understanding of how to extend, customize, and troubleshoot your setup

Ön Gereksinimler: Gerçekten Neye İhtiyacınız Var

Herhangi bir şey indirmeden önce, sisteminizin bu gereksinimleri karşıladığını doğrulayın. Her biri belirli bir amaç için hizmet eder:

Donanım Gereksinimleri

  • Operating System: macOS 11+, Linux (Ubuntu 20.04+, Debian 11+), or Windows 10+ with WSL2
  • RAM: Minimum 2GB available (4GB recommended for smoother operation)
  • Disk Space: 500MB for core installation plus space for AI model caching
  • Network: Stable internet connection for AI API calls (unless using local Ollama)

Yazılım Bağımlılıkları

clawbot requires Node.js 22 or higher. Why this specific version? Newer Node.js versions include critical performance improvements and security patches that clawbot's real-time communication relies on. The installer typically handles this, but manual installations require it pre-installed.

Yapay Zeka Modeli Erişimi (Birini Seçin)

Cost-Benefit Analysis: Which AI Model Should You Choose?

Option 1: Anthropic Claude (Recommended for most users)

  • Cost: ~$20-40/month for typical personal use
  • Advantage: Exceptional reasoning, strong security awareness, long context windows
  • Get API key: console.anthropic.com

Option 2: OpenAI GPT-4

  • Cost: ~$25-50/month depending on usage patterns
  • Advantage: Broad knowledge base, excellent for creative tasks
  • Get API key: platform.openai.com

Option 3: Local Ollama Models (Completely free)

  • Cost: $0 (runs entirely on your hardware)
  • Advantage: Zero ongoing costs, complete privacy, offline operation
  • Disadvantage: Slower responses, requires more powerful hardware (8GB+ RAM recommended)
  • Setup: ollama.ai

Adım 1: Platformunuz İçin Doğru Paketi İndirin

clawbot distributes platform-specific installers that bundle everything needed. Why multiple formats? Different operating systems handle background services differently—the installer configures these correctly.

macOS
Linux
Windows
Docker
1

macOS Kurulumu

En basit deneyim için DMG yükleyicisini indirin:

curl -fsSL https://github.com/steipete/clawbot/releases/download/v2026.1.23/clawbot-2026.1.23.dmg -o clawbot.dmg

Or download directly from GitHub Releases .

What the installer does:

  • Installs the Gateway service to /Applications/clawbot.app
  • Creates configuration directory at ~/.clawbot/
  • Configures system permissions for automation capabilities
  • Optionally sets up launch-at-startup (recommended)
1

Linux Kurulumu

npm (önerilen) veya Docker aracılığıyla yükleyin:

npm install -g clawbot@latest

Ardından yapılandırmayı başlatın:

clawbot init

Setting up as a systemd service (optional but recommended):

clawbot install-service

Bu, clawbot'un önyüklemede otomatik olarak başlamasını ve çökmesi durumunda yeniden başlamasını sağlar.

1

Windows Kurulumu (WSL2)

Windows, WSL2 (Windows için Linux Alt Sistemi) gerektirir. Yüklü değilse:

wsl --install

Ardından WSL2 Ubuntu ortamınızdaki Linux talimatlarını izleyin.

⚠️ Windows Native Support

Yerel Windows desteği (WSL2 olmadan) deneyseldir. WSL2, Node.js sistem entegrasyonları ve kabuk komutu yürütme ile daha iyi uyumluluk sağlar.

1

Docker Dağıtımı

Platformlar arası uyumluluk veya sunucu dağıtımları için:

docker pull ghcr.io/steipete/clawbot:latest

Kalıcı yapılandırmayla çalıştırın:

docker run -d \
--name clawbot \
-v ~/.clawbot:/root/.clawbot \
-p 18789:18789 \
ghcr.io/steipete/clawbot:latest

Understanding the Docker flags:

  • -d : Runs container in background (daemon mode)
  • -v ~/.clawbot:/root/.clawbot : Persists configuration between restarts
  • -p 18789:18789 : Exposes Gateway WebSocket port for local clients

Adım 2: Ağ Geçidini Kurun ve Başlatın

The Gateway is clawbot's core—a persistent service that manages all communication between messaging platforms, AI models, and your system. Think of it as the central nervous system : channels send messages to the Gateway, which routes them to the appropriate AI model, receives responses, and delivers them back.

2

Kurulumu Çalıştırın

macOS: Open the downloaded DMG and drag clawbot to Applications. Launch it.

Linux/WSL: After npm installation, start the Gateway:

clawbot gateway start

Çalıştığını doğrulayın:

clawbot gateway status

You should see: Gateway is running on ws://127.0.0.1:18789

🔍 What's Happening Behind the Scenes

Ağ Geçidi, 18789 numaralı bağlantı noktasında (özelleştirilebilir) bir WebSocket sunucusu oluşturur. Bu yalnızca yerel sunucu şunlardan bağlantıları kabul eder:

  • Channel plugins (WhatsApp, Telegram, etc.) that forward user messages
  • Node clients (mobile apps, web interfaces) for direct interaction
  • Skills and tools that extend functionality

Tüm iletişim, uzaktan erişimi açıkça yapılandırmadığınız sürece makinenizde kalır (gelişmiş kılavuzlarda ele alınmıştır).

Adım 3: Yapay Zeka Beyninizi Bağlayın

Ağ Geçidi çalışırken, yanıt üretmesi için bir yapay zeka modeline ihtiyacı vardır. Bu adım, hangi modeli(leri) kullanacağınızı yapılandırır ve API erişimini kimlik doğrulaması yapar.

3

Yapay Zeka Sağlayıcısını Yapılandırın

Yapılandırma dosyasını açın:

clawbot config edit

Or manually edit ~/.clawbot/clawbot.json . Add your API credentials:

{
  "aiProviders": {
    "anthropic": {
      "apiKey": "sk-ant-your-api-key-here",
      "model": "claude-3-5-sonnet-20250219",
      "enabled": true
    }
  },
  "defaultProvider": "anthropic"
}

For local Ollama instead:

{
  "aiProviders": {
    "ollama": {
      "baseURL": "http://localhost:11434",
      "model": "llama3.1:8b",
      "enabled": true
    }
  },
  "defaultProvider": "ollama"
}

Security Best Practice: API Key Management

Never commit clawbot.json to version control if it contains API keys. Consider using environment variables for production deployments:

export ANTHROPIC_API_KEY="your-key-here"

clawbot, mevcutsa ortam değişkenlerinden otomatik olarak okur.

Adım 4: İletişim Kanallarınızı Bağlayın

Channels are how you interact with your AI—WhatsApp for mobile, Telegram for desktop, Discord for team collaboration. Each channel connects independently to the Gateway, and clawbot maintains a unified conversation history across all of them .

4

İlk Kanalınızı Bağlayın: WhatsApp Örneği

WhatsApp kanal eklentisini yükleyin:

clawbot channel add whatsapp

Bu etkileşimli bir kurulum başlatır:

  1. A QR code appears in your terminal
  2. Open WhatsApp on your phone → Settings → Linked Devices → Link a Device
  3. Scan the QR code
  4. clawbot confirms connection and saves session credentials

How it works: clawbot uses the WhatsApp Web protocol (via Baileys library) to establish a persistent connection. Your phone remains the "primary" device; clawbot acts as a linked secondary device—just like WhatsApp Web in your browser.

⚠️ WhatsApp Account Safety

WhatsApp's terms of service prohibit bot usage. While clawbot implements rate limiting and human-like behavior patterns, we recommend using a secondary phone number rather than your primary personal WhatsApp account. Consider:

  • Getting a Google Voice or similar virtual number
  • Using an old SIM card you don't actively use
  • Trying Telegram instead (officially supports bots)

Alternatif Kanallar

Her kanalın kendine özgü kurulum gereksinimleri vardır. Popüler seçenekler:

Telegram (Recommended for beginners):

clawbot channel add telegram

Telefon numaranızla kimlik doğrulaması yapmak için komutu izleyin. Telegram botları resmi olarak destekler, bu da onu en güvenli seçenek haline getirir.

Discord (Great for teams):

clawbot channel add discord

Requires creating a Discord bot application at discord.com/developers . Copy the bot token when prompted.

Full channel documentation: docs.clawd.bot/channels

Adım 5: İlk Otonom Görevinizi Gerçekleştirin

Her şey yapılandırıldıktan sonra, clawbot'un yalnızca metinle yanıt vermekle kalmayıp sisteminizi gerçekten kontrol edebildiğini doğrulayalım.

5

Sistem Entegrasyonunu Test Edin

Bağlı mesajlaşma kanalınızı (WhatsApp, Telegram vb.) açın ve şu mesajı gönderin:

"Create a text file called test.txt in my Documents folder with today's date and a motivational quote."

What should happen:

  1. clawbot receives your message through the channel
  2. Gateway routes it to your configured AI model
  3. AI generates a response plan including shell commands
  4. clawbot executes: echo "..." > ~/Documents/test.txt
  5. You receive confirmation: "Created test.txt with..."
  6. Check your Documents folder—the file exists

🎉 You Just Demonstrated Genuine AI Automation

What distinguishes clawbot from ChatGPT or Siri: it didn't just tell you how to create the file—it actually created it . This same capability extends to:

  • Managing your calendar and sending meeting invites
  • Monitoring log files and alerting you to errors
  • Pulling data from APIs and generating reports
  • Controlling smart home devices via Home Assistant
  • Running development workflows (tests, builds, deployments)

Sonra Neler İnşa Etmeli

Yapay zeka altyapınız çalışır durumda. Yeteneklerini genişletmenin yolları şunlardır:

1. ClawdHub'dan Yetenekleri Yükleyin

Yetenekler önceden oluşturulmuş otomasyon modülleridir. Pazar yerini göz atın:

clawbot skills browse

Popüler başlangıç yetenekleri:

  • google-calendar : Natural language calendar management
  • home-assistant : Smart home control integration
  • github-assistant : Repository management and PR reviews
  • daily-briefing : Morning summary of calendar, weather, news

2. Özel Otomasyon Oluşturun

Skills are just folders with a SKILL.md file. Create your own:

mkdir -p ~/.clawbot/skills/my-automation
echo "# My Custom Skill" > ~/.clawbot/skills/my-automation/SKILL.md

Full guide: docs.clawd.bot/skills/creating

3. Proaktif Davranışları Yapılandırın

Unlike traditional AI, clawbot can initiate contact. Enable heartbeat monitoring:

clawbot config set heartbeat.enabled true
clawbot config set heartbeat.interval "every day at 8am"

Artık clawbot, siz sormadan size proaktif olarak bir sabah brifingi gönderecek.

4. Buluta Dağıtın (İsteğe Bağlı)

clawbot'u dizüstü bilgisayarınızda çalıştırmak işe yarar, ancak bulut dağıtımı %24/7 kullanılabilirlik sağlar. Şu adresler için kılavuzlar mevcuttur:

  • DigitalOcean Droplets ($6/month)
  • AWS EC2 Free Tier (12 months free)
  • Hetzner Cloud (€4/month)
  • Home Raspberry Pi (one-time hardware cost)

Yaygın Sorunlar ve Çözümleri

Gateway Won't Start

Symptom: Error: EADDRINUSE: address already in use

Cause: Another process is using port 18789.

Solution: Find and kill the conflicting process:

lsof -ti:18789 | xargs kill -9

Or configure clawbot to use a different port in clawbot.json .

AI Model Returns Errors

Symptom: "API authentication failed" or "Invalid model specified"

Cause: Incorrect API key or model name in configuration.

Solution: Verify your API key is valid:

curl https://api.anthropic.com/v1/messages \
-H "x-api-key: YOUR_KEY" \
-H "anthropic-version: 2023-06-01"

Sağlayıcı belgelerindeki (Anthropic, OpenAI) model adlarını kontrol edin.

WhatsApp Disconnects Frequently

Symptom: QR code authentication required every few days.

Cause: Session credentials not persisting correctly.

Solution: Ensure ~/.clawbot/channels/whatsapp/ has write permissions:

chmod 700 ~/.clawbot/channels/whatsapp/

Ayrıca telefonunuzun internete bağlı kaldığını doğrulayın—WhatsApp'ın birincil cihazın çevrimiçi olmasını gerektirir.

Artık Kendi Yapay Zeka Altyapınızı Çalıştırıyorsunuz

What you've built isn't just a chatbot—it's a personal automation platform that combines the intelligence of frontier AI models with the capability of local system control. Unlike cloud services that constrain what AI can do, your clawbot installation has the same access to your digital environment that you do.

Bu güç sorumlulukla birlikte gelir: clawbot, onayladığınız herhangi bir komutu yürütebilir. Kum havuzu ve izin sistemi kazara hasara karşı koruma sağlar, ancak sonuçta bir yapay zekaya anlamlı kontrol yetkisi veriyorsunuz. Basit otomasyonlarla başlayın, kararların nasıl verildiğini anlayın ve güven oluşturdukça yetenekleri kademeli olarak genişletin.

Daha Derine Dalmaya Hazır mısınız?

Gelişmiş yapılandırma, yetenek geliştirme ve mimari derinlemesine incelemeler keşfedin

Complete Usage Guide Technical Architecture Security Best Practices