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ını gösterin:

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

Güvenlik varsayılanları

• Dizinleri 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 koruyun/birleştirin.
• Harici mesajlaşma yüzeylerine kısmi/akış hâlinde yanıtlar göndermeyin (yalnızca nihai yanıtlar).

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

Özel bir sistem, özellik, iş akışı, araç, entegrasyon veya otomasyon önermeden ya da oluşturmadan önce, bunu yeterince iyi şekilde zaten çözen açık kaynaklı projeleri, bakımı sürdürülen kitaplıkları, 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üvensizse, uyumlu değilse veya kullanıcı açıkça özel bir çözüm istiyorsa özel bir çözüm oluşturun. Kullanıcı harcama yapmayı açıkça onaylamadıkça ücretli hizmet önerilerinden kaçının. Bunu hafif kapsamlı bir ön kontrol kapısı olarak tutun; bir araştırma görevi hâline getirmeyin.

Oturum başlangıcı (zorunlu)

• Yanıt vermeden önce SOUL.md, USER.md ve memory/ içindeki bugün+dün kayıtlarını okuyun.
• Mevcut olduğunda MEMORY.md dosyasını okuyun.

Ruh (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; devamlılık bu dosyalarda yaşar.

Paylaşılan alanlar (önerilir)

• Kullanıcının sesi 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/ oluşturun).
• Uzun süreli bellek: kalıcı bilgiler, tercihler ve kararlar için MEMORY.md.
• Küçük harfli memory.md yalnızca eski onarım girdisidir; her iki kök dosyayı bilerek birlikte tutmayın.
• Oturum başlangıcında bugün + dün + mevcut olduğunda MEMORY.md dosyasını okuyun.
• Bellek dosyalarına yazmadan önce bunları okuyun; yalnızca somut güncellemeleri yazın, asla boş yer tutucular yazmayın.
• Kaydedin: kararlar, tercihler, kısıtlamalar, açık kalan işler.
• Açıkça istenmedikçe gizli bilgilerden kaçının.

Araçlar ve beceriler

• Araçlar becerilerde bulunur; ihtiyaç duyduğunuzda her becerinin SKILL.md dosyasını izleyin.
• Ortama özgü notları TOOLS.md içinde tutun (becerilere ilişkin 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 "Add workspace"# İsteğe bağlı: özel bir uzak depo ekleyin + 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 becerileri çalıştırabilir.
• macOS uygulaması izinleri (ekran kaydı, bildirimler, mikrofon) yönetir ve paketindeki 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. Kesin anahtar biçimleri için Kanal yönlendirme bölümüne bakın. Heartbeat'ler arka plan görevlerini etkin tutar.

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

Kişisel asistan çalışma alanı için örnek liste; kurulumunuza uygun becerilerle 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 özellikli, OpenAI uyumlu ajan CLI'si.
• eightctl - uykunuzu terminalden yönetin.
• imsg - iMessage ve SMS gönderin, okuyun, akış hâlinde alın.
• wacli - WhatsApp CLI'si: eşitleyin, arayın, gönderin.
• 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 - oynatmayı aramak/sıraya almak/denetlemek için terminal Spotify istemcisi.
• sag - macOS tarzı say kullanıcı deneyimine sahip ElevenLabs konuşma özelliği; varsayılan olarak hoparlörlere akış yapar.
• Sonos CLI - Sonos hoparlörlerini betiklerden denetleyin (keşif/durum/oynatma/ses düzeyi/gruplandırma).
• blucli - BluOS oynatıcılarını betiklerden oynatın, gruplandırın ve otomatikleştirin.
• 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 mevcut olduğunda kurulum düğmesi gizlenir.
• Asistanın anımsatıcılar zamanlayabilmesi, gelen kutularını izleyebilmesi ve kamera çekimlerini tetikleyebilmesi için Heartbeat'leri etkin tutun.
• Canvas kullanıcı arayüzü yerel katmanlarla tam ekran çalışır. Kritik denetimleri sol üst/sağ üst/alt kenarlara yerleştirmekten kaçının; güvenli alan girintilerine güvenmek yerine açık yerleşim boşlukları ekleyin.
• Tarayıcı tarafından yürütülen doğrulama için OpenClaw tarafından yönetilen Chrome/Brave/Edge/Chromium profiliyle openclaw browser CLI'sini (paketli browser plugini) kullanın.
• Yönetin: status, doctor [--deep], start [--headless], stop, tabs, tab [new|select|close], open <url>, focus <id>, close <id>.
• İnceleyin: screenshot [--full-page|--ref|--labels], snapshot [--format ai|aria|--interactive|--efficient], console, errors, requests, pdf, responsebody.
• İşlem yapın: navigate, click <ref>, type <ref> <text>, press, hover, drag, select, upload, download, fill, dialog, wait, evaluate --fn <js>, highlight. Eylemler, snapshot kaynağından bir ref gerektirir (eylemler için 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