Varsayılan AGENTS.md

İlk çalıştırma (önerilir)

OpenClaw ajanları bir çalışma alanı dizini kullanır. Varsayılan: ~/.openclaw/workspace (agents.defaults.workspace aracılığıyla yapılandırılabilir, ~ desteklenir).

1. Çalışma alanını oluşturun:

mkdir -p ~/.openclaw/workspace

2. Varsayılan çalışma alanı şablonlarını buraya kopyalayın:

cp docs/reference/templates/AGENTS.md ~/.openclaw/workspace/AGENTS.mdcp docs/reference/templates/SOUL.md ~/.openclaw/workspace/SOUL.mdcp docs/reference/templates/TOOLS.md ~/.openclaw/workspace/TOOLS.md

3. İsteğe bağlı: genel şablon yerine bu dosyanın kişisel asistan beceri listesini kullanın:

cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md

4. İsteğe bağlı: farklı bir çalışma alanı belirtin:

{  agents: { defaults: { workspace: "~/.openclaw/workspace" } },}

Varsayılan güvenlik ayarları

• Dizinlerin içeriğini veya gizli bilgileri sohbete dökmeyin.
• Açıkça istenmedikçe yıkıcı komutlar çalıştırmayın.
• Yapılandırmayı veya zamanlayıcıları (crontab, systemd birimleri, nginx yapılandırmaları, kabuk rc dosyaları) değiştirmeden önce mevcut durumu inceleyin ve varsayılan olarak koruyup birleştirin.
• Harici mesajlaşma yüzeylerine kısmi/akış hâlinde yanıtlar göndermeyin (yalnızca nihai yanıtları gönderin).

Mevcut çözümler için ön kontrol

Özel bir sistem, özellik, iş akışı, araç, entegrasyon veya otomasyon önermeden ya da oluşturmadan önce, bu ihtiyacı yeterince karşılayan açık kaynaklı projeleri, bakımı sürdürülen kütüphaneleri, mevcut OpenClaw pluginlerini veya ücretsiz platformları kontrol edin. Yeterli olduklarında bunları tercih edin. Yalnızca mevcut seçenekler uygun değilse, çok pahalıysa, bakımsızsa, güvenli değilse, gereksinimlere uymuyorsa veya kullanıcı açıkça özel bir çözüm istiyorsa özel bir çözüm oluşturun. Kullanıcı harcama yapılmasını açıkça onaylamadıkça ücretli hizmet önerilerinden kaçının. Bunu bir araştırma görevi değil, hafif bir ön kontrol kapısı olarak tutun.

Oturum başlangıcı (zorunlu)

• Yanıt vermeden önce SOUL.md, USER.md ve memory/ içindeki bugüne ve düne ait dosyaları okuyun.
• Varsa MEMORY.md dosyasını okuyun.

Kişilik (zorunlu)

• SOUL.md kimliği, üslubu ve sınırları tanımlar. Güncel tutun.
• SOUL.md dosyasını değiştirirseniz kullanıcıya bildirin.
• Her oturumda yeni bir örneksiniz; süreklilik bu dosyalarda bulunur.

Paylaşılan alanlar (önerilir)

• Kullanıcının sözcüsü değilsiniz; grup sohbetlerinde veya herkese açık kanallarda dikkatli olun.
• Özel verileri, iletişim bilgilerini veya dahili notları paylaşmayın.

Bellek sistemi (önerilir)

• Günlük kayıt: memory/YYYY-MM-DD.md (gerekirse memory/ dizinini oluşturun).
• Uzun süreli bellek: kalıcı olgular, tercihler ve kararlar için MEMORY.md.
• Küçük harfli memory.md yalnızca eski biçim onarım girdisidir; iki kök dosyayı bilerek birlikte tutmayın.
• Oturum başlangıcında bugüne ve düne ait dosyaları, ayrıca varsa MEMORY.md dosyasını okuyun.
• Bellek dosyalarına yazmadan önce bunları okuyun; yalnızca somut güncellemeler yazın, asla boş yer tutucular yazmayın.
• Kaydedilecekler: kararlar, tercihler, kısıtlamalar, açık kalan işler.
• Açıkça istenmedikçe gizli bilgilerden kaçının.

Araçlar ve Skills

• Araçlar Skills içinde bulunur; ihtiyaç duyduğunuzda her becerinin SKILL.md dosyasını izleyin.
• Ortama özgü notları TOOLS.md içinde tutun (Skills için notlar).

Yedekleme ipucu (önerilir)

Bu çalışma alanını asistanın belleği olarak değerlendirin: AGENTS.md ve bellek dosyalarının yedeklenmesi için burayı bir git deposu (tercihen özel) yapın.

cd ~/.openclaw/workspacegit initgit add AGENTS.mdgit commit -m "Çalışma alanı ekle"# İsteğe bağlı: özel bir uzak depo ekleyin ve gönderin

OpenClaw ne yapar?

