OpenClaw’a ilk bakıldığında insanın gözüne hemen bazı ilginç kavramlar çarpıyor: SOUL.md, MEMORY.md, AGENTS.md…
Bunlar klasik bir yazılım mimarisindeki sıradan config dosyaları gibi görünmüyor. Daha çok, bir yapay zekâ ajanına kimlik, karakter, alışkanlık ve süreklilik kazandıran yapı taşları gibi duruyorlar.

Peki OpenClaw tam olarak hangi parçalardan oluşuyor?
“Soul” yani ruh var, “memory” yani hafıza var; ama sistem bundan çok daha büyük.

Bu yazıda OpenClaw’ın ana bileşenlerini sade bir dille ele alalım.

OpenClaw’a iki katmanda bakmak daha doğru

OpenClaw’ı anlamanın en kolay yolu, sistemi iki ana katmanda düşünmek:

1. Çalışma zamanı / platform katmanı
Mesajlaşma kanalları, gateway, oturumlar, araçlar ve ajan çalıştırma mantığı burada yer alır.

2. Kimlik / çalışma alanı katmanı
Ajanın kim olduğu, kullanıcıyı nasıl gördüğü, neyi hatırladığı ve nasıl davranacağı burada tanımlanır.

Yani OpenClaw sadece bir “LLM wrapper” değildir.
Aynı zamanda bir ajanın kişiliğini, hafızasını, araç kullanımını ve kanallar arası devamlılığını tanımlayan bir yapı sunar.

1) Gateway: Sistemin merkezi sinir sistemi

OpenClaw’ın kalbinde Gateway bulunur.

Gateway’i, sistemin merkezi kontrol noktası gibi düşünebiliriz.
Mesajlaşma kanallarından gelen olayları toplar, oturumları yönetir, uygun ajan çalıştırmasını başlatır ve sonuçları yeniden ilgili kanala yollar.

Başka bir deyişle:

dış dünyadan mesajı alır,
bunu doğru oturuma bağlar,
ajanı çalıştırır,
araç kullanımı gerekiyorsa süreci yönetir,
cevabı geri gönderir.

Yani Gateway, OpenClaw’ın omurgasıdır.

2) Kanallar (Channels): Ajanın dünyaya açılan kapıları

OpenClaw tek bir sohbet penceresine sıkışmış değildir.
Farklı iletişim yüzeyleriyle çalışabilir: örneğin Telegram, Slack, Discord, WhatsApp ve benzeri kanallar.

Bu kanallar sayesinde aynı ajan, farklı yerlerde kullanıcılarla etkileşime girebilir.
OpenClaw’ın gücü biraz da burada ortaya çıkar: model sadece “cevap veren bir bot” olmaz, farklı platformlarda yaşayan bir yardımcıya dönüşür.

Bu yüzden kanallar, mimarinin yan unsuru değil, doğrudan ana bileşenlerinden biridir.

3) Agent Runtime: Düşünen ve hareket eden kısım

Bir mesaj geldikten sonra asıl iş ajan çalışma zamanında, yani agent runtime tarafında olur.

Burada ajan:

bağlamı toplar,
ilgili dosyaları okur,
hafızayı değerlendirir,
gerekirse araç çağırır,
son cevabı üretir.

Bu katman, OpenClaw’ın “akıl yürütme ve eylem” bölümüdür.
Yani Gateway trafiği yönetiyorsa, runtime düşünmeyi ve icrayı yönetir.

4) Session: Sürekliliği sağlayan oturum yapısı

Ajan sistemlerinde en önemli sorunlardan biri şudur:
“Bu konuşma hangi kullanıcıya, hangi kanala, hangi bağlama ait?”

OpenClaw bunu session yani oturum kavramıyla çözer.

Session, bir konuşmanın kimle ve hangi bağlamda sürdüğünü tanımlar.
Bu sayede ajan, farklı kişilerle yaptığı konuşmaları birbirine karıştırmaz ve bir kullanıcıyla süren diyaloğu devam ettirebilir.

Kısacası session, hafıza ile etkileşim arasında köprü kurar.

5) Workspace: Ajanın çalışma alanı

OpenClaw’ın en ilginç taraflarından biri, birçok şeyi dosya temelli ele almasıdır.

Burada devreye workspace yani çalışma alanı girer.
Workspace, ajanın kendisiyle ve kullanıcıyla ilgili temel dosyaların tutulduğu yerdir.

Bu alan sadece teknik ayarlar için değil; aynı zamanda ajanın kimliğini, davranış biçimini ve hatırladıklarını tanımlayan metin dosyalarını da içerir.

