Ayrıntıları doğrularken şu resmî sayfaları da açın: OpenClaw Getting Started · OpenClaw Tools · OpenClaw CLI · OpenClaw Agent Runtime · OpenClaw FAQ · OpenClaw Docs Hubs.
İçindekiler
- Bu yazı kimin için
- Üç dosya türü neyden sorumlu
- SOUL.md: önce kırmızı çizgi, sonra görev
- USER.md: kişisel tercihleri alan olarak yazın
- HEARTBEAT.md: az frekans, çok doğrulama
- Önerilen alan tablosu
- Yapılandırmanın da sürümü olmalı
- Sık yapılan hatalar
- Sık sorulan sorular
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.
Üç dosya türü neyden sorumlu
| Dosya | Cevapladığı soru | İçine yazılmamalı |
|---|---|---|
| SOUL.md | Bu Agent’ın görevi, sınırı ve yasak bölgesi | Özel anahtar, API anahtarı, geçici duygular |
| USER.md | İlgi alanınız, dil, saat dilimi, tercihler | Sık değişen zamanlama kuralları |
| HEARTBEAT.md | Ne zaman çalışacak, hangi görevleri yapacak, hata olunca ne olacak | Yatırım sonucu ve öznel tahmin |
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.
HEARTBEAT.md: az frekans, çok doğrulama
Yeni kullanıcılar frekans ne kadar yüksekse o kadar iyi sanır; gerçekte bu daha çok kaygı ve hatalı alarm üretir. Günlük özet günde bir kez olabilir; duyuru izleme 30-60 dakikada bir; zincir üstü büyük transferin net bir amacı yoksa önce yüksek frekansla bildirim göndermeyin.
Ö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 |
Yapılandırmanın da sürümü olmalı
Her yapılandırma değişikliğinde dosyanın sonuna bir güncelleme satırı yazın: tarih, değişiklik, neden, gözlem sonucu. İçerik ile AI aracı aynıdır; gerçek değer tek seferde yazıp bırakmakta değil, uzun vadeli iterasyondadır.
Sık yapılan hatalar
- API anahtarını ya da seed ifadesini düz metin olarak yapılandırma dosyasına yazmak.
- Kırmızı çizgileri dosyanın en altına koyup modelin bağlamı kaybetmesine izin vermek.
- Çok sayıda muğlak slogan yazıp tek bir net yasak cümlesi koymamak.
- Yapılandırmayı sürümsüz tutup hangi değişikliğin sorunu yarattığını bulamamak.
Sık sorulan sorular
Tüm kuralları tek dosyaya yazabilir miyim?
Yazabilirsiniz, ama ileride bakımı zorlaşır. Sınırı, tercihi ve zamanlamayı ayırmak sorunu bulmayı kolaylaştırır.
Yapılandırma ne kadar uzunsa o kadar iyi mi?
Hayır. Kritik kırmızı çizgiler kısa ve net olmalı, örnekler gerçek senaryonuza yakın olmalı; bol miktarda muğlak slogan yığmaktan kaçının.
Son güncelleme: 2026-06-01. Bu yazı ChainSentry’nin özgün rehberidir; Binance veya OpenClaw resmi dokümanı değildir.