Skip to main content
Gerçek dünya kurulumları (yerel geliştirme, VPS, çoklu ajan, OAuth/API anahtarları, model yük devri) için hızlı yanıtlar ve ayrıntılı sorun giderme. Çalışma zamanı tanılamaları için Sorun Giderme bölümüne bakın. Tam yapılandırma başvurusu için Yapılandırma bölümüne bakın.

​
Bir şey bozulduğunda ilk 60 saniye

1

Hızlı durum

Hızlı yerel özet: işletim sistemi + güncelleme, gateway/hizmet erişilebilirliği, ajanlar/oturumlar, sağlayıcı yapılandırması + çalışma zamanı sorunları (gateway erişilebilir olduğunda).
2

Yapıştırılabilir rapor (paylaşılması güvenli)

Günlük sonuyla salt okunur tanılama (token’lar gizlenir).
3

Daemon + bağlantı noktası durumu

Gözetmen çalışma zamanı ile RPC erişilebilirliğini, yoklama hedefi URL’sini ve hizmetin muhtemelen hangi yapılandırmayı kullandığını gösterir.
4

Derin yoklamalar

Desteklendiğinde kanal yoklamaları da dahil olmak üzere canlı gateway sistem durumu yoklaması (erişilebilir bir gateway gerektirir). Sistem Durumu bölümüne bakın.
5

En son günlüğü takip edin

RPC çalışmıyorsa şuna geri dönün:
Dosya günlükleri hizmet günlüklerinden ayrıdır; Günlük Kaydı ve Sorun Giderme bölümlerine bakın.
6

Doctor'ı çalıştırın (onarımlar)

Yapılandırmayı ve durumu onarır/taşır, ardından sistem durumu denetimlerini çalıştırır. Doctor bölümüne bakın.
7

Gateway anlık görüntüsü (yalnızca WS)

Çalışan gateway’den tam bir anlık görüntü ister. Sistem Durumu bölümüne bakın.

​
Hızlı başlangıç ve ilk çalıştırma kurulumu

İlk çalıştırma soru-cevapları — kurulum, ilk yapılandırma, kimlik doğrulama yolları, abonelikler, ilk hatalar — İlk Çalıştırma SSS sayfasındadır.

​
OpenClaw nedir?

OpenClaw, kendi cihazlarınızda çalıştırdığınız kişisel bir yapay zekâ asistanıdır. Hâlihazırda kullandığınız mesajlaşma ortamlarında (Discord, Google Chat, iMessage, Mattermost, Signal, Slack, Telegram, WebChat, WhatsApp ve QQ Bot gibi paketle birlikte gelen kanal plugin’leri) yanıt verir ve desteklenen platformlarda ses ile canlı Canvas özelliklerini de kullanabilir. Gateway, sürekli çalışan denetim düzlemidir; ürün ise asistandır.
OpenClaw, “yalnızca bir Claude sarmalayıcısı” değildir. Kendi donanımınızda yetenekli bir asistan çalıştıran, hâlihazırda kullandığınız sohbet uygulamalarından erişilebilen; durum bilgili oturumlar, bellek ve araçlar sunan, iş akışlarınızı barındırılan bir SaaS’a teslim etmenizi gerektirmeyen önce yerel denetim düzlemidir.
  • Cihazlarınız, verileriniz: Gateway’i istediğiniz yerde (Mac, Linux, VPS) çalıştırın; çalışma alanını ve oturum geçmişini yerel tutun.
  • Web korumalı alanı değil, gerçek kanallar: Discord/iMessage/Signal/Slack/Telegram/WhatsApp/vb. ile desteklenen platformlarda mobil ses ve Canvas.
  • Modelden bağımsız: ajan başına yönlendirme ve yük devriyle Anthropic, MiniMax, OpenAI, OpenRouter vb. kullanın.
  • Yalnızca yerel seçeneği: tüm verilerin cihazınızda kalabilmesi için yerel modeller çalıştırın.
  • Çoklu ajan yönlendirmesi: kanal, hesap veya görev başına ayrı ajanlar; her birinin kendi çalışma alanı ve varsayılanları bulunur.
  • Açık kaynaklı ve özelleştirilebilir: sağlayıcı bağımlılığı olmadan inceleyin, genişletin ve kendi sunucunuzda barındırın.
Belgeler: Gateway, Kanallar, Çoklu ajan, Bellek.
İyi ilk projeler: bir web sitesi oluşturmak (WordPress, Shopify veya statik bir site); bir mobil uygulamanın prototipini hazırlamak (taslak, ekranlar, API planı); dosya ve klasörleri düzenlemek; Gmail’e bağlanıp özetleri veya takip işlemlerini otomatikleştirmek.Büyük görevleri yerine getirebilir, ancak görevler aşamalara ayrıldığında ve paralel çalışma için alt ajanlar kullanıldığında en iyi sonucu verir.
  • Kişisel bilgilendirmeler: gelen kutusu, takvim ve ilgilendiğiniz haberlerin özetleri.
  • Araştırma ve taslak hazırlama: e-postalar veya belgeler için hızlı araştırma, özetler ve ilk taslaklar.
  • Hatırlatıcılar ve takip işlemleri: cron veya heartbeat tarafından tetiklenen hatırlatmalar ve kontrol listeleri.
  • Tarayıcı otomasyonu: form doldurma, veri toplama ve web görevlerini yineleme.
  • Cihazlar arası koordinasyon: telefonunuzdan bir görev gönderin, Gateway’in görevi bir sunucuda çalıştırmasını sağlayın ve sonucu sohbette alın.
Evet, araştırma, nitelendirme ve taslak hazırlama için: siteleri tarama, kısa listeler oluşturma, potansiyel müşterileri özetleme, erişim veya reklam metni taslakları yazma.Erişim veya reklam çalışmaları için sürece bir insanı dahil edin. Spam’den kaçının, yerel yasalara ve platform politikalarına uyun ve gönderilmeden önce her şeyi inceleyin. OpenClaw taslağı hazırlasın; siz onaylayın.Belgeler: Güvenlik.
OpenClaw bir kişisel asistan ve koordinasyon katmanıdır; IDE’nin yerine geçmez. Bir repo içindeki en hızlı doğrudan kodlama döngüsü için Claude Code veya Codex kullanın. Kalıcı bellek, cihazlar arası erişim ve araç orkestrasyonu için OpenClaw kullanın.
  • Oturumlar arasında kalıcı bellek ve çalışma alanı.
  • Çok platformlu erişim (Telegram, WhatsApp, TUI, WebChat).
  • Araç orkestrasyonu (tarayıcı, dosyalar, zamanlama, hook’lar).
  • Sürekli çalışan Gateway (bir VPS’te çalıştırın, her yerden etkileşim kurun).
  • Yerel tarayıcı/ekran/kamera/yürütme için Node’lar.
Vitrin: https://openclaw.ai/showcase.

​
Skills ve otomasyon

Repo kopyasını düzenlemek yerine yönetilen geçersiz kılmaları kullanın. Değişiklikleri ~/.openclaw/skills/<name>/SKILL.md içine yerleştirin (veya ~/.openclaw/openclaw.json içindeki skills.load.extraDirs aracılığıyla bir klasör ekleyin). Öncelik: <workspace>/skills -> <workspace>/.agents/skills -> ~/.agents/skills -> ~/.openclaw/skills -> paketle birlikte gelenler -> skills.load.extraDirs; böylece yönetilen geçersiz kılmalar git’e dokunmadan paketle birlikte gelen skill’lere göre öncelik kazanır. Genel olarak kurmak ancak görünürlüğü bazı ajanlarla sınırlamak için paylaşılan kopyayı ~/.openclaw/skills içinde tutun ve görünürlüğü agents.defaults.skills / agents.entries.*.skills ile denetleyin. Yalnızca üst projeye katkı sağlamaya değer düzenlemeler repo kopyasına yönelik PR’lar olarak gönderilmelidir.
Evet: ~/.openclaw/openclaw.json içindeki skills.load.extraDirs aracılığıyla dizinler ekleyin (yukarıdaki sıralamada en düşük öncelik). clawhub varsayılan olarak ./skills içine kurulur; OpenClaw bunu bir sonraki oturumda <workspace>/skills olarak değerlendirir. Görünürlüğü belirli ajanlarla sınırlamak için agents.defaults.skills veya agents.entries.*.skills ile eşleştirin.
Desteklenen kalıplar:
  • Cron işleri: yalıtılmış işler, iş başına bir model geçersiz kılması ayarlayabilir.
  • Ajanlar: görevleri farklı varsayılan modellere, düşünme düzeylerine ve akış parametrelerine sahip ayrı ajanlara yönlendirin.
  • İsteğe bağlı geçiş: /model mevcut oturum modelini herhangi bir zamanda değiştirir.
Örnek — aynı model, ajan başına farklı ayarlar:
Paylaşılan model başına varsayılanları agents.defaults.models["provider/model"].params içine, ardından ajana özgü geçersiz kılmaları düz agents.entries.*.params içine yerleştirin. Aynı modeli iç içe agents.entries.*.models["provider/model"].params altında yinelemeyin; bu yol ajan başına model kataloğu ve çalışma zamanı geçersiz kılmaları içindir.Cron işleri, Çoklu Ajan Yönlendirmesi, Yapılandırma, Eğik çizgi komutları bölümlerine bakın.
Uzun veya paralel görevler için alt ajanları kullanın: kendi oturumlarında çalışır, bir özet döndürür ve ana sohbetinizin yanıt vermeye devam etmesini sağlarlar. Bottan “bu görev için bir alt ajan başlatmasını” isteyin veya /subagents kullanın. Gateway’in o anda meşgul olup olmadığını görmek için /status kullanın.Uzun görevler ve alt ajanların her ikisi de token tüketir; maliyet önemliyse agents.defaults.subagents.model aracılığıyla alt ajanlar için daha ucuz bir model ayarlayın.Belgeler: Alt ajanlar, Arka Plan Görevleri.
Bir Discord ileti dizisini bir alt ajana veya oturum hedefine bağlayın; böylece buradaki takip mesajları bağlı oturumda kalır.
  • thread: true kullanarak sessions_spawn ile başlatın (kalıcı takip için isteğe bağlı olarak mode: "session").
  • Veya /focus <target> ile manuel olarak bağlayın.
  • /agents bağlama durumunu inceler.
  • /session idle <duration|off> ve /session max-age <duration|off> otomatik odaktan çıkarma davranışını denetler.
  • /unfocus ileti dizisinin bağlantısını kaldırır.