Yani klasik anlamda “ayar klasörü” değil, bir nevi ajanın yaşam alanıdır.

6) Ruh (SOUL.md): Ajanın karakteri

OpenClaw denince en dikkat çekici dosyalardan biri kuşkusuz SOUL.md’dir.

Bunu Türkçede en iyi ruh diye çevirebiliriz.
Ama dosyanın kendisi platform içinde yine SOUL.md olarak kalır.

Bu dosya, ajanın:

nasıl bir karaktere sahip olduğunu,
nasıl bir üslup kullandığını,
hangi değerlere bağlı olduğunu,
hangi sınırları koruduğunu

tanımlar.

Bir başka deyişle SOUL.md, ajanın “nasıl biri olduğunu” belirler.

Bu yüzden SOUL.md’yi sadece prompt dosyası gibi görmek yetersiz olur.
Daha doğru ifade şu olur:
Bu dosya, ajanın kişilik çekirdeğidir.

7) Kullanıcı (USER.md): Ajanın kimi desteklediği

Ajanın kim olduğunu tanımlamak yetmez; kimi desteklediğini de bilmesi gerekir.

İşte bunun için USER.md vardır.

Bunu Türkçede kullanıcı profili ya da daha sade biçimde kullanıcı tanımı diye düşünebiliriz.
Ama dosyanın gerçek adı yine USER.md olarak kalır.

Bu dosyada kullanıcıya dair bilgiler yer alabilir:

nasıl hitap edileceği,
tercihleri,
hassasiyetleri,
çalışma tarzı,
önemli kişisel bağlamlar.

Yani SOUL.md ajanın kim olduğunu anlatırken, USER.md ajanın kimin için çalıştığını anlatır.

8) Ajan talimatları (AGENTS.md): İşletim mantığı

Bir diğer kritik dosya da AGENTS.md’dir.

Bunu Türkçede ajan talimatları ya da işletim yönergesi gibi düşünebiliriz.
Yine dosya adı değişmez: AGENTS.md.

Bu dosya, ajanın nasıl hareket etmesi gerektiğini tanımlar:

öncelikleri nelerdir,
nasıl karar vermelidir,
hangi durumlarda nasıl davranmalıdır,
hafızayı nasıl kullanmalıdır,
hangi tür çıktılar üretmelidir.

SOUL.md daha çok “kişilik ve tavır” ile ilgiliyken,
AGENTS.md daha çok “çalışma prensipleri ve görev mantığı” ile ilgilidir.

Bu ayrım çok önemli.

Basitçe söylersek:

SOUL.md = Ben nasıl bir varlığım?
AGENTS.md = Ben nasıl çalışmalıyım?

9) Hafıza (MEMORY.md): Hatırlama katmanı

OpenClaw’daki bir diğer temel unsur hafıza, yani memory tarafıdır.

Bunun merkezinde genellikle MEMORY.md bulunur.
Bunu Türkçede hafıza dosyası diyebiliriz; ama gerçek dosya adı yine MEMORY.md’dir.

Bu bölüm ajanın uzun vadede önemli bulduğu şeyleri taşıyabilir:

kullanıcı tercihleri,
tekrar eden görevler,
önemli kararlar,
sürekli referans verilen bilgiler.

Böylece ajan her konuşmada sıfırdan başlamaz.
Bir süreklilik hissi oluşur.

10) Günlük hafıza dosyaları: Yakın geçmişin izi

OpenClaw’da hafıza tek bir büyük dosyadan ibaret değildir.
Bazı yapılarda günlük notlar veya tarih bazlı hafıza dosyaları da kullanılır; örneğin:

memory/YYYY-MM-DD.md

Bu yapıyı Türkçede günlük hafıza kayıtları gibi düşünebiliriz.

Bunlar uzun vadeli “öz hafıza”dan biraz farklıdır.
Daha çok yakın zamandaki olayların, gözlemlerin ve kısa vadeli bağlamın izini taşırlar.

Yani burada iki katmanlı bir hafıza anlayışı vardır:

kalıcı hafıza
günlük/episodik hafıza

Bu yaklaşım OpenClaw’ı ilginç kılan unsurlardan biridir.

11) Araç bilgisi (TOOLS.md): Ne yapabildiğini bilmek

Bir ajan sadece konuşmaz; gerektiğinde araç da kullanır.
İşte bu tarafta TOOLS.md devreye girer.

Bunu Türkçede araçlar rehberi ya da araç kullanım notları diye düşünebiliriz.
Dosya adı yine TOOLS.md olarak kalır.

