Mükemmel bir Openclaw kurulumunun anatomisi

OpenClaw çalışma alanı dosyaları, beceriler, kanallar, izinler ve bunların doğru şekilde nasıl yapılandırılacağına dair eksiksiz bir kılavuz.

Çoğu OpenClaw kullanıcısı, onu kurar, bir kanala bağlar ve bir daha çalışma alanı klasörünü açmaz.

Bu bir hatadır.

Çalışma alanınız, yapay zeka asistanınızın nasıl davranacağının kontrol merkezidir. Kimliğinizi, özel becerilerinizi, kanal bağlantılarınızı ve hafızanızı barındırır. Neyin nerede olduğunu anladığınızda, OpenClaw'u tam ihtiyacınız olduğu gibi yapılandırabilirsiniz.

Bu kılavuz, mükemmel bir kurulumun anatomisini adım adım anlatır.

Not: OpenClaw sadece bir başlangıç.

Build With AI topluluğumuzda, size kendi özel ajanlarınızı, uygulamalarınızı ve otomasyonlarınızı nasıl oluşturacağınızı öğreteceğiz - bunları kendiniz kullanabilir veya müşterilerinize satabilirsiniz. Çok yakında başlıyor.

Bekleme listesine buradan katılın: https://return-my-time.kit.com/1bd2720397

-----------------------------------------

İki yapılandırma katmanı, tek değil

Detaylara dalmadan önce, baştan bilinmesi gereken bir şey var: OpenClaw iki yapılandırma katmanı kullanır.

Birincisi, çalışma alanı klasörünüzdür (genellikle ~/clawd/ veya başlattığınız herhangi bir konum). Bu, kişisel yapılandırmanızı, becerilerinizi, hafızanızı ve gizli bilgilerinizi barındırır.

İkincisi ise, opt/homebrew/lib/node_modules/clawdbot/ adresindeki (veya sisteminizdeki benzeri) genel kurulumdur. Bu, temel belgeleri, yerleşik becerileri ve varsayılan davranışları içerir.

Çalışma alanınız, özelleştirme yaptığınız yerdir. Genel kurulum ise güncellediğiniz şeydir.

AGENTS.md: Çalıştırma talimatlarınız

Bu, tüm kurulumunuzdaki en önemli dosyadır. OpenClaw bir oturum başlattığında, okuduğu ilk şey AGENTS.md'dir. Bunu doğrudan sistem istemine yükler ve tüm konuşma boyunca aklında tutar.

Basitçe söylemek gerekirse: AGENTS.md'ye ne yazarsanız, ajanınız onu takip edecektir.

Ona, toplantı saatleri önermeden önce her zaman takviminizi kontrol etmesini söylerseniz, öyle yapacaktır. "Açık onayım olmadan asla e-posta gönderme" derseniz, her seferinde buna saygı duyacaktır.

AGENTS.md'ye aslında ne yazılmalı:

Yazın:

