Bu sayfanın eski sürümü SOUL.md, USER.md ve HEARTBEAT.md dosyalarını eş düzeyde üç yapılandırma olarak anlatıyordu. Bunlardan biri değişti: SOUL.md ile USER.md workspace bağlamı olarak sürüyor; eski HEARTBEAT.md ise sistemin yönettiği monitor scratch ile değiştirildi. Eski kurulumda farklı kuşak örneklerini birleştirmeden önce taşıma durumunu kontrol edin.
İçindekiler
- Bu yazı kimin için
- Konumu bilginin görevine göre seçin
- SOUL.md: önce kırmızı çizgi, sonra görev
- USER.md: kişisel tercihleri alan olarak yazın
- Eski HEARTBEAT.md: taşıyın, yeni içerik eklemeyin
- Önerilen alan tablosu
- Geri dönebileceğiniz bir sürüm bırakın
- Davranış bozulduysa önce sorumlu dosyayı bulun
Bu yazı kimin için
OpenClaw’u kurmuş ama çıktısı bazen dağınık, bazen aşırı konuşkan, bazen sınır tanımayan kullanıcılar içindir. Sorunun çoğu modelde değil, yapılandırmanın belirsizliğinde gizlidir. Rolü, tercihi ve zamanlamayı tek dosyaya yığarsanız sorunu izole etmek zorlaşır.
Hazır şablonu kopyalayıp “neden çalışmıyor” diye merak edenler için uygun değildir. Buradaki amaç, her alanın ne işe yaradığını anlayıp kendi ihtiyacınıza göre uyarlamanızdır.
Konumu bilginin görevine göre seçin
| İçerik | Güncel konum | Ne yazılır |
|---|---|---|
SOUL.md | Workspace bağlamı | Kişilik, ton ve sınırlar |
USER.md | Workspace bağlamı | Kalıcı tercih ve hitap biçimi |
AGENTS.md | Workspace talimatı | Çalışma, proje ve araç kuralları |
| Monitor scratch | Sistem yönetimli cron job | Periyodik kontrol, uyarı koşulu ve sessiz kalma kuralı |
SOUL.md: önce kırmızı çizgi, sonra görev
SOUL, Agent’ın “karakteri ve hukukudur”. Sıradan kullanıcı için en önemlisi AI’ı daha iyi konuşturmak değil, neyi yapamayacağını öğretmektir. Kırmızı çizgileri dosyanın başına koyun ve net yasak cümleleri kullanın.
Sen ChainSentry’nin salt okunur bilgi derleme Agent’ısın.
YASAK: alım-satım önerisi, pozisyon önerisi, getiri vaadi, garantili güvenlik sonucu üretmek.
YASAK: kullanıcıdan seed ifadesi, doğrulama kodu, uzaktan kontrol, işlem yetkili API anahtarı istemek.
ZORUNLU: her kritik sonuca kaynak, zaman ve insan doğrulaması notu eklemek.USER.md: kişisel tercihleri alan olarak yazın
USER bir günlük değil, tercih tablosudur. İzlediğiniz varlıkları, dili, bildirim zamanını, risk anahtar kelimelerini, yok sayma listesini ve çıktı uzunluğunu yazın. Böylece sonradan ayar yaparken SOUL’daki temel sınırları değiştirmek zorunda kalmazsınız.
Eski HEARTBEAT.md: taşıyın, yeni içerik eklemeyin
Güncel taşıma sayfası yeni workspace'in HEARTBEAT.md oluşturmadığını veya okumadığını belirtir. Eski dosya varsa openclaw doctor --fix ile içeriği taşıtıp arşivleyin. Aynı görevi hem dosyada hem monitörde tutmayın.
Sonra monitor job'u openclaw automations list --all ile bulun ve talimatı openclaw automations scratch <jobId> ile okuyun. Yalnız doğru job kimliği doğrulandıktan sonra değiştirin. Eski rehberlerde geçen openclaw cron … aynı komutların takma adıdır (resmi Automations belgesi cron'un hâlâ çalıştığını söyler); iki yazım da aynı sonucu verir.
Önerilen alan tablosu
| Alan | Önerilen yazım | Kontrol noktası |
|---|---|---|
| sources | Resmi duyuru, fiyat API’si, zincir tarayıcı listelenir | Orijinali açılabiliyor mu |
| output_format | Sabit: özet, anormallik, doğrulama bekleyen, yasak sonuç | Gereksiz laf azalıyor mu |
| red_lines | Getiri vaadi ve işlem komutu yasak | İlk 20 satırda mı |
| failure_policy | API başarısızsa “veri eksik” yaz | Uydurmayı önlüyor mu |
Geri dönebileceğiniz bir sürüm bırakın
Düzenlemeden önce mevcut dosyayı saklayıp tarihi, amacı ve beklenen sonucu yazın. Her testte tek değişkeni değiştirin; sonuç kötüleşirse yeni yama eklemek yerine önceki sürüme dönün.
Davranış bozulduysa önce sorumlu dosyayı bulun
- Ton değişiyor: SOUL.md içindeki çelişkili kuralları arayın.
- Tercih yanlış: USER.md içinde eski ve yeni kuralın birlikte etkin olup olmadığına bakın.
- Uyarı iki kez geliyor: yalnız HEARTBEAT.md değil, cron job ile monitor scratch'i inceleyin.
- Düzenleme etkisiz: Gateway'in aynı agent workspace'i kullandığını ve enjekte edilen bağlamı kontrol edin.
Normal istek, eksik bilgi ve sınır aşan istekle test edin. Resmî Agent workspace, Agent runtime ve HEARTBEAT.md taşıma notunu kullanın.
Bilgiler 2026-09-26 tarihinde kontrol edildi. Kolay değişen karakter sınırları ve varsayılan aralıklar kopyalanmadı.