English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Fundamentals

Ajan çalışma alanı

Çalışma alanı, ajanın evidir. Dosya araçları ve çalışma alanı bağlamı için kullanılan tek çalışma dizinidir. Onu özel tutun ve bellek gibi ele alın.

Bu, yapılandırma, kimlik bilgileri ve oturumları depolayan ~/.openclaw/ dizininden 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/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 eksikse başlangıç dosyalarını yerleştirir.

Çalışma alanı dosyalarını zaten kendiniz yönetiyorsanız, başlangıç 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, aynı anda yalnızca bir çalışma alanı etkin olduğu için kafa karıştırıcı kimlik doğrulama veya durum kaymasına neden olabilir.

Çalışma alanı dosya haritası

Bunlar OpenClaw'ın çalışma alanı içinde beklediği standart dosyalardır:

AGENTS.md - çalışma talimatları

Ajan için çalışma talimatları ve belleği nasıl kullanması gerektiği. Her oturumun başında yüklenir. Kurallar, öncelikler ve "nasıl davranmalı" ayrıntıları için iyi bir yerdir.

SOUL.md - kişilik ve ton

Kişilik, ton 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 ona nasıl hitap edileceği. Her oturumda yüklenir.

IDENTITY.md - ad, hava, emoji

Ajanı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ında notlar. Araç kullanılabilirliğini denetlemez; yalnızca rehberliktir.

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şlangıç kontrol listesi

Gateway yeniden başlatıldığında otomatik olarak çalıştırılan isteğe bağlı başlangıç kontrol listesi (internal hooks etkin olduğunda). Kısa tutun; dışa giden gönderimler için mesaj aracını kullanın.

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

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.

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ü + dünü okumanız önerilir.

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

Düzenlenmiş uzun süreli bellek. Yalnızca ana, özel oturumda yükleyin (paylaşılan/grup bağlamlarında değil). İş akışı ve otomatik bellek boşaltma için Bellek bölümüne bakın.

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

Çalışma alanına özgü Skills. Bu çalışma alanı için en yüksek öncelikli skill konumu. Adlar çakıştığında proje ajanı skills, kişisel ajan skills, yönetilen skills, paketli skills ve skills.load.extraDirs üzerine yazar.

canvas/ - Canvas UI dosyaları (isteğe bağlı)

Node görünümleri için Canvas UI dosyaları (örneğin canvas/index.html).

Çalışma alanında NELER YOKTUR

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, plugins ve yerel thread 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ı kopyalayın ve sürüm denetiminin dışında tutun.

Git yedeklemesi (önerilir, özel)

Çalışma alanını özel bellek gibi ele alın. Yedeklenmesi 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).

  • Repo'yu 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"

  • Özel bir remote ekleyin

    GitHub web UI

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

    GitHub CLI (gh)

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

    GitLab web UI

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

  • Sürekli güncellemeler

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

    • Gizli bilgileri commit etmeyin

    Önerilen .gitignore başlangıcı:

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

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

  • Repo'yu klonlayın

    Repo'yu istenen yola klonlayın (varsayılan ~/.openclaw/workspace).

  • Yapılandırmayı güncelleyin

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

  • Eksik dosyaları yerleştirin

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

  • 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 Kanal yönlendirme bölümüne bakın.
    • agents.defaults.sandbox etkinse, ana olmayan oturumlar agents.defaults.sandbox.workspaceRoot altında oturum başına sandbox çalışma alanları kullanabilir.

    İlgili