Yapılandırma: session.threadBindings.enabled (genel anahtar), session.threadBindings.idleHours (varsayılan 24, 0 devre dışı bırakır), session.threadBindings.maxAgeHours (varsayılan 0 = kesin üst sınır yok) ve başlatma sırasında otomatik bağlama için session.threadBindings.spawnSessions (varsayılan true).Belgeler: Alt ajanlar, Discord, Yapılandırma Başvurusu, Eğik çizgi komutları.
Çözümlenen istekte bulunan rotasını denetleyin:
  • Tamamlanma modundaki alt ajan teslimatı, mevcutsa bağlı bir ileti dizisini veya konuşma rotasını tercih eder.
  • Tamamlanma kaynağı yalnızca bir kanal taşıyorsa OpenClaw, doğrudan teslimatın yine de başarılı olabilmesi için istekte bulunan oturumunun depolanmış rotasına (lastChannel / lastTo / lastAccountId) geri döner.
  • Bağlı rota ve kullanılabilir depolanmış rota yoksa doğrudan teslimat başarısız olabilir ve sonuç hemen gönderilmek yerine kuyruklu oturum teslimatına geri döner.
  • Geçersiz veya eski hedefler de kuyruğa geri dönüşü ya da nihai teslimat hatasını zorunlu kılabilir.
  • Alt öğenin son görünür asistan yanıtı tam olarak NO_REPLY / no_reply veya ANNOUNCE_SKIP ise OpenClaw, eski önceki ilerlemeyi göndermek yerine duyuruyu kasıtlı olarak engeller.
Hata ayıklama: <lookup> bir görev kimliği, çalıştırma kimliği veya oturum anahtarı olmak üzere openclaw tasks show <lookup>.Belgeler: Alt ajanlar, Arka Plan Görevleri, Oturum Araçları.
Cron, Gateway işlemi içinde çalışır; Gateway sürekli çalışmıyorsa tetiklenmez.
  • Cron’un etkin olduğunu (cron.enabled) ve OPENCLAW_SKIP_CRON ayarının yapılmadığını doğrulayın.
  • Gateway’in 24/7 çalıştığını doğrulayın (uyku/yeniden başlatma yok).
  • İşin saat dilimini doğrulayın (--tz ile ana makinenin saat dilimi).
Hata ayıklama:
Belgeler: Cron işleri, Otomasyon.
Teslim modunu kontrol edin:
  • --no-deliver / delivery.mode: "none": çalıştırıcının yedek gönderim yapması beklenmez.
  • Duyuru hedefi eksik veya geçersiz (channel / to): çalıştırıcı giden teslimatı atladı.
  • Kanal kimlik doğrulama hataları (unauthorized, Forbidden): çalıştırıcı teslim etmeyi denedi, ancak kimlik bilgileri bunu engelledi.
  • Sessiz ve yalıtılmış bir sonuç (yalnızca NO_REPLY / no_reply) kasıtlı olarak teslim edilemez kabul edilir; bu nedenle sıraya alınmış yedek teslimat da engellenir.
Yalıtılmış Cron işlerinde, bir sohbet rotası mevcut olduğunda agent yine de message aracını kullanarak doğrudan gönderim yapabilir. --announce, yalnızca agent’ın kendisinin zaten göndermediği son metin için çalıştırıcının yedek teslimatını denetler.Hata ayıklama:
Belgeler: Cron işleri, Arka Plan Görevleri.
Bu, yinelenen zamanlama değil, canlı model değiştirme yoludur. Yalıtılmış Cron, çalışma zamanı model devrini kalıcı hâle getirir ve etkin çalıştırma LiveSessionModelSwitchError hatasını oluşturduğunda yeniden denemeden önce değiştirilen sağlayıcıyı/modeli (ve değiştirilmiş herhangi bir kimlik doğrulama profili geçersiz kılmasını) koruyarak yeniden dener.Model seçimi önceliği: önce Gmail kancası model geçersiz kılması (hooks.gmail.model), ardından iş başına model, sonra saklanan herhangi bir Cron oturumu model geçersiz kılması ve son olarak normal agent/varsayılan model seçimi.Yeniden deneme döngüsü ilk deneme ve 2 değiştirme yeniden denemesiyle sınırlıdır; ardından Cron sonsuza kadar döngüye girmek yerine işlemi iptal eder.Hata ayıklama:
Belgeler: Cron işleri, Cron CLI.
Yerel openclaw skills komutlarını kullanın veya Skills öğelerini çalışma alanınıza yerleştirin; macOS Skills kullanıcı arayüzü Linux’ta kullanılamaz. Skills öğelerine https://clawhub.ai adresinden göz atın.
Yerel openclaw skills install, varsayılan olarak etkin çalışma alanının skills/ dizinine yazar. Tüm yerel agent’lar için paylaşılan yönetilen Skills dizinine kurmak üzere --global ekleyin. Ayrı clawhub CLI’ını yalnızca kendi Skills öğelerinizi yayımlamak veya eşitlemek için kurun. Hangi agent’ların paylaşılan Skills öğelerini görebileceğini daraltmak için agents.defaults.skills veya agents.entries.*.skills kullanın.
Evet, Gateway zamanlayıcısı aracılığıyla:
  • Zamanlanmış veya yinelenen görevler için Cron işleri (yeniden başlatmalarda kalıcıdır).
  • Ana oturumdaki periyodik kontroller için Heartbeat.
  • Özet yayımlayan veya sohbetlere teslimat yapan özerk agent’lar için yalıtılmış işler.
Belgeler: Cron işleri, Otomasyon, Heartbeat.
Doğrudan çalıştıramazsınız. macOS Skills öğeleri, metadata.openclaw.os ve gerekli ikili dosyalarla sınırlandırılır ve yalnızca Gateway ana makinesinde uygun olduklarında yüklenir. Linux’ta yalnızca darwin için olan Skills öğeleri (apple-notes, apple-reminders, things-mac), sınırlandırmayı geçersiz kılmadığınız sürece yüklenmez.Desteklenen üç yöntem:Seçenek A - Gateway’i bir Mac’te çalıştırın (en basit). Gateway’i macOS ikili dosyalarının bulunduğu yerde çalıştırın, ardından Linux’tan uzak modda veya Tailscale üzerinden bağlanın. Gateway ana makinesi macOS olduğundan Skills öğeleri normal şekilde yüklenir.Seçenek B - bir macOS Node’u kullanın (SSH olmadan). Gateway’i Linux’ta çalıştırın, bir macOS Node’unu (menü çubuğu uygulaması) eşleştirin ve Mac’te Node Run Commands ayarını “Always Ask” veya “Always Allow” olarak belirleyin. OpenClaw, gerekli ikili dosyalar Node’da bulunduğunda yalnızca macOS’ta çalışan Skills öğelerini uygun kabul eder; agent bunları nodes aracıyla çalıştırır. “Always Ask” kullanıldığında istemde “Always Allow” seçeneğini onaylamak, ilgili komutu izin listesine ekler.Seçenek C - macOS ikili dosyalarını SSH üzerinden proxy’leyin (ileri düzey). Gateway’i Linux’ta tutun, ancak gerekli CLI ikili dosyalarının bir Mac’te çalışan SSH sarmalayıcılarına çözümlenmesini sağlayın; ardından uygun kalması için Skill’i Linux’a izin verecek şekilde geçersiz kılın.
  1. İkili dosya için bir SSH sarmalayıcısı oluşturun (örnek: Apple Notes için memo):
  2. Sarmalayıcıyı Linux ana makinesindeki PATH konumuna yerleştirin (örneğin ~/bin/memo).
  3. Linux’a izin vermek için Skill meta verilerini (çalışma alanında veya ~/.openclaw/skills içinde) geçersiz kılın:
  4. Skills anlık görüntüsünün yenilenmesi için yeni bir oturum başlatın.
Şu anda yerleşik olarak sunulmuyor. Seçenekler:
  • Özel Skill / Plugin: güvenilir API erişimi için en iyi seçenektir (ikisinin de API’leri vardır).
  • Tarayıcı otomasyonu: kod olmadan çalışır, ancak daha yavaş ve daha kırılgandır.
Ajans tarzı müşteri başına bağlam için her müşteri adına bir Notion sayfası tutun (bağlam + tercihler + etkin çalışma) ve agent’dan oturumun başında bu sayfayı getirmesini isteyin.Yerel bir entegrasyon için özellik isteği açın veya bu API’lere yönelik bir Skill oluşturun.
Yerel kurulumlar etkin çalışma alanının skills/ dizinine yapılır; tüm yerel agent’lar için --global kullanın veya görünürlüğü sınırlamak üzere agents.defaults.skills / agents.entries.*.skills yapılandırın. Bazı Skills öğeleri Homebrew ile kurulmuş ikili dosyalar bekler; Linux’ta bu, Linuxbrew anlamına gelir.Bkz. Skills, Skills yapılandırması, ClawHub.
Chrome DevTools MCP üzerinden bağlanan yerleşik user tarayıcı profilini kullanın:
Özel bir ad için açık bir MCP profili oluşturun:
Bu, yerel ana makine tarayıcısını veya bağlı bir tarayıcı Node’unu kullanabilir. Gateway başka bir yerde çalışıyorsa tarayıcı makinesinde bir Node ana makinesi çalıştırın veya bunun yerine uzak CDP kullanın.Yönetilen openclaw profiline kıyasla existing-session / user profillerindeki mevcut sınırlamalar:
  • click, type, hover, scrollIntoView, drag ve select, CSS seçicileri değil anlık görüntü referanslarını gerektirir.
  • Yükleme kancaları, her seferinde bir dosya olmak üzere ref veya inputRef gerektirir; CSS element desteklenmez.
  • responsebody, PDF dışa aktarma, indirme yakalama ve toplu eylemler hâlâ yönetilen tarayıcı yolunu gerektirir.
Tam karşılaştırma için Tarayıcı bölümüne bakın.

​
Korumalı alan ve bellek

Evet: Korumalı alan. Docker’a özgü kurulum için (Docker’da tam Gateway veya korumalı alan görüntüleri) Docker bölümüne bakın.
Varsayılan görüntü güvenlik önceliklidir ve node kullanıcısı olarak çalışır; bu nedenle sistem paketlerini, Homebrew’i ve paketle birlikte gelen tarayıcıları içermez. Daha kapsamlı bir kurulum için:
  • Önbelleklerin kalıcı olması için /home/node öğesini OPENCLAW_HOME_VOLUME ile kalıcılaştırın.
  • Sistem bağımlılıklarını OPENCLAW_IMAGE_APT_PACKAGES ile görüntüye dahil edin.
  • Playwright tarayıcılarını paketle birlikte gelen CLI aracılığıyla kurun: node /app/node_modules/playwright-core/cli.js install chromium.
  • PLAYWRIGHT_BROWSERS_PATH ayarını yapın ve bu yolu kalıcılaştırın.