Bu dosya, ajanın hangi araçlara erişimi olduğunu ve bunları nasıl kullanması gerektiğini düzenleyen bilgi katmanı gibi görülebilir.

Yani hafıza ajanın neyi hatırladığını anlatırken, TOOLS.md ajanın neyi yapabildiğini ve bunu nasıl yapması gerektiğini destekler.

12) Kimlik (IDENTITY.md): İsmi, tonu, dış görünümü

OpenClaw mimarisinde IDENTITY.md de ayrı bir rol oynar.

Bunu Türkçede kimlik diye çevirmek en uygunu olur.
Ama dosya adı yine IDENTITY.md olarak kalmalıdır.

Bu dosya, ajanın:

adı,
kendini sunuş biçimi,
genel dış tonu,
bazen sembolik kimliği

gibi unsurları barındırabilir.

Burada kritik fark şudur:

SOUL.md (ruh) daha derin kişilik katmanıdır.
IDENTITY.md (kimlik) ise bunun dışarı yansıyan sunumudur.

Yani biri iç dünya, diğeri dış görünüm gibidir.

13) Bootstrap ve Heartbeat: Yardımcı ama anlamlı dosyalar

OpenClaw yapısında bazen BOOTSTRAP.md ve HEARTBEAT.md gibi dosyalar da görülür.

Bunlar çekirdek bileşenler kadar merkezde olmasa da mimarinin yardımcı parçalarıdır.

BOOTSTRAP.md başlangıç/kurulum mantığını destekleyebilir.
HEARTBEAT.md ise süreklilik, ritim veya sistemsel canlılık hissi veren bir destek katmanı gibi düşünülebilir.

Bunlar her kullanıcı için en kritik dosyalar olmayabilir, ama OpenClaw’ın “ajanı yaşayan bir yapı gibi tasarlama” yaklaşımını yansıtır.

14) Skills: Yeteneklerin genişletilmesi

OpenClaw’da ajan yalnızca temel davranışlarla sınırlı kalmaz.
Skills yani yetenekler ile genişletilebilir.

Bunlar, ajana yeni kabiliyetler kazandıran modüler parçalar gibi düşünülebilir.
Örneğin belirli görevleri yapabilen, belli iş akışlarına odaklanan ya da harici sistemlerle entegrasyon sağlayan beceri paketleri olabilir.

Bu yüzden skills katmanı, OpenClaw’ı statik bir bot olmaktan çıkarıp gelişebilir bir ajana dönüştürür.

15) Tools ve sandboxing: Güvenli eylem alanı

Araç kullanımı OpenClaw’da önemli bir meseledir çünkü ajan sadece metin üretmekle kalmaz, işlem de yapabilir.

Bu nedenle araç katmanında iki konu öne çıkar:

hangi araçlara erişim olduğu
bunların ne kadar izole/güvenli çalıştırıldığı

Buradaki sandboxing yaklaşımı, ajanların özellikle çok kullanıcılı veya daha hassas ortamlarda daha kontrollü çalışmasını sağlar.

Yani bu katman, OpenClaw’ın “sadece zeki” değil, aynı zamanda “operasyonel” bir sistem olduğunu gösterir.

16) Canvas / görsel çalışma alanı

OpenClaw sadece mesajlaşma uygulamalarında yaşayan bir sistem olmak zorunda değildir.
Bazı kullanımlarda görsel bir çalışma yüzeyi, yani Canvas tarafı da bulunur.

Bu katman, ajanın sadece metinle değil, daha görsel ve etkileşimli biçimde de kullanıcıyla çalışabilmesini mümkün kılar.

Bu da OpenClaw’ı klasik sohbet botlarından ayıran başka bir noktadır.

Kısacası: OpenClaw’ın ana parçaları neler?

OpenClaw’ın temel bileşenlerini özetlemek istersek:

Gateway: merkezi kontrol noktası
Channels: dış dünyaya açılan iletişim yüzeyleri
Agent Runtime: düşünme ve eylem üretme katmanı
Session: konuşma sürekliliği
Workspace: ajanın dosya tabanlı yaşam alanı
SOUL.md (ruh): kişilik ve karakter çekirdeği
USER.md: kullanıcıyı tanımlayan bağlam
AGENTS.md: işletim talimatları
MEMORY.md (hafıza): uzun vadeli bellek
memory/YYYY-MM-DD.md: günlük / episodik hafıza
TOOLS.md: araç rehberi
IDENTITY.md (kimlik): sunum ve dış persona
Skills: genişletilebilir yetenekler
Canvas: görsel çalışma alanı

OpenClaw’ın Ana Bileşenleri: Ruh, Hafıza ve Daha Fazlası