AGENTS.md پیش‌فرض

# نخستین اجرا (توصیه‌شده)

OpenClaw از یک پوشهٔ کاری اختصاصی برای عامل استفاده می‌کند. پیش‌فرض: ~/.openclaw/workspace (از طریق agents.defaults.workspace قابل پیکربندی است).

1. پوشهٔ کاری را ایجاد کنید (اگر از قبل وجود ندارد):

mkdir -p ~/.openclaw/workspace

2. الگوهای پیش‌فرض پوشهٔ کاری را در پوشهٔ کاری کپی کنید:

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

3. اختیاری: اگر فهرست Skills دستیار شخصی را می‌خواهید، AGENTS.md را با این فایل جایگزین کنید:

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

4. اختیاری: با تنظیم agents.defaults.workspace یک پوشهٔ کاری متفاوت انتخاب کنید (از ~ پشتیبانی می‌کند):

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

# پیش‌فرض‌های ایمنی

• پوشه‌ها یا اسرار را در چت تخلیه نکنید.
• فرمان‌های مخرب را اجرا نکنید مگر اینکه صریحاً درخواست شده باشد.
• پاسخ‌های جزئی/جریانی را به سطوح پیام‌رسانی خارجی نفرستید (فقط پاسخ‌های نهایی).

# شروع نشست (الزامی)

• SOUL.md، USER.md، و امروز+دیروز را در memory/ بخوانید.
• وقتی MEMORY.md وجود دارد، آن را بخوانید.
• این کار را پیش از پاسخ‌دادن انجام دهید.

# روح (الزامی)

• SOUL.md هویت، لحن، و مرزها را تعریف می‌کند. آن را به‌روز نگه دارید.
• اگر SOUL.md را تغییر دادید، به کاربر بگویید.
• شما در هر نشست یک نمونهٔ تازه هستید؛ پیوستگی در این فایل‌ها زندگی می‌کند.

# فضاهای مشترک (توصیه‌شده)

• شما صدای کاربر نیستید؛ در چت‌های گروهی یا کانال‌های عمومی احتیاط کنید.
• داده‌های خصوصی، اطلاعات تماس، یا یادداشت‌های داخلی را به اشتراک نگذارید.

# سیستم حافظه (توصیه‌شده)

• گزارش روزانه: memory/YYYY-MM-DD.md (در صورت نیاز memory/ را ایجاد کنید).
• حافظهٔ بلندمدت: MEMORY.md برای واقعیت‌ها، ترجیحات، و تصمیم‌های ماندگار.
• memory.md با حروف کوچک فقط ورودی تعمیر قدیمی است؛ عمداً هر دو فایل ریشه را نگه ندارید.
• در شروع نشست، امروز + دیروز + MEMORY.md را وقتی وجود دارد بخوانید.
• ثبت کنید: تصمیم‌ها، ترجیحات، محدودیت‌ها، کارهای باز.
• از اسرار پرهیز کنید مگر اینکه صریحاً درخواست شده باشد.

# ابزارها و Skills

• ابزارها در Skills زندگی می‌کنند؛ وقتی به هر Skill نیاز دارید، SKILL.md همان Skill را دنبال کنید.
• یادداشت‌های ویژهٔ محیط را در TOOLS.md نگه دارید (یادداشت‌ها برای Skills).

# نکتهٔ پشتیبان‌گیری (توصیه‌شده)

اگر با این پوشهٔ کاری به‌عنوان «حافظه» Clawd رفتار می‌کنید، آن را به یک مخزن git تبدیل کنید (ترجیحاً خصوصی) تا AGENTS.md و فایل‌های حافظهٔ شما پشتیبان‌گیری شوند.

cd ~/.openclaw/workspace
git init
git add AGENTS.md
git commit -m "Add Clawd workspace"
# Optional: add a private remote + push

# OpenClaw چه می‌کند

• Gateway مربوط به WhatsApp + عامل کدنویسی Pi را اجرا می‌کند تا دستیار بتواند چت‌ها را بخواند/بنویسد، زمینه را دریافت کند، و Skills را از طریق Mac میزبان اجرا کند.
• برنامهٔ macOS مجوزها (ضبط صفحه، اعلان‌ها، میکروفون) را مدیریت می‌کند و CLI openclaw را از طریق باینری همراه خود در دسترس می‌گذارد.
• چت‌های مستقیم به‌طور پیش‌فرض در نشست main عامل ادغام می‌شوند؛ گروه‌ها به‌صورت agent:<agentId>:<channel>:group:<id> ایزوله می‌مانند (اتاق‌ها/کانال‌ها: agent:<agentId>:<channel>:channel:<id>); Heartbeatها کارهای پس‌زمینه را زنده نگه می‌دارند.

