Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Çalışma alanı, ajanın evidir. Dosya araçları ve çalışma alanı bağlamı için kullanılan tek çalışma dizinidir. Gizli tutun ve bellek olarak ele alın. Bu, yapılandırma, kimlik bilgileri ve oturumları saklayan ~/.openclaw/ dizininden ayrıdır.
Çalışma alanı varsayılan cwd’dir, katı bir sandbox değildir. Araçlar göreli yolları çalışma alanına göre çözümler, ancak sandboxlama etkin değilse mutlak yollar ana makinede başka yerlere hâlâ erişebilir. İzolasyona ihtiyacınız varsa agents.defaults.sandbox (ve/veya ajan başına sandbox yapılandırması) kullanın.Sandboxlama etkin olduğunda ve workspaceAccess "rw" değilse, araçlar ana makine çalışma alanınızda değil, ~/.openclaw/sandboxes altındaki bir sandbox çalışma alanı içinde çalışır.

​
Varsayılan konum

  • Varsayılan: ~/.openclaw/workspace
  • OPENCLAW_PROFILE ayarlanmışsa ve "default" değilse, varsayılan ~/.openclaw/workspace-<profile> olur.
  • ~/.openclaw/openclaw.json içinde geçersiz kılın:
{
  agents: {
    defaults: {
      workspace: "~/.openclaw/workspace",
    },
  },
}
openclaw onboard, openclaw configure veya openclaw setup, çalışma alanını oluşturur ve eksiklerse önyükleme dosyalarını yerleştirir.
Sandbox başlangıç kopyaları yalnızca çalışma alanı içindeki normal dosyaları kabul eder; kaynak çalışma alanının dışına çözümlenen symlink/hardlink takma adları yok sayılır.
Çalışma alanı dosyalarını zaten kendiniz yönetiyorsanız, önyükleme dosyası oluşturmayı devre dışı bırakabilirsiniz: 
{ agents: { defaults: { skipBootstrap: true } } }

​
Ek çalışma alanı klasörleri

Eski kurulumlar ~/openclaw oluşturmuş olabilir. Etrafta birden fazla çalışma alanı dizini tutmak, kafa karıştırıcı kimlik doğrulama veya durum kaymasına neden olabilir; çünkü aynı anda yalnızca bir çalışma alanı aktiftir.
Öneri: Tek bir etkin çalışma alanı tutun. Ek klasörleri artık kullanmıyorsanız arşivleyin veya Çöp Kutusu’na taşıyın (örneğin trash ~/openclaw). Bilerek birden fazla çalışma alanı tutuyorsanız, agents.defaults.workspace değerinin etkin olanı gösterdiğinden emin olun.openclaw doctor, ek çalışma alanı dizinleri algıladığında uyarır.

​
Çalışma alanı dosya haritası

Bunlar, OpenClaw’ın çalışma alanı içinde beklediği standart dosyalardır:
Ajan için işletim talimatları ve belleği nasıl kullanması gerektiği. Her oturumun başlangıcında yüklenir. Kurallar, öncelikler ve “nasıl davranılacağı” ayrıntıları için iyi bir yerdir.
Kişilik, ton ve sınırlar. Her oturumda yüklenir. Kılavuz: SOUL.md kişilik kılavuzu.
Kullanıcının kim olduğu ve ona nasıl hitap edileceği. Her oturumda yüklenir.
Ajanın adı, havası ve emojisi. Önyükleme ritüeli sırasında oluşturulur/güncellenir.
Yerel araçlarınız ve kurallarınız hakkında notlar. Araç kullanılabilirliğini denetlemez; yalnızca rehberliktir.
Heartbeat çalıştırmaları için isteğe bağlı küçük kontrol listesi. Token tüketimini önlemek için kısa tutun.
Gateway yeniden başlatıldığında otomatik olarak çalıştırılan isteğe bağlı başlangıç kontrol listesi (dahili hook’lar etkin olduğunda). Kısa tutun; dışa gönderimler için mesaj aracını kullanın.
Tek seferlik ilk çalıştırma ritüeli. Yalnızca yepyeni bir çalışma alanı için oluşturulur. Ritüel tamamlandıktan sonra silin.
Günlük bellek kaydı (günde bir dosya). Oturum başlangıcında bugün + dün okunması önerilir.
Düzenlenmiş uzun vadeli bellek: kalıcı gerçekler, tercihler, kararlar ve kısa özetler. Ayrıntılı kayıtları memory/YYYY-MM-DD.md içinde tutun; böylece bellek araçları bunları her isteme enjekte etmeden ihtiyaç halinde alabilir. MEMORY.md dosyasını yalnızca ana, özel oturumda yükleyin (paylaşılan/grup bağlamlarında değil). İş akışı ve otomatik bellek boşaltma için bkz. Bellek.
Çalışma alanına özel Skills. O çalışma alanı için en yüksek öncelikli Skills konumu. Adlar çakıştığında proje ajan Skills’lerini, kişisel ajan Skills’lerini, yönetilen Skills’leri, paketlenmiş Skills’leri ve skills.load.extraDirs değerini geçersiz kılar.
Düğüm görüntüleri için Canvas UI dosyaları (örneğin canvas/index.html).
Herhangi bir önyükleme dosyası eksikse, OpenClaw oturuma bir “eksik dosya” işareti enjekte eder ve devam eder. Büyük önyükleme dosyaları enjekte edilirken kısaltılır; sınırları agents.defaults.bootstrapMaxChars (varsayılan: 12000) ve agents.defaults.bootstrapTotalMaxChars (varsayılan: 60000) ile ayarlayın. openclaw setup, mevcut dosyaların üzerine yazmadan eksik varsayılanları yeniden oluşturabilir.