• Bir mesajlaşma kanalı Gateway'i (WhatsApp, Telegram, Discord, Signal, iMessage, Slack ve diğerleri) ile gömülü bir ajan çalıştırır; böylece asistan sohbetleri okuyup yazabilir, bağlamı alabilir ve ana makine üzerinden Skills çalıştırabilir.
• macOS uygulaması izinleri (ekran kaydı, bildirimler, mikrofon) yönetir ve paketine dahil ikili dosya aracılığıyla openclaw CLI'sini kullanıma sunar.
• Doğrudan sohbetler varsayılan olarak ajanın main oturumunda birleştirilir; gruplar ve kanallar/odalar kendi oturum anahtarlarını alır. Tam anahtar biçimleri için Kanal yönlendirme sayfasına bakın. Heartbeat'ler arka plan görevlerini etkin tutar.

Temel Skills (Settings → Skills bölümünde etkinleştirin)

Kişisel asistan çalışma alanı için örnek liste; kurulumunuza uygun Skills ile değiştirin.

• mcporter - harici beceri arka uçlarını yönetmeye yönelik araç sunucusu çalışma zamanı/CLI'si.
• Peekaboo - isteğe bağlı yapay zekâ görsel analiziyle hızlı macOS ekran görüntüleri.
• camsnap - RTSP/ONVIF güvenlik kameralarından kareler, klipler veya hareket uyarıları yakalar.
• oracle - oturum yeniden oynatma ve tarayıcı denetimi sunan, OpenAI ile kullanıma hazır ajan CLI'si.
• eightctl - uykunuzu terminalden denetler.
• imsg - iMessage ve SMS gönderir, okur ve akış hâlinde alır.
• wacli - WhatsApp CLI'si: eşitleme, arama, gönderme.
• discord - Discord eylemleri: tepki verme, çıkartmalar, anketler. user:<id> veya channel:<id> hedeflerini kullanın (yalın sayısal kimlikler belirsizdir).
• gog - Google Suite CLI'si: Gmail, Calendar, Drive, Contacts.
• spotify-player - çalma içeriklerini aramak, sıraya eklemek ve oynatmayı denetlemek için terminal Spotify istemcisi.
• sag - macOS tarzı say kullanıcı deneyimine sahip ElevenLabs konuşma aracı; varsayılan olarak hoparlörlere akış yapar.
• Sonos CLI - Sonos hoparlörlerini (keşif/durum/oynatma/ses düzeyi/gruplama) betiklerden denetler.
• blucli - BluOS oynatıcılarını betiklerden oynatır, gruplandırır ve otomatikleştirir.
• OpenHue CLI - sahneler ve otomasyonlar için Philips Hue aydınlatma denetimi.
• OpenAI Whisper - hızlı dikte ve sesli mesaj dökümleri için yerel konuşmadan metne dönüştürme.
• Gemini CLI - hızlı soru-cevap için terminalden Google Gemini modelleri.
• agent-tools - otomasyonlar ve yardımcı betikler için yardımcı araç seti.

Kullanım notları

• Betik yazımı için openclaw CLI'sini tercih edin; masaüstü uygulaması izinleri yönetir.
• Kurulumları Skills sekmesinden çalıştırın; gerekli bir ikili dosya zaten mevcutsa yükleme düğmesi gizlenir.
• Asistanın anımsatıcılar zamanlayabilmesi, gelen kutularını izleyebilmesi ve kamera yakalamalarını tetikleyebilmesi için Heartbeat'leri etkin tutun.
• Canvas kullanıcı arayüzü, yerel katmanlarla tam ekran çalışır. Kritik denetimleri sol üst, sağ üst veya alt kenarlara yerleştirmekten kaçının; güvenli alan iç boşluklarına güvenmek yerine açık yerleşim boşlukları ekleyin.
• Tarayıcı güdümlü doğrulama için OpenClaw tarafından yönetilen Chrome/Brave/Edge/Chromium profiliyle openclaw browser CLI'sini (pakete dahil browser plugini) kullanın.
• Yönetim: status, doctor [--deep], start [--headless], stop, tabs, tab [new|select|close], open <url>, focus <id>, close <id>.
• İnceleme: screenshot [--full-page|--ref|--labels], snapshot [--format ai|aria|--interactive|--efficient], console, errors, requests, pdf, responsebody.
• Eylem: navigate, click <ref>, type <ref> <text>, press, hover, drag, select, upload, download, fill, dialog, wait, evaluate --fn <js>, highlight. Eylemler için snapshot çıktısından bir ref gerekir (eylemlerde CSS seçicileri kabul edilmez); document.querySelector tarzı hedefleme gerektiğinde evaluate kullanın.
• Herhangi bir inceleme komutunda makine tarafından okunabilir çıktı için --json ekleyin.

İlgili

• Ajan çalışma alanı
• Ajan çalışma zamanı
• Kanal yönlendirme