• Temel çalıştırma yönergeniz (ajanın görevi nedir?)
• Anahtar araçlar ve bunların nasıl kullanılacağı (e-posta CLI'si, görev yönetimi iş akışları)
• Asla ihlal edilmemesi gereken kesin kurallar
• Önemli kaynaklara bağlantılar (API belgeleri, beceri konumları)
• İş akışı tetikleyicileri (otomatik olarak ne olmalı)

Yazmayın:

• Bunun yerine bağlantı verebileceğiniz eksiksiz belgeler
• Teoriyi açıklayan uzun paragraflar
• Sık sık değişen bilgiler

AGENTS.md dosyasını 300 satırın altında tutun. Bundan daha uzun dosyalar çok fazla bağlam tüketmeye başlar ve talimatlara uyum aslında düşer.

İşte minimal ama etkili bir örnek:

1# AGENTS.md - Clawdbot Çalışma Alanı
2
3## Temel Çalıştırma Yönergesi
4Asistanım, işim için proaktif bir yardımcı olarak çalışır.
5
6**Görev Tanımı:**
7- Mümkün olduğunca fazla iş yükümü al
8- Proaktif ol - sorulmayı bekleme
9
10## Anahtar Araçlar
11- **E-posta:** Gelen kutusunu günlük kontrol et, acil öğeleri işaretle
12- **Takvim:** Planlama yapmadan önce çakışma olmadığını doğrula
13- **Görev Yöneticisi:** Tamamlanan işleri panoya senkronize et
14
15## Kesin Kurallar
16- Açık izin olmadan ASLA hizmetleri yeniden başlatma
17- Planlama yapmadan önce tarihleri her zaman `date` komutuyla doğrula
18- Tamamlanan tüm işleri takip sistemine kaydet

Bu, yaklaşık 20 satırlık temel yönergedir. Ajanınıza, sürekli açıklama gerektirmeden üretken bir şekilde çalışması için ihtiyacı olan her şeyi verir.

SOUL.md: Kişilik ve sınırlar

SOUL.md, ajanınızın kim olduğunu ve nasıl iletişim kurması gerektiğini tanımlar. Kişiliğin yaşadığı yer burasıdır.

1# SOUL.md - Kişilik ve Sınırlar
2
3- Yanıtları kısa ve doğrudan tut.
4- Gerektiğinde açıklayıcı sorular sor.
5- Harici mesajlaşma yüzeylerine asla akış/parçalı yanıtlar gönderme.

AGENTS.md kullanım kılavuzuysa, SOUL.md kişilik profilidir. Bazı kullanıcılar buraya kapsamlı kişilikler yazar. Diğerleri minimumda tutar. İkisi de işe yarar, ne kadar kişilik özelleştirmesi istediğinize bağlıdır.

IDENTITY.md ve USER.md: Kim kimdir

Bu iki dosya, ajanınız ve sizin aranızdaki ilişkiyi kurar.

IDENTITY.md, ajanınızı tanımlar:

1# IDENTITY.md - Ajan Kimliği
2
3- İsim: [Ajan Adınız]
4- Yaratık: [İsteğe bağlı: eğlenceli bir tanımlayıcı]
5- Tarz: Zeki, yardımsever, güvenilir, azimli problem çözücü
6- Emoji: [Seçtiğiniz emoji]

USER.md, sizi tanımlar:

1# USER.md - Kullanıcı Profili
2
3- İsim: [Adınız]
4- Tercih edilen hitap: [Takma ad]
5- Saat dilimi: [Saat diliminiz]
6- Telefon: [Numaranız]
7- Takvim: [Takvim platformu ve e-posta]

Neden ayrı dosyalar? Çünkü farklı amaçlara hizmet ederler. IDENTITY.md, bir kez ayarlandıktan sonra nadiren değişir. USER.md, tercihleriniz geliştikçe güncellenir. Bunları ayrı tutmak bakımı kolaylaştırır.

HEARTBEAT.md: Zamanlanmış kontroller

Bu dosya, ajanınızın heartbeat yoklamaları sırasında ne yapacağını kontrol eder - sistemin herhangi bir şeyin ilgi gerektirip gerektirmediğini kontrol ettiği zamanlanmış anlar.

1# HEARTBEAT.md
2
3**Mesaj "⚠️ EXECUTION CRON" içeriyorsa:**
4- Bu bir heartbeat kontrolü DEĞİLDİR - yapılacak bir iştir
5- Mesajdaki tüm talimatları okuyun
6- Gerekli tüm adımları uygulayın
7- Asla HEARTBEAT_OK döndürmeyin
8
9**Aksi takdirde:**
10- İlgi gerektiren bir şey yoksa, HEARTBEAT_OK döndürün
11- Minimumda tutun

Heartbeat'ler, proaktif ajanlar oluşturmak için güçlüdür. Ajanınız, takviminizi kontrol edebilir, gelen kutunuzu tarayabilir veya herhangi bir otomatik iş akışını bir programa göre çalıştırabilir - tümü heartbeat yoklamaları tarafından tetiklenir.

TOOLS.md: Harici araç dokümantasyonu

Bu dosya, harici araçlar ve kurallar hakkındaki notlarınızı tutar. Hangi araçların var olduğunu tanımlamaz (OpenClaw bunu dahili olarak halleder), ancak onları NASIL kullandığınızı belgelediğiniz yerdir.

1# TOOLS.md - Kullanıcı Araç Notları
2
3## E-posta CLI
4- Hesap: [email protected]
5- Yaygın: `cli email search`, `cli calendar create`
6
7## Görev Yönetimi API'si
8- Token konumu: ~/.secrets/task-api-token.txt
9- Sayfalama sorunlarından kaçınmak için her zaman `limit=100` kullanın
10- Durum dönüşümü: [kendi iş akışınızı belgeleyin]
11
12## Web kazıma aracı (siteler normal istekleri engellediğinde)
13- Konum: ~/clawd/.venv/scraper
14- Korumalı siteler için gizli mod kullanın

Bu, kişisel referans kılavuzunuz haline gelir. Ajanınız bir aracı kullanması gerektiğinde, sizin özel kurallarınız için TOOLS.md'yi kontrol eder.

skills/ klasörü: Yeniden kullanılabilir iş akışları

Beceriler, OpenClaw'un güçlendiği yerdir. Her beceri, görev, becerinin tanımıyla eşleştiğinde ajanınızın çağırabileceği, kendi kendine yeten bir iş akışıdır.

Her beceri, kendi alt dizininde bir SKILL.md dosyasıyla yaşar:

1skills/
2├── meeting-prep/
3│   └── SKILL.md
4├── social-post-writer/
5│   ├── SKILL.md
6│   └── references/
7│       └── templates.md
8└── podcast-show-notes/
9    └── SKILL.md

Bir SKILL.md, ne zaman kullanılacağını açıklamak için YAML ön yüz kullanır:

1---
2name: meeting-prep
3description: Otomatik arama öncesi araştırma ve brifing. Kullanıcı yaklaşan toplantıları kontrol etmek veya toplantı hazırlığı yapmak istediğinde kullanın.
4---
5
6# Toplantı Hazırlık Becerisi
7
8## Ne zaman tetiklenir:
9- Kullanıcı yaklaşan toplantıları kontrol etmek istediğinde
10- Cron aracılığıyla her 10 dakikada bir çalışacak şekilde zamanlanmıştır
11- Yalnızca İLK KEZ yapılan görüşmeler için brifing ver
12
13## Süreç:
141. Önümüzdeki 15-45 dakika içindeki toplantılar için takvimi kontrol et
152. Katılımcıları araştır (LinkedIn, şirket web sitesi)
163. Brifing belgesi oluştur
174. Takvim etkinliğine bağlantı ekle

Statik talimatlardan temel fark: beceriler, yanlarında destekleyici dosyaları paketleyebilir. references/templates.md dosyası, yalnızca beceri etkin olduğunda yüklenen örnek çıktıları, kanıtlanmış formatları veya ek bağlamı tutabilir.

memory/ klasörü: Kalıcı bağlam

Bu, ajanınızın uzun süreli hafızasıdır. Oturum transkriptleri, öğrenilen tercihler ve günlük kayıtların tümü burada yaşar.

1memory/
2├── 2026-03-22.md
3├── 2026-03-21.md
4├── email-style.md
5├── business-context-2026-02.md
6└── workflow-playbook.md

İyi uygulamalar:

• Günlük kayıtları memory/YYYY-AA-GG.md olarak tutun
• Oturum başlangıcında, ajanınız varsa bugünü ve dünü okur
• Kalıcı gerçekleri, tercihleri ve kararları yakalayın
• Gizli bilgileri saklamaktan kaçının

Hafıza dosyaları, ajanınıza oturumlar arasında bağlam sağlayan şeydir. Onlar olmadan, her konuşma sıfırdan başlar.

.secrets/ klasörü: Kimlik bilgileri

API token'ları, şifreler ve hassas yapılandırma burada yaşar. Bu klasör .gitignore'a eklenmeli ve asla sürümlenmemelidir.

1.secrets/
2├── task-api-token.txt
3├── openai-api-key.txt
4├── anthropic-api-key.txt
5└── service-credentials.txt

AGENTS.md veya TOOLS.md dosyanız, gerçek değerleri ifşa etmeden bu yollara başvurabilir.

Kanal yapılandırması: Ajanınızla nerede konuşursunuz

OpenClaw, birden çok mesajlaşma kanalını destekler: Discord, Telegram, Signal, WhatsApp ve daha fazlası. Kanal yapılandırması, ağ geçidi yapılandırmanızda (clawdbot gateway komutları ile yönetilir) yaşar.

Anahtar kavramlar:

• Her kanalın kendi oturum davranışı vardır
• Aynı anda birden çok kanalı aktif hale getirebilirsiniz
• Kanala özel kurallar (Discord'da "@mentioned olmadıkça yanıt verme" gibi) AGENTS.md'ye gider

Tam resim

İşte her şeyin nasıl bir araya geldiği:

1~/clawd/
2├── AGENTS.md           # Çalıştırma talimatları (günlük kullanım)
3├── SOUL.md             # Kişilik ve sınırlar
4├── IDENTITY.md         # Ajan kimliği
5├── USER.md             # Profiliniz
6├── HEARTBEAT.md        # Zamanlanmış kontrol davranışı
7├── TOOLS.md            # Harici araç dokümantasyonu
8├── BOOTSTRAP.md        # İlk çalıştırma ritüeli (sonra silin)
9│
10├── skills/             # Özel iş akışları
11│   ├── meeting-prep/
12│   ├── podcast-show-notes/
13│   └── social-post-writer/
14│
15├── memory/             # Kalıcı bağlam
16│   ├── 2026-03-22.md
17│   └── key-context.md
18│
19├── .secrets/           # API anahtarları ve kimlik bilgileri (gitignored)
20│   ├── task-api-token.txt
21│   └── anthropic-api-key.txt
22│
23└── output/             # Oluşturulan dosyalar ve dışa aktarımlar

Başlamak için pratik bir kurulum

Sıfırdan başlıyorsanız, işte iyi çalışan bir ilerleme.

Adım 1. openclaw onboard'u çalıştırın ve ilk kurulumu tamamlayın. Model sağlayıcınızı seçin ve en az bir kanal bağlayın.

Adım 2. Çalışma alanı klasörünüzü oluşturun ve temel yönergelerinizle AGENTS.md dosyasını ekleyin. Ana kullanım durumlarınızı kapsayan 10-20 satırla başlayın.

Adım 3. IDENTITY.md, USER.md ve SOUL.md dosyalarını ekleyin. Bunlar ilişkiyi ve kişiliği kurar.

Adım 4. Tekrar tekrar yaptığınız bir iş akışı için ilk becerinizi oluşturun. Toplantı hazırlığı, e-posta taslakları veya içerik oluşturma iyi başlangıç noktalarıdır.

Adım 5. Günlük bir kayıt şablonuyla memory/ klasörünü ayarlayın. Ajanınız zamanla bağlam oluşturmaya başlayacaktır.

Adım 6. Belgelemeye değer araçlara özgü desenler keşfettikçe TOOLS.md dosyasını ekleyin.

Kullanım durumlarının %95'i için gerçekten ihtiyacınız olan tek şey budur. Cron işleri, çoklu ajan kurulumları ve özel kanal eklentileri gibi gelişmiş özellikler, otomatikleştirmeye değer belirli iş akışlarınız olduğunda devreye girer.

Kilit içgörü

OpenClaw çalışma alanınız, aslında yapay zeka asistanınıza kim olduğunuzu, ne yapılmasına ihtiyacınız olduğunu ve hangi kurallara uyması gerektiğini söylemek için bir protokoldür. Bunu ne kadar net tanımlarsanız, ajanınızı düzeltmek için o kadar az zaman harcar ve o kadar çok zaman yararlı işler yaparak geçirirsiniz.

AGENTS.md en yüksek kaldıraçlı dosyanızdır. Önce bunu doğru yapın. Diğer her şey optimizasyondur.

Küçük başlayın, ilerledikçe iyileştirin ve iş akışınızdaki diğer tüm altyapılar gibi davranın: doğru kurulduğunda her gün temettü ödeyen bir şey.

Not: OpenClaw sadece bir başlangıç.

Build With AI topluluğumuzda, size kendi özel ajanlarınızı, uygulamalarınızı ve otomasyonlarınızı nasıl oluşturacağınızı öğreteceğim - bunları kendiniz kullanabilir veya müşterilerinize satabilirsiniz. Çok yakında başlıyor.

Bekleme listesine buradan katılın:

https://return-my-time.kit.com/1bd2720397