​
Çalışma alanında OLMAYANLAR

Bunlar ~/.openclaw/ altında bulunur ve çalışma alanı reposuna commit EDİLMEMELİDİR:
  • ~/.openclaw/openclaw.json (yapılandırma)
  • ~/.openclaw/agents/<agentId>/agent/auth-profiles.json (model kimlik doğrulama profilleri: OAuth + API anahtarları)
  • ~/.openclaw/agents/<agentId>/agent/codex-home/ (ajan başına Codex çalışma zamanı hesabı, yapılandırma, Skills, Plugin’ler ve yerel iş parçacığı durumu)
  • ~/.openclaw/credentials/ (kanal/sağlayıcı durumu ve eski OAuth içe aktarma verileri)
  • ~/.openclaw/agents/<agentId>/sessions/ (oturum dökümleri + meta veriler)
  • ~/.openclaw/skills/ (yönetilen Skills)
Oturumları veya yapılandırmayı taşımanız gerekiyorsa, bunları ayrı olarak kopyalayın ve sürüm kontrolünün dışında tutun.

​
Git yedeklemesi (önerilir, özel)

Çalışma alanını özel bellek olarak ele alın. Yedeklenebilir ve kurtarılabilir olması için onu özel bir git reposuna koyun. Bu adımları Gateway’in çalıştığı makinede çalıştırın (çalışma alanının bulunduğu yer orasıdır).
1

Repoyu başlatın

Git kuruluysa, yepyeni çalışma alanları otomatik olarak başlatılır. Bu çalışma alanı zaten bir repo değilse şunu çalıştırın:
cd ~/.openclaw/workspace
git init
git add AGENTS.md SOUL.md TOOLS.md IDENTITY.md USER.md HEARTBEAT.md memory/
git commit -m "Add agent workspace"
2

Özel bir remote ekleyin

  1. GitHub’da yeni bir özel depo oluşturun.
  2. README ile başlatmayın (merge çakışmalarını önler).
  3. HTTPS remote URL’sini kopyalayın.
  4. Remote’u ekleyin ve push edin:
git branch -M main
git remote add origin <https-url>
git push -u origin main
3

Sürekli güncellemeler

git status
git add .
git commit -m "Update memory"
git push

​
Gizli bilgileri commit etmeyin

Özel bir repoda bile, gizli bilgileri çalışma alanında saklamaktan kaçının:
  • API anahtarları, OAuth token’ları, parolalar veya özel kimlik bilgileri.
  • ~/.openclaw/ altındaki herhangi bir şey.
  • Sohbetlerin veya hassas eklerin ham dökümleri.
Hassas referansları saklamanız gerekiyorsa, yer tutucular kullanın ve gerçek gizli bilgiyi başka bir yerde tutun (parola yöneticisi, ortam değişkenleri veya ~/.openclaw/).
Önerilen .gitignore başlangıcı: 
.DS_Store
.env
**/*.key
**/*.pem
**/secrets*

​
Çalışma alanını yeni bir makineye taşıma

1

Repoyu klonlayın

Repoyu istenen yola klonlayın (varsayılan ~/.openclaw/workspace).
2

Yapılandırmayı güncelleyin

~/.openclaw/openclaw.json içinde agents.defaults.workspace değerini bu yola ayarlayın.
3

Eksik dosyaları yerleştirin

Eksik dosyaları yerleştirmek için openclaw setup --workspace <path> çalıştırın.
4

Oturumları kopyalayın (isteğe bağlı)

Oturumlara ihtiyacınız varsa, eski makineden ~/.openclaw/agents/<agentId>/sessions/ dizinini ayrı olarak kopyalayın.

​
Gelişmiş notlar

  • Çok ajanlı yönlendirme, ajan başına farklı çalışma alanları kullanabilir. Yönlendirme yapılandırması için bkz. Kanal yönlendirme.
  • agents.defaults.sandbox etkinleştirilmişse, ana olmayan oturumlar agents.defaults.sandbox.workspaceRoot altında oturum başına sandbox çalışma alanları kullanabilir.

​
İlgili

  • Heartbeat - HEARTBEAT.md çalışma alanı dosyası
  • Sandboxlama - sandboxlanmış ortamlarda çalışma alanı erişimi
  • Oturum - oturum depolama yolları
  • Kalıcı talimatlar - çalışma alanı dosyalarındaki kalıcı talimatlar