---
read_when:
    - شروع یک نشست جدید عامل OpenClaw
    - فعال‌سازی یا ممیزی Skills پیش‌فرض
summary: دستورالعمل‌های پیش‌فرض عامل OpenClaw و فهرست Skills برای پیکربندی دستیار شخصی
title: AGENTS.md پیش‌فرض
x-i18n:
    generated_at: "2026-05-06T09:40:35Z"
    model: gpt-5.5
    provider: openai
    source_hash: 8ecfafd0bee8b18f5787a0b8e273ce281c40c7d2d5754f15daa1f2b7cc7ecad0
    source_path: reference/AGENTS.default.md
    workflow: 16
---

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

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

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

```bash
mkdir -p ~/.openclaw/workspace
```

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

```bash
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 را با این فایل جایگزین کنید:

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

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

```json5
{
  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` و فایل‌های حافظهٔ شما پشتیبان‌گیری شوند.

```bash
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` استفاده کنید).

## مرتبط

- [پوشهٔ کاری عامل](/fa/concepts/agent-workspace)
- [زمان‌اجرای عامل](/fa/concepts/agent)