$npx -y skills add komunite/kalfa --skill openclaw-agent-deploymentOpenClaw AI agent'ini sıfırdan production ortamına deploy etme rehberi. SOUL.md yapılandırması, Docker kurulumu, kanal entegrasyonu, güvenlik ve monitoring.
| 1 | # OpenClaw Agent Deployment |
| 2 | |
| 3 | ## Amaç |
| 4 | |
| 5 | Bir OpenClaw AI agent'ini yerel veya uzak ortamda production-ready olarak çalıştırın. Bu beceri; agent yapılandırması, ortam hazırlığı, kanal bağlantısı, güvenlik sertleştirmesi ve sürekli çalışma için gereken tüm adımları kapsar. |
| 6 | |
| 7 | **Kategori**: AI Otomasyon |
| 8 | |
| 9 | ## Girdiler |
| 10 | |
| 11 | ### Zorunlu |
| 12 | - **Agent Rolü**: Agent'in ne yapacağı (örn: SEO analisti, kod inceleyici, proje yöneticisi) |
| 13 | - **Hedef Platform**: Nereye deploy edileceği (yerel makine, VPS, Docker, Raspberry Pi) |
| 14 | - **LLM Tercihi**: Hangi dil modeli kullanılacak (Claude, GPT-4o, Ollama/yerel model) |
| 15 | |
| 16 | ### İsteğe Bağlı |
| 17 | - **Kanal**: Telegram, Slack, Discord veya WebChat |
| 18 | - **Çoklu Agent**: Birden fazla agent çalıştırılacaksa AGENTS.md yapılandırması |
| 19 | - **Zamanlama**: HEARTBEAT.md ile periyodik görevler |
| 20 | |
| 21 | ## Sistem Bağlamı |
| 22 | |
| 23 | Başlamadan önce: |
| 24 | - Mevcut proje bağlamı ve öncelikleri için `memory.md`'yi oku |
| 25 | - İlgili deployment kuralları veya kısıtlamalar için `knowledge-base.md`'yi kontrol et |
| 26 | - Hedef sunucunun donanım özelliklerini belirle (RAM, CPU, disk, GPU) |
| 27 | - Gerekli API anahtarlarının ve token'ların hazır olduğunu doğrula |
| 28 | |
| 29 | ## Süreç |
| 30 | |
| 31 | ### Adım 1: SOUL.md Yapılandırması |
| 32 | |
| 33 | Agent'in kimliğini, kurallarını ve araçlarını tanımlayan SOUL.md dosyasını oluşturun: |
| 34 | |
| 35 | ```markdown |
| 36 | # SOUL.md |
| 37 | |
| 38 | ## Kimlik |
| 39 | Sen [rol adı] agent'isın. [Tek cümlelik amaç]. |
| 40 | |
| 41 | ## Kurallar |
| 42 | - [Sınır 1: ne yapmamalı] |
| 43 | - [Sınır 2: hangi dosyalara erişebilir] |
| 44 | - [Sınır 3: hangi durumlarda kullanıcıya sormalı] |
| 45 | |
| 46 | ## Araçlar |
| 47 | - [Araç 1: ne için kullanılır] |
| 48 | - [Araç 2: ne için kullanılır] |
| 49 | |
| 50 | ## Çıktı Formatı |
| 51 | [Agent'in yanıt formatı] |
| 52 | ``` |
| 53 | |
| 54 | Kurallar bölümü, agent güvenilirliğinin %80'ini belirler. Kimlik kısmından önce kuralları netleştirin. |
| 55 | |
| 56 | > **İpucu:** SOUL.md'yi sıfırdan yazmak yerine, [crewclaw.com](https://crewclaw.com) üzerinden rol seçip hazır şablon oluşturabilir veya [awesome-openclaw-agents](https://github.com/mergisi/awesome-openclaw-agents) deposundaki 177 şablondan birini başlangıç noktası olarak kullanabilirsiniz. |
| 57 | |
| 58 | ### Adım 2: Ortam Hazırlığı |
| 59 | |
| 60 | #### Seçenek A: Docker (önerilen) |
| 61 | |
| 62 | ```yaml |
| 63 | # docker-compose.yml |
| 64 | version: "3.8" |
| 65 | services: |
| 66 | openclaw: |
| 67 | image: node:22-slim |
| 68 | working_dir: /app |
| 69 | volumes: |
| 70 | - ./agents:/app/agents |
| 71 | - ./.env:/app/.env |
| 72 | ports: |
| 73 | - "127.0.0.1:18789:18789" |
| 74 | command: npx openclaw gateway start |
| 75 | restart: unless-stopped |
| 76 | healthcheck: |
| 77 | test: ["CMD", "curl", "-f", "http://localhost:18789/health"] |
| 78 | interval: 30s |
| 79 | timeout: 10s |
| 80 | retries: 3 |
| 81 | ``` |
| 82 | |
| 83 | #### Seçenek B: Bare Metal (pm2) |
| 84 | |
| 85 | ```bash |
| 86 | # Node.js 22 kurulumu |
| 87 | curl -fsSL https://openclaw.ai/install.sh | bash |
| 88 | |
| 89 | # Agent dizini oluştur |
| 90 | mkdir -p agents/my-agent |
| 91 | cp SOUL.md agents/my-agent/ |
| 92 | |
| 93 | # pm2 ile daemon olarak çalıştır |
| 94 | npm i -g pm2 |
| 95 | pm2 start "npx openclaw gateway start" --name openclaw |
| 96 | pm2 save |
| 97 | pm2 startup |
| 98 | ``` |
| 99 | |
| 100 | #### Seçenek C: Raspberry Pi / Düşük Kaynak |
| 101 | |
| 102 | ```bash |
| 103 | # Minimum gereksinim: 512MB RAM, Node.js 22 |
| 104 | # Ollama ile yerel model kullanılacaksa: 4GB+ RAM |
| 105 | curl -fsSL https://openclaw.ai/install.sh | bash |
| 106 | ``` |
| 107 | |
| 108 | ### Adım 3: LLM Provider Yapılandırması |
| 109 | |
| 110 | ```bash |
| 111 | # .env dosyası |
| 112 | # Claude (önerilen - en iyi tool calling) |
| 113 | ANTHROPIC_API_KEY=sk-ant-... |
| 114 | |
| 115 | # OpenAI alternatifi |
| 116 | OPENAI_API_KEY=sk-... |
| 117 | |
| 118 | # Ollama ile ücretsiz yerel model |
| 119 | OLLAMA_BASE_URL=http://localhost:11434 |
| 120 | OLLAMA_MODEL=llama3.3 |
| 121 | ``` |
| 122 | |
| 123 | Provider seçimi: |
| 124 | | Provider | Maliyet | Hız | Tool Calling | En İyi Kullanım | |
| 125 | |----------|---------|-----|-------------|-----------------| |
| 126 | | Claude 3.5 Sonnet | ~$3/M token | Hızlı | %95+ başarı | Karmaşık görevler | |
| 127 | | GPT-4o | ~$2.5/M token | Hızlı | %90+ başarı | Genel kullanım | |
| 128 | | Ollama (Llama 3.3) | Ücretsiz | Orta | %80+ başarı | Basit routing, maliyet hassas | |
| 129 | | DeepSeek V3 | ~$0.27/M token | Orta | %85+ başarı | Bütçe dostu | |
| 130 | |
| 131 | ### Adım 4: Kanal Bağlantısı |
| 132 | |
| 133 | #### Telegram |
| 134 | |
| 135 | ```bash |
| 136 | # 1. @BotFather'dan bot oluştur, token al |
| 137 | # 2. .env'ye ekle |
| 138 | TELEGRAM_BOT_TOKEN=123456:ABC... |
| 139 | |
| 140 | # 3. Agent'a Telegram kanalını ekle |
| 141 | openclaw config set --agent my-agent --channel telegram |
| 142 | ``` |
| 143 | |
| 144 | #### Slack |
| 145 | |
| 146 | ```bash |
| 147 | # 1. Slack App oluştur (api.slack.com/apps) |
| 148 | # 2. Bot Token Scopes: chat:write, app_mentions:read |
| 149 | SLACK_BOT_TOKEN=xoxb-... |
| 150 | SLACK_APP_TOKEN=xapp-... |
| 151 | |
| 152 | openclaw config set --agent my-agent --channel slack |
| 153 | ``` |
| 154 | |
| 155 | #### Discord |
| 156 | |
| 157 | ```bash |
| 158 | # 1. Discord Developer Portal'dan bot oluştur |
| 159 | DISCORD_BOT_TOKEN=... |
| 160 | |
| 161 | openclaw config set --agent my-agent --channel discord |
| 162 | ``` |
| 163 | |
| 164 | ### Adım 5: Gateway Güvenlik Sertleştirmesi |
| 165 | |
| 166 | ```bash |
| 167 | # Gateway'i sadece localhost'a bağla (zorunlu) |
| 168 | openclaw config set gateway.host 127.0.0.1 |
| 169 | |
| 170 | # Uzaktan erişim gerekiyorsa SSH tüneli kullan |
| 171 | ssh -L 18789:localhost:18789 user@sunucu |
| 172 | |
| 173 | # Rate limiting aktifleştir |
| 174 | openclaw config set gateway.rateLimit 60 |
| 175 | |
| 176 | # API anahtarlarını .env'de tut, ASLA koda gömme |
| 177 | echo ".env" >> .gitignore |
| 178 | ``` |
| 179 | |
| 180 | Güvenlik kontrol listesi: |
| 181 | - [ ] Gateway port 18789 dışarıya kapalı |
| 182 | - [ ] API anahtarları .env dosyasın |