OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Fundamentals

Ajan çalışma alanı

Çalışma alanı aracının evidir: dosya araçları ve çalışma alanı bağlamı için kullanılan çalışma dizinidir. Bunu gizli tutun ve bellek olarak değerlendirin.

Bu, yapılandırmayı, kimlik bilgilerini ve oturumları depolayan ~/.openclaw/ konumundan ayrıdır.

Varsayılan konum

  • Varsayılan: ~/.openclaw/workspace
  • OPENCLAW_PROFILE ayarlanmışsa ve "default" değilse varsayılan, ~/.openclaw/workspace-<profile> olur.
  • OPENCLAW_WORKSPACE_DIR ayarlandığında yukarıdakilerin ikisini de geçersiz kılar.
  • Açıkça belirtilmiş bir çalışma alanı olmayan varsayılan dışı aracılar (agents.entries.*), paylaşılan varsayılan çalışma alanına değil, <state-dir>/workspace-<agentId> konumuna çözümlenir.

~/.openclaw/openclaw.json içinde geçersiz kılın:

json5
{  agents: {    defaults: {      workspace: "~/.openclaw/workspace",    },  },}

Aracı başına geçersiz kılma: agents.entries.*.workspace.

openclaw onboard, openclaw configure veya openclaw setup, çalışma alanını oluşturur ve eksiklerse başlangıç dosyalarını yerleştirir.

Çalışma alanı dosyalarını zaten kendiniz yönetiyorsanız başlangıç dosyası oluşturmayı devre dışı bırakın:

json5
{ agents: { defaults: { skipBootstrap: true } } }

Ek çalışma alanı klasörleri

Eski kurulumlar ~/openclaw oluşturmuş olabilir. Aynı anda yalnızca bir çalışma alanı etkin olduğundan, birden fazla çalışma alanı dizinini tutmak kafa karıştırıcı kimlik doğrulama veya durum sapmalarına neden olabilir.

Çalışma alanı dosya haritası

OpenClaw'ın çalışma alanında bulunmasını beklediği standart dosyalar:

AGENTS.md - çalışma talimatları

Aracıya ve belleği nasıl kullanması gerektiğine ilişkin çalışma talimatları. Her oturumun başında yüklenir. Kurallar, öncelikler ve "nasıl davranılacağına" ilişkin ayrıntılar için uygun bir yerdir.

SOUL.md - kişilik ve üslup

Kişilik, üslup ve sınırlar. Her oturumda yüklenir. Kılavuz: SOUL.md kişilik kılavuzu.

USER.md - kullanıcının kim olduğu

Kullanıcının kim olduğu ve kendisine nasıl hitap edileceği. Her oturumda yüklenir.

IDENTITY.md - ad, hava, emoji

Aracının adı, havası ve emojisi. Başlangıç ritüeli sırasında oluşturulur/güncellenir.

TOOLS.md - yerel araç kuralları

Yerel araçlarınız ve kurallarınız hakkındaki notlar. Araçların kullanılabilirliğini kontrol etmez; yalnızca yol gösterir.

HEARTBEAT.md - heartbeat kontrol listesi

Heartbeat çalıştırmaları için isteğe bağlı küçük kontrol listesi. Token tüketimini önlemek için kısa tutun.

BOOT.md - başlatma kontrol listesi