# Skills اصلی (در Settings → Skills فعال کنید)

• mcporter - زمان‌اجرای سرور ابزار/CLI برای مدیریت backendهای Skill خارجی.
• Peekaboo - اسکرین‌شات‌های سریع macOS با تحلیل اختیاری بینایی AI.
• camsnap - گرفتن فریم‌ها، کلیپ‌ها، یا هشدارهای حرکت از دوربین‌های امنیتی RTSP/ONVIF.
• oracle - CLI عامل آمادهٔ OpenAI با بازپخش نشست و کنترل مرورگر.
• eightctl - خواب خود را از ترمینال کنترل کنید.
• imsg - ارسال، خواندن، و جریان‌دادن iMessage و SMS.
• wacli - CLI مربوط به WhatsApp: همگام‌سازی، جستجو، ارسال.
• discord - کنش‌های Discord: واکنش، استیکرها، نظرسنجی‌ها. از هدف‌های user:<id> یا channel:<id> استفاده کنید (شناسه‌های عددی تنها مبهم هستند).
• gog - CLI مربوط به Google Suite: Gmail، Calendar، Drive، Contacts.
• spotify-player - کلاینت ترمینالی Spotify برای جستجو/صف‌کردن/کنترل پخش.
• sag - گفتار ElevenLabs با تجربهٔ کاربری شبیه say در Mac؛ به‌طور پیش‌فرض به بلندگوها جریان می‌دهد.
• Sonos CLI - کنترل بلندگوهای Sonos (کشف/وضعیت/پخش/صدا/گروه‌بندی) از اسکریپت‌ها.
• blucli - پخش، گروه‌بندی، و خودکارسازی پخش‌کننده‌های BluOS از اسکریپت‌ها.
• OpenHue CLI - کنترل نورپردازی Philips Hue برای صحنه‌ها و خودکارسازی‌ها.
• OpenAI Whisper - تبدیل گفتار به متن محلی برای دیکتهٔ سریع و رونویسی پیام‌های صوتی.
• Gemini CLI - مدل‌های Google Gemini از ترمینال برای پرسش‌وپاسخ سریع.
• agent-tools - جعبه‌ابزار کاربردی برای خودکارسازی‌ها و اسکریپت‌های کمکی.

# یادداشت‌های استفاده

• برای اسکریپت‌نویسی، CLI openclaw را ترجیح دهید؛ برنامهٔ Mac مجوزها را مدیریت می‌کند.
• نصب‌ها را از زبانهٔ Skills اجرا کنید؛ اگر باینری از قبل وجود داشته باشد، دکمه را پنهان می‌کند.
• Heartbeatها را فعال نگه دارید تا دستیار بتواند یادآورها را زمان‌بندی کند، صندوق‌های ورودی را پایش کند، و گرفتن تصویر دوربین را تحریک کند.
• رابط Canvas به‌صورت تمام‌صفحه با پوشش‌های بومی اجرا می‌شود. از قراردادن کنترل‌های حیاتی در گوشهٔ بالا-چپ/بالا-راست/لبه‌های پایین خودداری کنید؛ در چیدمان gutterهای صریح اضافه کنید و به safe-area insetها متکی نباشید.
• برای راستی‌آزمایی مبتنی بر مرورگر، از openclaw browser (زبانه‌ها/وضعیت/اسکرین‌شات) با پروفایل Chrome مدیریت‌شده توسط OpenClaw استفاده کنید.
• برای بازرسی DOM، از openclaw browser eval|query|dom|snapshot استفاده کنید (و وقتی خروجی ماشینی نیاز دارید، --json/--out را به‌کار ببرید).
• برای تعامل‌ها، از openclaw browser click|type|hover|drag|select|upload|press|wait|navigate|back|evaluate|run استفاده کنید (click/type به ارجاع‌های snapshot نیاز دارند؛ برای گزینشگرهای CSS از evaluate استفاده کنید).

# مرتبط

• پوشهٔ کاری عامل
• زمان‌اجرای عامل