AGENTS.md پیش‌فرض

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

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

1. workspace را ایجاد کنید (اگر از قبل وجود ندارد):

mkdir -p ~/.openclaw/workspace

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

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. اختیاری: اگر فهرست Skills دستیار شخصی را می‌خواهید، AGENTS.md را با این فایل جایگزین کنید:

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

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

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

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

• پوشه‌ها یا اسرار را در چت تخلیه نکنید.
• فرمان‌های مخرب را اجرا نکنید مگر اینکه صریحاً خواسته شده باشد.
• پیش از تغییر پیکربندی یا زمان‌بندها (برای مثال crontab، واحدهای systemd، پیکربندی‌های nginx، یا فایل‌های shell rc)، ابتدا وضعیت موجود را بررسی کنید و به‌صورت پیش‌فرض آن را حفظ/ادغام کنید.
• پاسخ‌های ناقص/جریانی را به سطوح پیام‌رسانی خارجی نفرستید (فقط پاسخ‌های نهایی).

پیش‌بررسی راهکارهای موجود

پیش از پیشنهاد یا ساخت یک سیستم، قابلیت، workflow، ابزار، یکپارچه‌سازی، یا automation سفارشی، یک بررسی کوتاه برای پروژه‌های متن‌باز، کتابخانه‌های نگهداری‌شده، Pluginهای موجود OpenClaw، یا پلتفرم‌های رایگانی انجام دهید که همین کار را به‌اندازهٔ کافی خوب حل می‌کنند. وقتی کافی هستند، آن‌ها را ترجیح دهید. فقط وقتی سفارشی بسازید که گزینه‌های موجود نامناسب، بیش از حد گران، نگهداری‌نشده، ناامن، ناسازگار با الزامات، یا کاربر صریحاً سفارشی خواسته باشد. از توصیهٔ سرویس‌های پولی خودداری کنید مگر اینکه کاربر صریحاً هزینه را تأیید کند. این را سبک نگه دارید: یک دروازهٔ پیش‌بررسی، نه یک مأموریت پژوهشی گسترده.

شروع جلسه (الزامی)

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

Soul (الزامی)

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

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

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

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

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

ابزارها و Skills

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

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

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

cd ~/.openclaw/workspacegit initgit add AGENTS.mdgit commit -m "Add Clawd workspace"# Optional: add a private remote + push

OpenClaw چه می‌کند

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

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

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

نکات استفاده

• برای اسکریپت‌نویسی، CLI openclaw را ترجیح دهید؛ برنامهٔ mac مجوزها را مدیریت می‌کند.
• نصب‌ها را از تب Skills اجرا کنید؛ اگر یک binary از قبل وجود داشته باشد، دکمه را پنهان می‌کند.
• Heartbeatها را فعال نگه دارید تا دستیار بتواند یادآورها را زمان‌بندی کند، inboxها را پایش کند، و ضبط‌های دوربین را trigger کند.
• Canvas UI تمام‌صفحه با overlayهای بومی اجرا می‌شود. از قرار دادن کنترل‌های حیاتی در گوشهٔ بالا-چپ/بالا-راست/لبه‌های پایین خودداری کنید؛ gutterهای صریح در layout اضافه کنید و به safe-area insetها تکیه نکنید.
• برای راستی‌آزمایی مبتنی بر مرورگر، از openclaw browser (tabs/status/screenshot) با پروفایل 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 refها نیاز دارند؛ برای selectorهای CSS از evaluate استفاده کنید).

مرتبط

• Workspace عامل
• Runtime عامل