Gateway yeniden başlatıldığında (dahili hook'lar etkinse) otomatik olarak çalıştırılan isteğe bağlı başlatma kontrol listesi. Kısa tutun; dışarıya gönderimler için mesaj aracını kullanın.

BOOTSTRAP.md - ilk çalıştırma ritüeli

Bir defalık ilk çalıştırma ritüeli. Yalnızca yepyeni bir çalışma alanı için oluşturulur. Ritüel tamamlandıktan sonra silin.

memory/YYYY-MM-DD.md - günlük bellek kaydı

Günlük bellek kaydı (günde bir dosya). Oturum başlangıcında bugünün ve dünün kayıtlarının okunması önerilir.

MEMORY.md - düzenlenmiş uzun vadeli bellek (isteğe bağlı)

Düzenlenmiş uzun vadeli bellek: kalıcı olgular, 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 eklemeden gerektiğinde getirebilir. MEMORY.md dosyasını yalnızca ana, özel oturumda yükleyin (paylaşılan/grup bağlamlarında değil). İş akışı ve otomatik bellek boşaltımı için Bellek bölümüne bakın.

skills/ - çalışma alanı Skills'ları (isteğe bağlı)

Çalışma alanına özgü Skills. Adlar çakıştığında proje aracı Skills'ları, kişisel aracı Skills'ları, yönetilen Skills, paketlenmiş Skills ve skills.load.extraDirs konumundan önce gelen, o çalışma alanı için en yüksek öncelikli Skill konumudur.

canvas/ - Canvas kullanıcı arayüzü dosyaları (isteğe bağlı)

Node gösterimleri için Canvas kullanıcı arayüzü dosyaları (örneğin canvas/index.html).

Çalışma alanında OLMAYANLAR

Bunlar ~/.openclaw/ altında bulunur ve çalışma alanı deposuna kaydedilmemelidir:

  • ~/.openclaw/openclaw.json (yapılandırma)
  • ~/.openclaw/state/openclaw.sqlite (paylaşılan çalışma alanı kurulum durumu ve tasdikler)
  • ~/.openclaw/agents/<agentId>/agent/auth-profiles.json (model kimlik doğrulama profilleri: OAuth + API anahtarları)
  • ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite (oturum satırları, transkriptler ve aracı başına çalışma zamanı durumu)
  • ~/.openclaw/agents/<agentId>/agent/codex-home/ (aracı başına Codex çalışma zamanı hesabı, yapılandırması, Skills'ları, Plugin'leri ve yerel iş parçacığı durumu)
  • ~/.openclaw/credentials/ (kanal/sağlayıcı durumu ve eski OAuth içe aktarma verileri)
  • ~/.openclaw/agents/<agentId>/sessions/ (eski taşıma kaynakları ve arşiv/destek yapıtları)
  • ~/.openclaw/skills/ (yönetilen Skills)

Oturumları veya yapılandırmayı taşımanız gerekiyorsa bunları ayrı olarak kopyalayın ve sürüm denetiminin dışında tutun.

Eski OpenClaw sürümleri, çalışma alanı yan dosyaları olan openclaw-workspace-state.json, .openclaw/workspace-state.json ve .attested dosyalarını yazıyordu. Geçerli çalışma zamanı bu durum için yalnızca paylaşılan SQLite veritabanını kullanır. Doctor bu dosyalardan birini bildirirse openclaw doctor --fix komutunu çalıştırın; Doctor, geçerli eski durumu içe aktarır ve bir kaynağı yalnızca veritabanı satırlarını doğruladıktan sonra siler.

Git yedeklemesi (önerilir, özel)

Çalışma alanını özel bellek olarak değerlendirin. Yedeklenebilmesi ve kurtarılabilmesi için özel bir git deposuna koyun.

Bu adımları Gateway'in çalıştığı makinede çalıştırın (çalışma alanı burada bulunur).

  • Depoyu başlatın

    Git yüklüyse yepyeni çalışma alanları otomatik olarak başlatılır. Bu çalışma alanı henüz bir depo değilse şunu çalıştırın:

    bash
    cd ~/.openclaw/workspacegit initgit add AGENTS.md SOUL.md TOOLS.md IDENTITY.md USER.md HEARTBEAT.md memory/git commit -m "Add agent workspace"

  • Özel bir uzak depo ekleyin

    GitHub web UI

    1. GitHub'da yeni bir özel depo oluşturun.
    2. Bir README ile başlatmayın (birleştirme çakışmalarını önler).
    3. HTTPS uzak depo URL'sini kopyalayın.
    4. Uzak depoyu ekleyip gönderin:
    bash
    git branch -M maingit remote add origin <https-url>git push -u origin main

    GitHub CLI (gh)

    bash
    gh auth logingh repo create openclaw-workspace --private --source . --remote origin --push

    GitLab web UI

    1. GitLab'da yeni bir özel depo oluşturun.
    2. Bir README ile başlatmayın (birleştirme çakışmalarını önler).
    3. HTTPS uzak depo URL'sini kopyalayın.
    4. Uzak depoyu ekleyip gönderin:
    bash
    git branch -M maingit remote add origin <https-url>git push -u origin main

  • Süregelen güncellemeler

    bash
    git statusgit add .git commit -m "Update memory"git push

    • Gizli bilgileri kaydetmeyin

    Önerilen .gitignore başlangıç içeriği:

    gitignore
    .DS_Store.env**/*.key**/*.pem**/secrets*

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

  • Depoyu klonlayın

    Depoyu istediğiniz yola klonlayın (varsayılan ~/.openclaw/workspace).

  • Yapılandırmayı güncelleyin

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

  • Eksik dosyaları yerleştirin

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

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

    Oturumlara ihtiyacınız varsa ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite konumunu eski makineden ayrı olarak kopyalayın. ~/.openclaw/agents/<agentId>/sessions/ konumunu yalnızca eski taşıma girdilerine veya arşiv/destek yapıtlarına da ihtiyacınız olduğunda kopyalayın.

    • Gelişmiş notlar

    • Çok aracılı yönlendirme, agents.entries.*.workspace aracılığıyla aracı başına farklı çalışma alanları kullanabilir. Yönlendirme yapılandırması için Kanal yönlendirme bölümüne bakın.
    • agents.defaults.sandbox etkinse ana olmayan oturumlar, agents.defaults.sandbox.workspaceRoot altındaki oturum başına korumalı alan çalışma alanlarını kullanabilir.

    İlgili konular

    Was this useful?
    On this page

    On this page