Belgeler: Docker, Tarayıcı.
Evet; özel trafik doğrudan mesajlar, herkese açık trafik ise gruplar ise mümkündür. Ana doğrudan mesaj oturumu ana makinede kalırken grup/kanal oturumlarının (ana olmayan anahtarlar) yapılandırılan korumalı alan arka ucunda çalışması için agents.defaults.sandbox.mode: "non-main" ayarını yapın. Korumalı alan etkinleştirildiğinde varsayılan arka uç Docker’dır. Korumalı alanlı oturumlarda kullanılabilen araçları tools.sandbox.tools aracılığıyla sınırlayın.Kurulum kılavuzu: Gruplar: kişisel doğrudan mesajlar + herkese açık gruplar. Temel başvuru: Gateway yapılandırması.
agents.defaults.sandbox.docker.binds ayarını ["host:container:mode"] olarak belirleyin (örneğin "/home/user/src:/src:ro"). Genel ve agent başına bağlamalar birleştirilir; scope: "shared" olduğunda agent başına bağlamalar yok sayılır. Hassas öğeler için :ro kullanın; bağlamalar korumalı alan dosya sistemi duvarlarını aşar.OpenClaw, bağlama kaynaklarını hem normalleştirilmiş yola hem de mevcut en derin üst öğe üzerinden çözümlenen kurallı yola göre doğrular; böylece son yol bölümü henüz mevcut olmasa bile sembolik bağlantı üst öğesi üzerinden kaçışlar güvenli biçimde başarısız olur.Bkz. Korumalı alan ve Korumalı Alan ile Araç İlkesi ile Yükseltilmiş Yetki Karşılaştırması.
OpenClaw belleği, agent çalışma alanındaki Markdown dosyalarından oluşur: memory/YYYY-MM-DD.md içinde günlük notlar, MEMORY.md içinde düzenlenmiş uzun vadeli notlar (yalnızca ana/özel oturumlar).OpenClaw ayrıca Compaction konuşmayı özetlemeden önce sessiz bir Compaction öncesi bellek boşaltma işlemi çalıştırarak modele önce kalıcı notları yazmasını hatırlatır. Yalnızca çalışma alanı yazılabilir olduğunda çalışır (salt okunur korumalı alanlar bunu atlar); agents.defaults.compaction.memoryFlush.enabled: false ile devre dışı bırakın. Bkz. Bellek.
Bottan bilgiyi belleğe yazmasını isteyin: uzun vadeli notlar MEMORY.md içine, kısa vadeli bağlam ise memory/YYYY-MM-DD.md içine yazılır. Modele anıları saklamasını hatırlatmak genellikle sorunu çözer. Unutmaya devam ederse Gateway’in her çalıştırmada aynı çalışma alanını kullandığını doğrulayın.Belgeler: Bellek, Agent çalışma alanı.
Bellek dosyaları diskte bulunur ve silinene kadar kalıcıdır; sınır model değil, depolama alanınızdır. Oturum bağlamı ise modelin bağlam penceresiyle sınırlıdır; bu nedenle uzun konuşmalar sıkıştırılabilir veya kesilebilir. Bellek aramasının var olma nedeni budur: yalnızca ilgili kısımları yeniden bağlama getirir.Belgeler: Bellek, Bağlam.
Yalnızca varsayılan sağlayıcı olan OpenAI gömmelerini kullanıyorsanız gereklidir. Codex OAuth, sohbet/tamamlama işlemlerini kapsar ancak gömmelere erişim sağlamaz; dolayısıyla Codex ile oturum açmak (OAuth veya Codex CLI oturum açma işlemiyle) anlamsal bellek aramasını etkinleştirmez. OpenAI gömmeleri için yine de gerçek bir API anahtarı (OPENAI_API_KEY veya models.providers.openai.apiKey) gerekir.Yerel kalmak için memory.search.provider: "local" (GGUF/llama.cpp) ayarını kullanın. Desteklenen diğer sağlayıcılar: Bedrock, DeepInfra, Gemini (GEMINI_API_KEY veya memory.search.remote.apiKey), GitHub Copilot, LM Studio, Mistral, Ollama, OpenAI uyumlu sağlayıcılar ve Voyage. Kurulum ayrıntıları için Bellek ve Bellek araması bölümlerine bakın.

​
Öğelerin diskte bulunduğu yerler

Hayır: OpenClaw’ın kendi durumu yereldir, ancak harici hizmetler onlara gönderdiklerinizi görmeye devam eder.
  • Varsayılan olarak yerel: oturumlar, bellek dosyaları, yapılandırma ve çalışma alanı Gateway ana makinesinde bulunur (~/.openclaw ve çalışma alanı dizininiz).
  • Zorunlu olarak uzak: model sağlayıcılarına (Anthropic/OpenAI/vb.) gönderilen mesajlar onların API’lerine gider ve sohbet platformları (Slack/Telegram/WhatsApp/vb.) mesaj verilerini kendi sunucularında depolar.
  • Kapsamı siz kontrol edersiniz: yerel modeller istemleri makinenizde tutar, ancak kanal trafiği yine de kanalın sunucularından geçer.
İlgili bölümler: Ajan çalışma alanı, Bellek.
Her şey $OPENCLAW_STATE_DIR altında bulunur (varsayılan: ~/.openclaw):Eski tek ajanlı ~/.openclaw/agent/* yolu, openclaw doctor tarafından taşınır.Çalışma alanınız (AGENTS.md, bellek dosyaları, skills vb.) ayrıdır ve agents.defaults.workspace aracılığıyla yapılandırılır (varsayılan: ~/.openclaw/workspace).
Bunlar ~/.openclaw içinde değil, ajan çalışma alanında bulunur.
  • Çalışma alanı (ajan başına): AGENTS.md, SOUL.md, IDENTITY.md, USER.md, MEMORY.md, memory/YYYY-MM-DD.md, isteğe bağlı HEARTBEAT.md. Küçük harfli kök memory.md, yalnızca eski onarım girdisidir; her ikisi de mevcut olduğunda openclaw doctor --fix, bunu MEMORY.md ile birleştirebilir.
  • Durum dizini (~/.openclaw): yapılandırma, kanal/sağlayıcı durumu, kimlik doğrulama profilleri, oturumlar, günlükler, paylaşılan skills (~/.openclaw/skills).
Varsayılan çalışma alanı ~/.openclaw/workspace olup yapılandırılabilir:
Bot yeniden başlatıldıktan sonra “unutuyorsa”, Gateway’in her başlatmada aynı çalışma alanını kullandığını doğrulayın (uzak mod, yerel dizüstü bilgisayarınızın değil, gateway ana makinesinin çalışma alanını kullanır).İpucu: kalıcı davranış veya tercih için sohbet geçmişine güvenmek yerine bottan bunu AGENTS.md veya MEMORY.md dosyasına yazmasını isteyin.Ajan çalışma alanı ve Bellek bölümlerine bakın.
Evet. SOUL.md, ajan bağlamına eklenen çalışma alanı önyükleme dosyalarından biridir. Dosya başına varsayılan ekleme sınırı 20000 karakterdir; dosyalar arasındaki toplam önyükleme bütçesi 60000 karakterdir.Paylaşılan varsayılanları değiştirin:
Alternatif olarak agents.entries.*.bootstrapMaxChars / bootstrapTotalMaxChars altındaki tek bir ajan için geçersiz kılın.Ham ve eklenen boyutları ve kesme gerçekleşip gerçekleşmediğini kontrol etmek için /context kullanın. SOUL.md dosyasını ses, duruş ve kişiliğe odaklı tutun; çalışma kurallarını AGENTS.md içine, kalıcı bilgileri ise belleğe koyun.Bağlam ve Ajan yapılandırması bölümlerine bakın.
Ajan çalışma alanınızı özel bir git deposuna koyun ve özel bir yerde (örneğin özel GitHub deposunda) yedekleyin. Bu işlem belleği ve AGENTS/SOUL/USER dosyalarını kapsar ve yardımcının “zihnini” daha sonra geri yüklemenizi sağlar.~/.openclaw altındaki hiçbir şeyi (kimlik bilgileri, oturumlar, token’lar, şifrelenmiş gizli veri yükleri) kaydetmeyin. Tam geri yükleme için çalışma alanını ve durum dizinini ayrı ayrı yedekleyin.Belgeler: Ajan çalışma alanı.
Kaldırma bölümüne bakın.
Evet. Çalışma alanı katı bir sandbox değil, varsayılan cwd ve bellek bağlantı noktasıdır. Göreli yollar çalışma alanı içinde çözümlenir; sandbox etkinleştirilmediği sürece mutlak yollar ana makinedeki diğer konumlara erişebilir. Yalıtım için agents.defaults.sandbox veya ajan başına sandbox ayarlarını kullanın. Bir depoyu varsayılan çalışma dizini yapmak için söz konusu ajanın workspace ayarını depo köküne yönlendirin. OpenClaw deposunun kendisi yalnızca kaynak koddur; bu nedenle ajanın kasıtlı olarak depo içinde çalışmasını istemediğiniz sürece çalışma alanını ayrı tutun.
Oturum durumu gateway ana makinesine aittir. Uzak modda önem verdiğiniz oturum deposu yerel dizüstü bilgisayarınızda değil, uzak makinededir. Oturum yönetimi bölümüne bakın.

​
Yapılandırma temelleri

OpenClaw, isteğe bağlı JSON5 yapılandırmasını $OPENCLAW_CONFIG_PATH konumundan okur (varsayılan: ~/.openclaw/openclaw.json). Dosya yoksa ~/.openclaw/workspace varsayılan çalışma alanı dâhil, nispeten güvenli varsayılanları kullanır.
Geri döngü dışı bağlamalar geçerli bir gateway kimlik doğrulama yolu gerektirir: paylaşılan gizli anahtar kimlik doğrulaması (token veya parola) ya da doğru yapılandırılmış kimlik farkındalığına sahip bir ters proxy arkasında gateway.auth.mode: "trusted-proxy".
  • gateway.remote.token / .password, yerel gateway kimlik doğrulamasını kendi başlarına etkinleştirmez; yerel çağrı yolları yalnızca gateway.auth.* ayarlanmamışsa gateway.remote.* değerini yedek olarak kullanabilir.
  • Parola kimlik doğrulaması için gateway.auth.mode: "password" ile birlikte gateway.auth.password (veya OPENCLAW_GATEWAY_PASSWORD) ayarlayın.
  • gateway.auth.token / .password, SecretRef aracılığıyla açıkça yapılandırılmış ancak çözümlenmemişse çözümleme güvenli biçimde başarısız olur (uzak yedek mekanizması hatayı maskelemez).
  • Paylaşılan gizli anahtarlı Control UI kurulumları, connect.params.auth.token veya connect.params.auth.password (uygulama/kullanıcı arayüzü ayarlarında saklanır) aracılığıyla kimlik doğrular. Tailscale Serve veya trusted-proxy gibi kimlik taşıyan modlar bunun yerine istek üstbilgilerini kullanır; paylaşılan gizli anahtarları URL’lere koymaktan kaçının.
  • gateway.auth.mode: "trusted-proxy" kullanıldığında, aynı ana makinedeki geri döngü ters proxy’leri açık bir gateway.auth.trustedProxy.allowLoopback = true ayarı ve gateway.trustedProxies içinde bir geri döngü girdisi gerektirir.
OpenClaw, geri döngü dâhil olmak üzere gateway kimlik doğrulamasını varsayılan olarak zorunlu kılar. Açık bir kimlik doğrulama yolu yapılandırılmamışsa başlangıç, token modunu seçer ve yalnızca o başlatma süresince geçerli bir token üretir; dolayısıyla yerel WS istemcilerinin kimlik doğrulaması gerekir. Bu, diğer yerel işlemlerin Gateway’i çağırmasını engeller.İstemcilerin yeniden başlatmalar arasında kararlı bir gizli anahtara ihtiyacı olduğunda gateway.auth.token, gateway.auth.password, OPENCLAW_GATEWAY_TOKEN veya OPENCLAW_GATEWAY_PASSWORD ayarını açıkça yapılandırın. Ayrıca parola modunu veya kimlik farkındalığına sahip ters proxy’ler için trusted-proxy seçeneğini belirleyebilirsiniz. Açık geri döngü için gateway.auth.mode: "none" ayarını açıkça belirleyin. openclaw doctor --generate-gateway-token her zaman bir token üretir.
Gateway yapılandırmayı izler ve çalışırken yeniden yüklemeyi destekler: gateway.reload.mode: "hybrid" (varsayılan), güvenli değişiklikleri çalışırken uygular ve kritik değişiklikler için yeniden başlatır. hot, restart ve off de desteklenir. Çoğu tools.*, agents.* ilkesi, session.* ve messages.* değişikliği herhangi bir yeniden yükleme işlemi olmadan hemen uygulanır; gateway.* bağlama/port değişiklikleri yeniden başlatma gerektirir.
web_fetch API anahtarı olmadan çalışır. web_search seçtiğiniz sağlayıcıya bağlıdır:Grok ayrıca model kimlik doğrulamasındaki xAI OAuth’u (openclaw onboard --auth-choice xai-oauth) yeniden kullanabilir.Önerilen: openclaw configure --section web ve bir sağlayıcı seçin.
Sağlayıcıya özgü web araması yapılandırması plugins.entries.<plugin>.config.webSearch.* altında bulunur. Eski tools.web.search.* sağlayıcı yolları uyumluluk için hâlâ yüklenir ancak yeni yapılandırmalarda kullanılmamalıdır. Firecrawl web getirme yedek yapılandırması plugins.entries.firecrawl.config.webFetch.* altında bulunur.
  • İzin listeleri: web_search/web_fetch/x_search veya üçü birden için group:web ekleyin.
  • web_fetch varsayılan olarak etkindir.
  • tools.web.fetch.provider belirtilmezse OpenClaw, kullanılabilir kimlik bilgilerinden hazır durumdaki ilk getirme yedek sağlayıcısını otomatik olarak algılar; resmi Firecrawl Plugin’i bu yedeği sağlar.
  • Arka plan hizmetleri, ortam değişkenlerini ~/.openclaw/.env dosyasından (veya hizmet ortamından) okur.
Belgeler: Web araçları.
config.apply, yapılandırmanın tamamını değiştirir; kısmi bir nesne diğer her şeyi kaldırır.Güncel OpenClaw, kazara gerçekleşen üzerine yazmaların çoğunu önler:
  • OpenClaw’a ait yapılandırma yazma işlemleri, yazmadan önce değişiklik sonrası yapılandırmanın tamamını doğrular.
  • Geçersiz veya yıkıcı OpenClaw yazma işlemleri reddedilir ve openclaw.json.rejected.* olarak kaydedilir.
  • Başlatmayı veya çalışırken yeniden yüklemeyi bozan doğrudan bir düzenleme, Gateway’in güvenli biçimde başarısız olmasına veya yeniden yüklemeyi atlamasına neden olur; openclaw.json dosyasını yeniden yazmaz.
  • Onarımın sahibi openclaw doctor --fix’dir; bilinen son iyi durumu geri yükleyebilir ve reddedilen dosyayı openclaw.json.clobbered.* olarak kaydeder.
Kurtarma:
  • openclaw logs --follow içinde Invalid config at, Config write rejected: veya config reload skipped (invalid config) olup olmadığını kontrol edin.
  • Etkin yapılandırmanın yanındaki en yeni openclaw.json.clobbered.* veya openclaw.json.rejected.* dosyasını inceleyin.
  • openclaw config validate ve openclaw doctor --fix komutlarını çalıştırın.
  • Yalnızca amaçlanan anahtarları openclaw config set veya config.patch ile geri kopyalayın.
  • Bilinen son iyi durum veya reddedilmiş veri yoksa yedekten geri yükleyin ya da openclaw doctor komutunu yeniden çalıştırıp kanalları/modelleri yeniden yapılandırın.
  • Beklenmeyen kayıp durumunda, bilinen son yapılandırmanız veya bir yedeğinizle hata bildirimi oluşturun. Yerel bir kodlama aracısı, günlüklerden veya geçmişten çoğu zaman çalışan bir yapılandırmayı yeniden oluşturabilir.
Önlemek için: küçük değişikliklerde openclaw config set, etkileşimli düzenlemelerde openclaw configure, bilinmeyen bir yolu incelemek için config.schema.lookup (yüzeysel bir şema düğümü ve doğrudan alt öğe özetlerini döndürür), kısmi RPC düzenlemelerinde ise config.patch kullanın; config.apply seçeneğini yapılandırmanın tamamını değiştirmek için ayırın. Aracıya yönelik gateway çalışma zamanı aracı, eski tools.bash.* takma adları üzerinden bile tools.exec.ask / tools.exec.security yollarını yeniden yazmayı reddeder.Belgeler: Yapılandırma, Yapılandırma işlemi, Gateway sorunlarını giderme, Doctor.
Yaygın düzen: bir Gateway (örneğin Raspberry Pi) ile Node’lar ve aracılar.
  • Gateway (merkezi): kanalların (Signal/WhatsApp), yönlendirmenin ve oturumların sahibidir.
  • Node’lar (cihazlar): Mac/iOS/Android cihazlar çevre birimi olarak bağlanır ve yerel araçları (system.run, canvas, camera) kullanıma sunar.
  • Aracılar (çalışanlar): özel roller için (örneğin operasyonlar ve kişisel veriler) ayrı beyinler/çalışma alanlarıdır.
  • Alt aracılar: paralellik sağlamak için ana aracıdan arka plan işleri başlatır.
  • TUI: Gateway’e bağlanır ve aracılar/oturumlar arasında geçiş yapar.
Belgeler: Node’lar, Uzaktan erişim, Çok Aracılı Yönlendirme, Alt aracılar, TUI.
Evet:
Varsayılan değer false’dir (arayüzlü). Başsız modun bazı sitelerde bot karşıtı denetimleri tetikleme olasılığı daha yüksektir (X/Twitter başsız oturumları sık sık engeller). Aynı Chromium motorunu kullanır ve çoğu otomasyon için çalışır; temel fark, görünür bir tarayıcı penceresinin olmamasıdır (görseller için ekran görüntülerini kullanın). Bkz. Tarayıcı.
browser.executablePath değerini Brave ikili dosyanızın (veya Chromium tabanlı herhangi bir tarayıcının) yolu olarak ayarlayın ve Gateway’i yeniden başlatın. Bkz. Tarayıcı.

​
Uzak Gateway’ler ve Node’lar

Telegram mesajları, aracıyı çalıştıran Gateway tarafından işlenir ve yalnızca bir Node aracına ihtiyaç duyulduğunda Gateway WebSocket üzerinden Node’lar çağrılır:Telegram -> Gateway -> Aracı -> node.* -> Node -> Gateway -> TelegramNode’lar gelen sağlayıcı trafiğini görmez; yalnızca Node RPC çağrılarını alırlar.
Bilgisayarınızı bir Node olarak eşleştirin. Gateway başka bir yerde çalışır ancak Gateway WebSocket üzerinden yerel makinenizdeki node.* araçlarını (ekran, kamera, sistem) çağırabilir.
  1. Gateway’i sürekli açık olan ana makinede (VPS/ev sunucusu) çalıştırın.
  2. Gateway ana makinesini ve bilgisayarınızı aynı tailnet’e yerleştirin.
  3. Gateway WS’ye erişilebildiğinden emin olun (tailnet bağlaması veya SSH tüneli).
  4. macOS uygulamasını yerel olarak açın ve Node olarak kaydolması için Remote over SSH modunda (veya doğrudan tailnet üzerinden) bağlanın.
  5. Node’u onaylayın:
Ayrı bir TCP köprüsü gerekmez; Node’lar Gateway WebSocket üzerinden bağlanır.Güvenlik hatırlatması: bir macOS Node’unu eşleştirmek, bu makinede system.run kullanımına izin verir. Yalnızca güvendiğiniz cihazları eşleştirin; Güvenlik bölümünü inceleyin.Belgeler: Node’lar, Gateway protokolü, macOS uzak modu, Güvenlik.
Temel noktaları kontrol edin:
Ardından kimlik doğrulamayı ve yönlendirmeyi doğrulayın: Tailscale Serve kullanıyorsanız gateway.auth.allowTailscale değerinin doğru ayarlandığını onaylayın; SSH tüneli üzerinden bağlanıyorsanız tünelin etkin olduğunu ve doğru bağlantı noktasını hedeflediğini doğrulayın; doğrudan mesaj/grup izin listelerinizin hesabınızı içerdiğini onaylayın.Belgeler: Tailscale, Uzaktan erişim, Kanallar.
Evet, ancak yerleşik bir bottan bota köprü yoktur.En basit yöntem: iki botun da erişebildiği normal bir sohbet kanalı (Slack/Telegram/WhatsApp) kullanın. Bot A’nın Bot B’ye mesaj göndermesini sağlayın, ardından Bot B’nin her zamanki gibi yanıt vermesine izin verin.CLI köprüsü (genel): diğer botun dinlediği bir sohbeti hedefleyerek openclaw agent --message ... --deliver ile diğer Gateway’i çağıran bir betik çalıştırın. Botlardan biri uzak bir VPS’deyse CLI’nızı SSH/Tailscale üzerinden bu uzak Gateway’e yönlendirin (bkz. Uzaktan erişim):
İki botun sonsuz bir döngüye girmemesi için bir koruma ekleyin (yalnızca bahsetme, kanal izin listeleri veya “bot mesajlarına yanıt verme” kuralı).Belgeler: Uzaktan erişim, Aracı CLI’sı, Aracı gönderimi.
Hayır. Tek bir Gateway, her biri kendi çalışma alanına, model varsayılanlarına ve yönlendirmesine sahip birden fazla aracıyı barındırır; bu normal kurulumdur ve aracı başına bir VPS kullanmaktan çok daha ucuz/basittir. Ayrı VPS’leri yalnızca katı yalıtım (güvenlik sınırları) veya paylaşmak istemediğiniz çok farklı yapılandırmalar için kullanın.
Evet: Node’lar, uzak bir Gateway’den dizüstü bilgisayarınıza ulaşmanın birinci sınıf yoludur ve kabuk erişiminden daha fazlasını kullanıma açar. Gateway macOS/Linux üzerinde (Windows’ta WSL2 üzerinden) çalışır ve hafiftir (küçük bir VPS veya Raspberry Pi sınıfı cihaz yeterlidir; 4 GB RAM fazlasıyla yeterli olur), bu nedenle yaygın kurulum sürekli açık bir ana makine ile Node olarak kullanılan dizüstü bilgisayarınızdır.
  • Gelen SSH gerekmez - Node’lar cihaz eşleştirme yoluyla Gateway WebSocket’e dışarı doğru bağlanır.
  • Daha güvenli yürütme denetimleri - system.run, söz konusu dizüstü bilgisayardaki Node izin listeleri/onaylarıyla sınırlandırılır.
  • Daha fazla cihaz aracı - Node’lar system.run’ye ek olarak canvas, camera ve screen araçlarını kullanıma sunar.
  • Yerel tarayıcı otomasyonu - Gateway’i bir VPS’de tutup Chrome’u bir Node ana makinesi üzerinden yerel olarak çalıştırın veya Chrome MCP üzerinden yerel Chrome’a bağlanın.
SSH, geçici kabuk erişimi için uygundur; devam eden aracı iş akışları ve cihaz otomasyonu için Node’lar daha basittir.Belgeler: Node’lar, Node CLI’sı, Tarayıcı.
Hayır. Bilerek yalıtılmış profiller çalıştırmadığınız sürece ana makine başına yalnızca bir Gateway çalışmalıdır (bkz. Birden fazla Gateway). Node’lar Gateway’e bağlanan çevre birimleridir (iOS/Android Node’ları veya menü çubuğu uygulamasındaki macOS “node mode”). Başsız Node ana makineleri ve CLI denetimi için bkz. Node ana makinesi CLI’sı.gateway, discovery ve barındırılan Plugin yüzeyi değişiklikleri için tam yeniden başlatma gerekir.
Evet:
  • config.schema.lookup: yazmadan önce yüzeysel şema düğümü, eşleşen kullanıcı arayüzü ipucu ve doğrudan alt öğe özetleriyle tek bir yapılandırma alt ağacını inceleyin.
  • config.get: mevcut anlık görüntüyü ve karmayı alın.
  • config.patch: güvenli kısmi güncelleme (çoğu RPC düzenlemesi için tercih edilir); mümkün olduğunda çalışırken yeniden yükler, gerektiğinde yeniden başlatır.
  • config.apply: yapılandırmanın tamamını doğrular ve değiştirir; mümkün olduğunda çalışırken yeniden yükler, gerektiğinde yeniden başlatır.
  • Aracıya yönelik gateway çalışma zamanı aracı, tools.exec.ask / tools.exec.security yollarını yeniden yazmayı hâlâ reddeder; eski tools.bash.* takma adları aynı korumalı yollara normalleştirilir.
Çalışma alanınızı ayarlar ve botu kimlerin tetikleyebileceğini sınırlar.
  1. VPS’te kurun ve oturum açın:
  2. Tailscale uygulamasını kullanarak Mac’inizde kurun ve oturum açın; aynı tailnet’i kullanın.
  3. VPS’in kararlı bir ada sahip olması için Tailscale yönetici konsolunda MagicDNS’i etkinleştirin.
  4. Tailnet ana bilgisayar adını kullanın: SSH ssh user@your-vps.tailnet-xxxx.ts.net; Gateway WS ws://your-vps.tailnet-xxxx.ts.net:18789.
SSH olmadan Denetim Arayüzü’nü kullanmak için VPS’te Tailscale Serve’ü kullanın:
Bu, Gateway’i geri döngüye bağlı tutar ve HTTPS’i Tailscale üzerinden kullanıma açar. Bkz. Tailscale.
Serve, Gateway Denetim Arayüzü + WS’yi kullanıma açar; node’lar aynı Gateway WS uç noktası üzerinden bağlanır.
  1. VPS ile Mac’in aynı tailnet’te olduğundan emin olun.
  2. macOS uygulamasını Uzak modda kullanın (SSH hedefi tailnet ana bilgisayar adı olabilir) — uygulama Gateway portuna tünel açar ve node olarak bağlanır.
  3. Node’u onaylayın:
Belgeler: Gateway protokolü, Keşif, macOS uzak modu.
İkinci dizüstü bilgisayarda yalnızca yerel araçları (ekran/kamera/exec) kullanmak için cihazı node olarak ekleyin; tek Gateway kullanılır ve yapılandırma çoğaltılmaz. Yerel node araçları şu anda yalnızca macOS’te kullanılabilir. İkinci bir Gateway’i yalnızca katı yalıtım veya tamamen ayrı iki bot için kurun.Belgeler: Node’lar, Node CLI’si, Birden çok Gateway.

​
Ortam değişkenleri ve .env yükleme

OpenClaw, ortam değişkenlerini üst süreçten (kabuk, launchd/systemd, CI vb.) okur ve ayrıca şunları yükler:
  • .env, geçerli çalışma dizininden.
  • ~/.openclaw/.env ($OPENCLAW_STATE_DIR/.env) konumundaki genel yedek .env.
İki .env dosyası da mevcut ortam değişkenlerini geçersiz kılmaz. Sağlayıcı kimlik bilgileri ve uç nokta yönlendirme anahtarları, çalışma alanı .env için istisnadır: GEMINI_API_KEY, XAI_API_KEY, MISTRAL_API_KEY gibi anahtarlar veya _ENDPOINT ile biten herhangi bir anahtar (ve diğer paketlenmiş sağlayıcı kimlik doğrulama ya da uç nokta ortam değişkenleri), çalışma alanı .env içinden yok sayılır ve süreç ortamında, ~/.openclaw/.env içinde veya env yapılandırmasında bulunmalıdır.Yapılandırmadaki satır içi ortam değişkenleri yalnızca süreç ortamında eksik olmaları durumunda uygulanır:
Tam öncelik sırası ve kaynaklar için bkz. /environment.
İki çözüm vardır:
  1. Eksik anahtarları ~/.openclaw/.env içine koyun; böylece hizmet, kabuk ortamınızı devralmasa bile yüklenirler.
  2. Kabuktan içe aktarmayı etkinleştirin (isteğe bağlı kolaylık):
    Bu, oturum açma kabuğunuzu çalıştırır ve yalnızca eksik olan beklenen anahtarları içe aktarır (mevcut olanları hiçbir zaman geçersiz kılmaz). Ortam değişkeni eşdeğerleri: OPENCLAW_LOAD_SHELL_ENV=1, OPENCLAW_SHELL_ENV_TIMEOUT_MS=15000.
openclaw models status, kabuk ortamını içe aktarmanın etkin olup olmadığını bildirir. “Shell env: off”, ortam değişkenlerinizin eksik olduğu anlamına gelmez; yalnızca OpenClaw’ın oturum açma kabuğunuzu otomatik olarak yüklemeyeceği anlamına gelir.Gateway bir hizmet olarak (launchd/systemd) çalışıyorsa kabuk ortamınızı devralmaz. Token’ı ~/.openclaw/.env içine koyarak, env.shellEnv.enabled: true özelliğini etkinleştirerek veya env yapılandırmasına ekleyerek (yalnızca eksikse uygulanır) sorunu giderin; ardından Gateway’i yeniden başlatıp tekrar kontrol edin:
Copilot token’ları şu sırayla çözümlenir: OPENCLAW_GITHUB_TOKEN, ardından COPILOT_GITHUB_TOKEN, sonra GH_TOKEN ve son olarak GITHUB_TOKEN.Bkz. /concepts/model-providers ve /environment.

​
Oturumlar ve birden çok sohbet

/new veya /reset değerini tek başına bir mesaj olarak gönderin. Bkz. Oturum yönetimi.
Hayır, varsayılan olarak sıfırlanmaz. Oturumlar aynı sessionId değerini korur ve konuşmalar büyüdükçe Compaction, etkin model bağlamını sınırlar. /new ve /reset kullanılabilir durumda kalır; ayrıca mode: "daily" veya mode: "idle" ile otomatik sıfırlamaları etkinleştirebilirsiniz. Günlük mod, Gateway ana bilgisayarında session.reset.atHour saatinde (varsayılan 4, 0-23) yeni güne geçer; boşta modu ise Heartbeat/Cron/exec sistem olaylarını değil, son gerçek etkileşimden bu yana geçen session.reset.idleMinutes süresini kullanır.
resetByType; direct, group ve thread değerlerini destekler. Doctor, eski dm girdilerini direct biçimine taşır; şema dm değerini reddeder. Eski üst düzey session.idleMinutes, hiçbir session.reset/resetByType bloğu ayarlanmamışsa boşta modu varsayılanı için uyumluluk takma adı olarak çalışmaya devam eder. Yaşam döngüsünün tamamı için bkz. Oturum yönetimi.
Evet, çoklu agent yönlendirmesi ve alt agent’lar aracılığıyla: bir koordinatör agent ile kendi çalışma alanlarına ve modellerine sahip birkaç çalışan agent.Bunu eğlenceli bir deney olarak görmek en iyisidir; çok fazla token tüketir ve çoğu zaman ayrı oturumlara sahip tek bir bottan daha az verimlidir. Tipik model, konuştuğunuz tek bir botun paralel işler için farklı oturumlar kullanması ve gerektiğinde alt agent’lar oluşturmasıdır.Belgeler: Çoklu agent yönlendirmesi, Alt agent’lar, Agent CLI’si.
Oturum bağlamı, model penceresiyle sınırlıdır. Uzun sohbetler, büyük araç çıktıları veya çok sayıda dosya Compaction ya da kesilmeyi tetikleyebilir.
  • Bottan mevcut durumu özetlemesini ve bir dosyaya yazmasını isteyin.
  • Uzun görevlerden önce /compact, konu değiştirirken /new kullanın.
  • Önemli bağlamı çalışma alanında tutun ve bottan yeniden okumasını isteyin.
  • Ana sohbetin daha küçük kalması için uzun veya paralel işlerde alt agent’ları kullanın.
  • Bu durum sık yaşanıyorsa daha büyük bağlam penceresine sahip bir model seçin.
Etkileşimsiz tam sıfırlama:
Ardından kurulumu yeniden çalıştırın:
Mevcut bir yapılandırma algılarsa ilk katılım işlemi de Sıfırla seçeneğini sunar; bkz. İlk katılım (CLI). Profiller (--profile / OPENCLAW_PROFILE) kullandıysanız her durum dizinini sıfırlayın (varsayılan ~/.openclaw-<profile>). Yalnızca geliştirmeye yönelik sıfırlama: openclaw gateway --dev --reset, geliştirme yapılandırmasını, kimlik bilgilerini, oturumları ve çalışma alanını siler.
  • Compaction uygulayın (konuşmayı korur, eski sıraları özetler): özeti yönlendirmek için /compact veya /compact <instructions>.
  • Sıfırlayın (aynı sohbet anahtarı için yeni oturum kimliği): /new veya /reset.
Sorun devam ederse eski araç çıktılarını kırpmak için oturum budamayı (agents.defaults.contextPruning) ayarlayın veya daha büyük bağlam penceresine sahip bir model kullanın.Belgeler: Compaction, Oturum budama, Oturum yönetimi.
Sağlayıcı doğrulama hatası: model, gerekli input alanı olmadan bir tool_use bloğu üretti. Bu genellikle oturum geçmişinin eski veya bozuk olduğu anlamına gelir (çoğunlukla uzun ileti dizilerinden ya da bir araç/şema değişikliğinden sonra).Çözüm: /new ile yeni bir oturum başlatın (tek başına mesaj).
Heartbeat’ler varsayılan olarak her 30m aralıkla; çözümlenen kimlik doğrulama modu Anthropic OAuth/token kimlik doğrulamasıysa (Claude CLI yeniden kullanımı dâhil) ve heartbeat.every ayarlanmamışsa her 1h aralıkla çalışır. Ayarlamak veya devre dışı bırakmak için:
HEARTBEAT.md mevcut ancak işlevsel olarak boşsa (yalnızca boş satırlar, Markdown/HTML yorumları, ATX başlıkları, çit işaretçileri veya boş liste öğesi taslakları içeriyorsa), OpenClaw API çağrılarını azaltmak için Heartbeat çalıştırmasını atlar. Dosya eksikse Heartbeat yine çalışır ve ne yapılacağına model karar verir.Agent başına geçersiz kılmalar agents.entries.*.heartbeat kullanır. Belgeler: Heartbeat.
Hayır. OpenClaw kendi hesabınızda çalışır; gruptaysanız OpenClaw grubu görebilir. Varsayılan olarak, gönderenlere izin verene kadar grup yanıtları engellenir (groupPolicy: "allowlist").Grup yanıtlarını yalnızca kendinizle sınırlandırmak için:
En hızlı yöntem: günlükleri canlı izleyin ve gruba bir test mesajı gönderin.
1234567890-1234567890@g.us gibi, @g.us ile biten chatId (veya from) değerini arayın.Zaten yapılandırılmış/izin verilenler listesine eklenmişse grupları yapılandırmadan listeleyin:
Belgeler: WhatsApp, Dizin, Günlükler.
İki yaygın neden vardır: bahsetme kapısı varsayılan olarak açıktır (bottan @bahsetmeniz veya mentionPatterns ile eşleşmeniz gerekir) ya da channels.whatsapp.groups değerini "*" olmadan yapılandırmışsınızdır ve grup izin verilenler listesinde değildir.Bkz. Gruplar ve Grup mesajları.
Doğrudan sohbetler varsayılan olarak ana oturumda birleştirilir. Grupların/kanalların kendi oturum anahtarları vardır; Telegram konuları ve Discord ileti dizileri ayrı oturumlardır. Bkz. Gruplar ve Grup mesajları.
Kesin bir sınır yoktur; onlarca, hatta yüzlerce oluşturabilirsiniz, ancak şunlara dikkat edin:
  • Disk büyümesi: etkin oturumlar ve transkriptler ajan başına SQLite veritabanında bulunur; eski/arşiv yapıtları yine de ~/.openclaw/agents/<agentId>/sessions/ altında birikebilir.
  • Token maliyeti: daha fazla ajan, daha fazla eşzamanlı model kullanımı demektir.
  • Operasyon yükü: ajan başına kimlik doğrulama profilleri, çalışma alanları ve kanal yönlendirmesi.
Her ajan için bir etkin çalışma alanı (agents.defaults.workspace) tutun, disk büyürse eski oturumları openclaw sessions cleanup ile temizleyin (etkin SQLite durumunu elle düzenlemeyin) ve sahipsiz çalışma alanlarıyla profil uyuşmazlıklarını tespit etmek için openclaw doctor kullanın.
Evet, Çok Ajanlı Yönlendirme aracılığıyla: birden fazla yalıtılmış ajan çalıştırın ve gelen mesajları kanal/hesap/eş düzey varlığa göre yönlendirin. Slack bir kanal olarak desteklenir ve belirli ajanlara bağlanabilir.Tarayıcı erişimi güçlüdür ancak “bir insanın yapabildiği her şeyi yapamaz”; bot önleme mekanizmaları, CAPTCHA’lar ve MFA yine de otomasyonu engelleyebilir. En güvenilir denetim için ana makinedeki yerel Chrome MCP’yi veya tarayıcıyı gerçekten çalıştıran makinedeki CDP’yi kullanın.En iyi uygulama kurulumu: sürekli açık bir Gateway ana makinesi (VPS/Mac mini), rol başına bir ajan (bağlamalar), bu ajanlara bağlanmış Slack kanalları ve gerektiğinde Chrome MCP ya da bir Node aracılığıyla yerel tarayıcı.Belgeler: Çok Ajanlı Yönlendirme, Slack, Tarayıcı, Node’lar.

​
Modeller, yük devretme ve kimlik doğrulama profilleri

Model SSS’si (varsayılanlar, seçim, takma adlar, geçiş, yük devretme ve kimlik doğrulama profilleri) Modeller SSS sayfasındadır.

​
Gateway: bağlantı noktaları, “zaten çalışıyor” ve uzak mod

gateway.port, WebSocket + HTTP (Control UI, hook’lar vb.) için tek çoklanmış bağlantı noktasını denetler. Öncelik sırası:
“Running”, gözetmenin görünümüdür (launchd/systemd/schtasks); bağlantı yoklaması ise CLI’ın gerçekten Gateway WebSocket’ine bağlanmasıdır. openclaw gateway status çıktısındaki şu satırlara güvenin: Probe target: (yoklamanın kullandığı URL), Listening: (bağlantı noktasına gerçekte neyin bağlandığı), Last gateway error: (işlem çalıştığı hâlde bağlantı noktası dinlemiyorsa yaygın temel neden).
Hizmet başka bir yapılandırma dosyasını çalıştırırken siz bir yapılandırma dosyasını düzenliyorsunuz (genellikle --profile / OPENCLAW_STATE_DIR uyuşmazlığı).Düzeltmek için hizmetin kullanmasını istediğiniz --profile / ortamdan şunu çalıştırın:
OpenClaw, başlangıçta WebSocket dinleyicisini hemen bağlayarak bir çalışma zamanı kilidi uygular (varsayılan ws://127.0.0.1:18789). Bağlama EADDRINUSE ile başarısız olursa GatewayLockError (“another gateway instance is already listening”) hatasını verir.Düzeltme: diğer örneği durdurun, bağlantı noktasını boşaltın veya openclaw gateway --port <port> ile çalıştırın.
gateway.mode: "remote" değerini ayarlayıp uzak bir WebSocket URL’sine yönlendirin; isteğe bağlı olarak paylaşılan gizli anahtar tabanlı uzak kimlik bilgilerini kullanabilirsiniz:
  • openclaw gateway yalnızca gateway.mode değeri local olduğunda (veya bir geçersiz kılma bayrağı ilettiğinizde) başlar.
  • macOS uygulaması yapılandırma dosyasını izler ve bu değerler değiştiğinde modları canlı olarak değiştirir.
  • gateway.remote.token / .password yalnızca istemci tarafındaki uzak kimlik bilgileridir; tek başlarına yerel Gateway kimlik doğrulamasını etkinleştirmezler.
Gateway kimlik doğrulama yolunuz ile UI’ın kimlik doğrulama yöntemi eşleşmiyor.Gerçekler (koddan):
  • Control UI, token’ı sessionStorage içinde tutar ve geçerli tarayıcı sekmesiyle seçili Gateway URL’siyle sınırlar; böylece aynı sekmedeki yenilemeler, token’ın localStorage’da uzun süreli kalıcılığı olmadan çalışmaya devam eder.
  • AUTH_TOKEN_MISMATCH durumunda güvenilen istemciler, Gateway yeniden deneme ipuçları (canRetryWithDeviceToken=true, recommendedNextStep=retry_with_device_token) döndürdüğünde önbelleğe alınmış bir cihaz token’ıyla sınırlandırılmış tek bir yeniden deneme yapabilir.
  • Bu önbelleğe alınmış token yeniden denemesi, cihaz token’ıyla saklanan önbelleğe alınmış onaylı kapsamları yeniden kullanır; açık deviceToken / açık scopes çağıranlar, önbelleğe alınmış kapsamları devralmak yerine istedikleri kapsam kümesini korur.
  • Bu yeniden deneme yolunun dışında bağlantı kimlik doğrulama önceliği şöyledir: önce açıkça belirtilmiş paylaşılan token/parola, ardından açık deviceToken, sonra saklanan cihaz token’ı ve son olarak önyükleme token’ı.
  • Yerleşik kurulum kodu önyüklemesi, güvenilen mobil ilk katılım için scopes: [] içeren bir Node cihaz token’ı ve sınırlandırılmış bir operatör devir token’ı döndürür. Operatör devri, kurulum zamanındaki yerel yapılandırmayı okuyabilir ancak eşleştirme değişikliği kapsamlarını veya operator.admin yetkisini vermez.
Düzeltme:
  • En hızlı yol: openclaw dashboard (pano URL’sini yazdırır ve kopyalar, açmayı dener; grafik arabirimsizse bir SSH ipucu gösterir).
  • Henüz token yoksa: openclaw doctor --generate-gateway-token.
  • Uzak bağlantıda: önce ssh -N -L 18789:127.0.0.1:18789 user@host ile tünel oluşturun, ardından http://127.0.0.1:18789/ adresini açın.
  • Paylaşılan gizli anahtar modunda: gateway.auth.token / OPENCLAW_GATEWAY_TOKEN veya gateway.auth.password / OPENCLAW_GATEWAY_PASSWORD değerlerini ayarlayın, ardından eşleşen gizli anahtarı Control UI ayarlarına yapıştırın.
  • Tailscale Serve modunda: gateway.auth.allowTailscale özelliğinin etkin olduğunu ve Tailscale kimlik üstbilgilerini atlayan ham bir geri döngü/tailnet URL’si yerine Serve URL’sini açtığınızı doğrulayın.
  • Güvenilen proxy modunda: yapılandırılmış kimlik farkındalığına sahip proxy üzerinden geldiğinizi doğrulayın. Aynı ana makinedeki geri döngü proxy’leri de gateway.auth.trustedProxy.allowLoopback = true gerektirir.
  • Tek yeniden denemeden sonra uyuşmazlık sürerse eşleştirilmiş cihaz token’ını döndürün/yeniden onaylayın:
  • Döndürme reddedilirse: eşleştirilmiş cihaz oturumları, operator.admin yetkisine de sahip olmadıkça yalnızca kendi cihazlarını döndürebilir ve açık --scope değerleri çağıranın mevcut operatör kapsamlarını aşamaz.
  • Hâlâ çözülemediyse: openclaw status --all ve Sorun Giderme. Kimlik doğrulama ayrıntıları için Pano sayfasına bakın.
tailnet bağlaması, ağ arabirimlerinizden bir Tailscale IP’si seçer (100.64.0.0/10). Makine Tailscale üzerinde değilse (veya arabirim kapalıysa) Gateway, başka bir ağ arabirimini dışarı açmak yerine geri döngüye döner.Düzeltme: bu ana makinede Tailscale’i başlatıp Gateway’i yeniden başlatın veya açıkça gateway.bind: "loopback" / "lan" seçeneğine geçin.tailnet açıktır; auto geri döngüyü tercih eder. Gerekli aynı ana makine 127.0.0.1 dinleyicisini korurken geri döngü dışı erişimi Tailnet ile sınırlamak için gateway.bind: "tailnet" kullanın.
Genellikle hayır; tek bir Gateway birden fazla mesajlaşma kanalını ve ajanı çalıştırabilir. Birden fazla Gateway’i yalnızca yedeklilik (örneğin bir kurtarma botu) veya katı yalıtım için kullanın ve her birini kendi OPENCLAW_CONFIG_PATH, OPENCLAW_STATE_DIR, agents.defaults.workspace ve benzersiz gateway.port değeriyle yalıtın.Önerilen: örnek başına openclaw --profile <name> ... (otomatik olarak ~/.openclaw-<name> oluşturur), profil yapılandırması başına benzersiz bir gateway.port (veya elle çalıştırmalar için --port) ve openclaw --profile <name> gateway install ile profil başına bir hizmet.Profiller ayrıca hizmet adlarına son ek ekler: launchd ai.openclaw.<profile>, systemd openclaw-gateway-<profile>.service, Windows OpenClaw Gateway (<profile>). Niteliksiz openclaw-gateway systemd birimi yalnızca varsayılan profil için bulunur; yeniden adlandırma öncesindeki eski systemd birim adı clawdbot-gateway otomatik olarak taşınır.Tam kılavuz: Birden fazla Gateway.
Gateway bir WebSocket sunucusudur ve ilk mesajın bir connect çerçevesi olmasını bekler. Bunun dışındaki her şey bağlantıyı kod 1008 (ilke ihlali) ile kapatır.Yaygın nedenler: bir WS istemcisi yerine tarayıcıda HTTP URL’sini açmanız, yanlış bağlantı noktasını/yolu kullanmanız veya bir proxy/tünelin kimlik doğrulama üstbilgilerini kaldırması ya da Gateway dışı bir istek göndermesi.Düzeltme: WS URL’sini (ws://<host>:18789 veya HTTPS üzerinden wss://...) kullanın, WS bağlantı noktasını normal bir tarayıcı sekmesinde açmayın ve kimlik doğrulama açıkken token’ı/parolayı connect çerçevesine ekleyin. CLI/TUI örneği:
Protokol ayrıntıları: Gateway protokolü.

​
Günlük kaydı ve hata ayıklama

Dosya günlükleri (yapılandırılmış): varsayılan profil için /tmp/openclaw/openclaw-YYYY-MM-DD.log veya adlandırılmış bir profil için /tmp/openclaw/openclaw-<profile>-YYYY-MM-DD.log. logging.file ile kararlı bir yol; logging.level ile dosya günlük düzeyi; --verbose ve logging.consoleLevel ile konsol ayrıntı düzeyi ayarlayın.En hızlı canlı izleme:
Hizmet/gözetmen günlükleri (Gateway launchd/systemd aracılığıyla çalıştığında):
  • macOS launchd standart çıktısı: ~/Library/Logs/openclaw/gateway.log (profiller gateway-<profile>.log kullanır; standart hata çıktısı bastırılır).
  • Linux: journalctl --user -u openclaw-gateway[-<profile>].service -n 200 --no-pager.
  • Windows: schtasks /Query /TN "OpenClaw Gateway (<profile>)" /V /FO LIST.
Daha fazla bilgi için Sorun Giderme sayfasına bakın.
Gateway’i elle çalıştırıyorsanız openclaw gateway --force bağlantı noktasını geri alabilir. Bkz. Gateway.
Üç Windows kurulum modu:1) Windows Hub yerel kurulumu: yerel uygulama, uygulamanın sahip olduğu yerel bir WSL Gateway’i yönetir. Başlat menüsünden veya sistem tepsisinden OpenClaw Companion uygulamasını açın, ardından Gateway Setup seçeneğini veya Connections sekmesini kullanın.2) Elle kurulan WSL2 Gateway: Gateway Linux içinde çalışır.
Hizmeti hiç kurmadıysanız ön planda başlatın: openclaw gateway run.3) Yerel Windows CLI/Gateway: doğrudan Windows’ta çalışır.
Elle çalıştırıyorsanız (hizmet yoksa): openclaw gateway run.Belgeler: Windows, Gateway hizmeti operasyon kılavuzu.
Hızlı sistem durumu taraması:
Yaygın nedenler: model kimlik doğrulamasının Gateway ana makinesinde yüklenmemesi (models status değerini kontrol edin), kanal eşleştirmesinin/izin listesinin yanıtları engellemesi (kanal yapılandırmasını ve günlükleri kontrol edin) veya WebChat/Pano’nun doğru token olmadan açık olması. Uzak bağlantı kullanıyorsanız tünel/Tailscale bağlantısının etkin olduğunu ve Gateway WebSocket’ine erişilebildiğini doğrulayın.Docs: Kanallar, Sorun giderme, Uzaktan erişim.
Genellikle kullanıcı arayüzünün WebSocket bağlantısını kaybettiği anlamına gelir. Şunları kontrol edin: Gateway çalışıyor mu (openclaw gateway status)? Sağlıklı mı (openclaw status)? Kullanıcı arayüzünde doğru token var mı (openclaw dashboard)? Uzaktaysa tünel/Tailscale bağlantısı etkin mi?Ardından günlükleri takip edin:
Docs: Pano, Uzaktan erişim, Sorun giderme.
Ardından hatayı eşleştirin:
  • BOT_COMMANDS_TOO_MUCH: Telegram menüsünde çok fazla giriş var. OpenClaw zaten Telegram sınırına göre kırpar ve daha az komutla yeniden dener, ancak bazı menü girişleri yine de çıkarılabilir. Plugin/skill/özel komutları azaltın veya menüye ihtiyacınız yoksa channels.telegram.commands.native seçeneğini devre dışı bırakın.
  • TypeError: fetch failed, Network request for 'setMyCommands' failed! veya benzer ağ hataları: Bir VPS’de veya proxy arkasındaysanız giden HTTPS bağlantılarına izin verildiğini ve DNS’in api.telegram.org için çalıştığını doğrulayın.
Gateway uzaktaysa Gateway ana makinesindeki günlükleri kontrol edin.Docs: Telegram, Kanal sorunlarını giderme.
Geçerli durumu görmek için TUI’da /status kullanın. Bir sohbet kanalında yanıt bekliyorsanız iletimin etkinleştirildiğini doğrulayın (/deliver on).Docs: TUI, Eğik çizgi komutları.
Hizmeti yüklediyseniz (macOS’ta launchd, Linux’ta systemd):
Ön planda Ctrl-C ile durdurun, ardından openclaw gateway run.Docs: Gateway hizmeti çalışma kılavuzu.
openclaw gateway restart, arka plan hizmetini (launchd/systemd) yeniden başlatır. openclaw gateway, bu terminal oturumu için gateway’i ön planda çalıştırır. Hizmeti yüklediyseniz gateway alt komutlarını, tek seferlik kullanım için doğrudan ön plan çalıştırmasını kullanın.
Daha fazla konsol ayrıntısı için Gateway’i --verbose ile başlatın, ardından kanal kimlik doğrulaması, model yönlendirmesi ve RPC hataları için günlük dosyasını inceleyin.

​
Medya ve ekler

Agent’tan giden ekler media, mediaUrl, path veya filePath gibi yapılandırılmış medya alanlarını kullanmalıdır. Bkz. OpenClaw asistan kurulumu ve Agent gönderimi.
Ayrıca şunları kontrol edin: Hedef kanal giden medyayı destekliyor ve izin listeleri tarafından engellenmiyor; dosya, sağlayıcının boyut sınırları içinde (görüntüler en fazla 2048px kenar uzunluğuna yeniden boyutlandırılır); tools.fs.workspaceOnly=true, yerel yol üzerinden gönderimleri çalışma alanı, geçici/medya deposu ve sandbox tarafından doğrulanmış dosyalarla sınırlar; tools.fs.workspaceOnly=false (varsayılan), yapılandırılmış yerel medya gönderimlerinin agent’ın zaten okuyabildiği ana makineye ait yerel dosyaları medya ve güvenli belge türleri (görüntüler, ses, video, PDF, Office belgeleri ve Markdown/MD, TXT, JSON, YAML/YML gibi doğrulanmış metin belgeleri) için kullanmasına izin verir. Bu bir gizli bilgi tarayıcısı değildir; uzantı ve içerik doğrulaması eşleştiğinde agent tarafından okunabilen bir secret.txt veya config.json eklenebilir. Hassas dosyaları agent tarafından okunabilen yolların dışında tutun veya daha katı yerel yol gönderimleri için tools.fs.workspaceOnly=true ayarını koruyun.Bkz. Görüntüler.

​
Güvenlik ve erişim denetimi

Gelen DM’leri güvenilmeyen girdi olarak değerlendirin. Varsayılanlar riski azaltır:
  • DM destekleyen kanallardaki varsayılan davranış eşleştirmedir: bilinmeyen gönderenler bir eşleştirme kodu alır ve mesajları işlenmez. openclaw pairing approve --channel <channel> [--account <id>] <code> ile onaylayın. Bekleyen istekler kanal başına 3 ile sınırlıdır; kod ulaşmadıysa openclaw pairing list --channel <channel> [--account <id>] değerini kontrol edin.
  • DM’leri herkese açmak açıkça etkinleştirme (dmPolicy: "open" ve izin listesi "*") gerektirir.
Riskli DM politikalarını ortaya çıkarmak için openclaw doctor çalıştırın.
Hayır. Prompt enjeksiyonu, yalnızca bota kimin DM gönderebildiğiyle değil, güvenilmeyen içerikle ilgilidir. Asistanınız harici içerik (web araması/getirme, tarayıcı sayfaları, e-postalar, belgeler, ekler, yapıştırılmış günlükler) okuyorsa bu içerik, tek gönderen siz olsanız bile modeli ele geçirmeye çalışan talimatlar taşıyabilir.En büyük risk, araçlar etkinleştirildiğinde ortaya çıkar: model, bağlamı dışarı sızdırması veya sizin adınıza araçları çağırması için kandırılabilir. Etki alanını daraltın:
  • güvenilmeyen içeriği özetlemek için salt okunur veya araçları devre dışı bırakılmış bir “okuyucu” agent kullanın
  • araçların etkin olduğu agent’lar için web_search / web_fetch / browser özelliklerini kapalı tutun
  • kodu çözülmüş dosya/belge metnini de güvenilmeyen olarak değerlendirin: OpenResponses input_file ve medya eki çıkarma işlemi, ham dosya metnini iletmek yerine çıkarılan metni açık harici içerik sınırı işaretçileriyle sarmalar
  • sandbox kullanın ve katı araç izin listeleri uygulayın
Ayrıntılar: Güvenlik.
Dil ve çalışma zamanı önemlidir ancak kişisel bir agent için ana risk değildir. Pratik riskler; gateway’in dışarıya açılması, bota kimlerin mesaj gönderebildiği, prompt enjeksiyonu, araç kapsamı, kimlik bilgilerinin işlenmesi, tarayıcı erişimi, yürütme erişimi ve üçüncü taraf skill/Plugin güvenidir.Rust ve WASM, bazı kod sınıfları için daha güçlü yalıtım sağlayabilir ancak prompt enjeksiyonunu, hatalı izin listelerini, herkese açık gateway erişimini, aşırı geniş kapsamlı araçları veya hassas hesaplarda zaten oturum açmış bir tarayıcı profilini çözmez. Bunları birincil denetimler olarak değerlendirin: Gateway’i özel veya kimlik doğrulamalı tutun, DM’ler/gruplar için eşleştirme ve izin listeleri kullanın, güvenilmeyen girdiler için riskli araçları reddedin veya sandbox’a alın, yalnızca güvenilir Plugin’leri ve skill’leri yükleyin ve yapılandırma değişikliklerinden sonra openclaw security audit --deep çalıştırın.Ayrıntılar: Güvenlik, Sandbox kullanımı.
Daha güvenli bir temel: loopback adresine bağlanmış veya yalnızca kimliği doğrulanmış özel erişim (tailnet, SSH tüneli, token/parola kimlik doğrulaması ya da doğru yapılandırılmış güvenilir bir proxy) üzerinden dışarıya açılmış Gateway; pairing veya allowlist modundaki DM’ler; her üye güvenilir olmadığı sürece izin listesine alınmış ve bahsetme koşuluna bağlanmış gruplar; güvenilmeyen içerik okuyan agent’lar için reddedilmiş veya sıkı kapsamlandırılmış yüksek riskli araçlar (exec, browser, gateway, cron); araç yürütme işleminin daha dar bir etki alanına ihtiyaç duyduğu yerlerde etkinleştirilmiş sandbox kullanımı.Kimlik doğrulaması olmayan herkese açık bağlantılar, araçlarla birlikte açık DM’ler/gruplar ve dışarıya açık tarayıcı denetimi önce düzeltilmesi gereken bulgulardır. Ayrıntılar: openclaw security audit.
Üçüncü taraf skill’leri ve Plugin’leri, güvenmeyi seçtiğiniz kodlar olarak değerlendirin. ClawHub skill sayfaları yüklemeden önce tarama durumunu gösterir ancak taramalar eksiksiz bir güvenlik sınırı değildir. OpenClaw, Plugin/skill yükleme veya güncelleme sırasında yerleşik yerel tehlikeli kod engellemesi çalıştırmaz; yerel izin verme/engelleme kararları için operatörün yönettiği security.installPolicy kullanın.Daha güvenli yaklaşım: güvenilir yazarları ve sabitlenmiş sürümleri tercih edin, etkinleştirmeden önce skill’i/Plugin’i okuyun, Plugin/skill izin listelerini dar tutun, güvenilmeyen girdi iş akışlarını en az sayıda araçla sandbox içinde çalıştırın ve üçüncü taraf kodlarına geniş dosya sistemi, yürütme, tarayıcı veya gizli bilgi erişimi vermekten kaçının.Ayrıntılar: Skills, Plugin’ler, Güvenlik.
Çoğu kurulum için evet. Botu ayrı hesaplar ve telefon numaralarıyla yalıtmak, bir sorun çıkması durumunda etki alanını daraltır ve kişisel hesaplarınızı etkilemeden kimlik bilgilerini yenilemeyi veya erişimi iptal etmeyi kolaylaştırır.Küçük başlayın: yalnızca gerçekten ihtiyaç duyduğunuz araçlara ve hesaplara erişim verin, gerekirse daha sonra genişletin.Docs: Güvenlik, Eşleştirme.
Kişisel mesajlarınız üzerinde tam özerklik vermenizi önermiyoruz. En güvenli yaklaşım: DM’leri eşleştirme modunda veya dar bir izin listesinde tutun, sizin adınıza mesaj göndermesi gerekiyorsa ayrı bir numara veya hesap kullanın ve göndermeden önce sizin onaylayacağınız taslaklar hazırlamasına izin verin.Denemek için bunu ayrılmış, yalıtılmış bir hesapta yapın. Bkz. Güvenlik.
Evet, agent yalnızca sohbet amaçlıysa ve girdi güvenilir ise. Daha küçük katmanlar talimatlarla ele geçirilmeye daha yatkındır; bu nedenle araçların etkin olduğu agent’larda veya güvenilmeyen içerik okunurken bunlardan kaçının. Daha küçük bir model kullanmanız gerekiyorsa araçları sıkı biçimde sınırlandırın ve sandbox içinde çalıştırın. Bkz. Güvenlik.
Eşleştirme kodları yalnızca bilinmeyen bir gönderen bota mesaj gönderdiğinde ve dmPolicy: "pairing" etkin olduğunda gönderilir; /start tek başına kod oluşturmaz.Bekleyen istekleri kontrol edin:
Anında erişim için gönderen kimliğinizi izin listesine alın veya bu hesap için dmPolicy: "open" ayarlayın.
Hayır. Varsayılan WhatsApp DM politikası eşleştirmedir. Bilinmeyen gönderenler yalnızca bir eşleştirme kodu alır; mesajları işlenmez. OpenClaw yalnızca aldığı sohbetlere veya açıkça tetiklediğiniz gönderimlere yanıt verir.
Sihirbazın telefon numarası istemi, kendi DM’lerinize izin verilmesi için izin listenizi/sahibinizi ayarlar; otomatik gönderim için kullanılmaz. Kişisel WhatsApp numaranızda bu numarayı kullanın ve channels.whatsapp.selfChatMode seçeneğini etkinleştirin.

​
Sohbet komutları, görevleri iptal etme ve “durmuyor”

Çoğu dahili/araç mesajı yalnızca o oturum için ayrıntılı, izleme veya akıl yürütme etkinleştirildiğinde görünür.Gördüğünüz sohbette düzeltin:
Hâlâ çok fazla mesaj varsa: Control UI’daki oturum ayarlarını kontrol edin ve ayrıntılı seçeneğini devral olarak ayarlayın; yapılandırmada verboseDefault: "on" bulunan bir bot profili kullanmadığınızı doğrulayın.Docs: Düşünme ve ayrıntılı çıktı, Güvenlik.
İptali tetiklemek için bunlardan herhangi birini tek başına bir mesaj olarak (eğik çizgi olmadan) gönderin: stop, stop action, stop current action, stop run, stop current run, stop agent, stop the agent, stop openclaw, openclaw stop, stop don't do anything, stop do not do anything, stop doing anything, do not do that, please stop, stop please, abort, esc, exit, interrupt, halt. Yaygın İngilizce dışı tetikleyiciler (Fransızca, Almanca, İspanyolca, Çince, Japonca, Hintçe, Arapça, Rusça) de çalışır.exec aracı tarafından başlatılan arka plan işlemleri için agent’tan şunu çalıştırmasını isteyin:
Çoğu eğik çizgi komutu, / ile başlayan tek başına bir mesaj olarak gönderilmelidir; ancak bazı kısayollar (/status gibi), izin listesindeki gönderenler için satır içinde de çalışır. Bkz. Eğik çizgi komutları.
OpenClaw, sağlayıcılar arası mesajlaşmayı varsayılan olarak engeller. Bir araç çağrısı Telegram’a bağlıysa, açıkça izin vermediğiniz sürece Discord’a gönderim yapmaz. Bu değişiklik hemen yürürlüğe girer ve Gateway’in yeniden başlatılması gerekmez:
Çalışma sırasında gönderilen istemler varsayılan olarak etkin çalışmaya yönlendirilir. Etkin çalışma davranışını seçmek için /queue kullanın:
  • steer (varsayılan) - etkin çalışmayı bir sonraki model sınırında yönlendirir.
  • followup - mesajları kuyruğa alır ve mevcut çalışma sona erdikten sonra bunları teker teker çalıştırır.
  • collect - uyumlu mesajları kuyruğa alır ve mevcut çalışma sona erdikten sonra tek seferde yanıt verir.
  • interrupt - mevcut çalışmayı iptal eder ve baştan başlar.
Kuyruklu modlara debounce:0.5s cap:25 drop:summarize gibi seçenekler ekleyin. Bkz. Komut kuyruğu ve Yönlendirme kuyruğu.

​
Çeşitli

Kimlik bilgileri ve model seçimi birbirinden ayrıdır. ANTHROPIC_API_KEY ayarını yapmak (veya kimlik doğrulama profillerinde bir Anthropic API anahtarı saklamak) kimlik doğrulamayı etkinleştirir; ancak gerçek varsayılan model, agents.defaults.model.primary içinde yapılandırdığınız modeldir (örneğin anthropic/claude-sonnet-4-6 veya anthropic/claude-opus-4-6). No credentials found for profile "anthropic:default", Gateway’in çalışan agent için beklenen auth-profiles.json içinde Anthropic kimlik bilgilerini bulamadığı anlamına gelir.
Hâlâ çözemediniz mi? Discord içinde sorun veya bir GitHub tartışması açın.

​
İlgili