الانتقال إلى المحتوى الرئيسي

​
AGENTS.md - مساعد OpenClaw الشخصي (الافتراضي)

​
التشغيل الأول (مستحسن)

يستخدم OpenClaw دليل مساحة عمل مخصصًا للوكيل. الافتراضي: ~/.openclaw/workspace (يمكن ضبطه عبر agents.defaults.workspace).
  1. أنشئ مساحة العمل (إذا لم تكن موجودة بالفعل):
mkdir -p ~/.openclaw/workspace
  1. انسخ قوالب مساحة العمل الافتراضية إلى مساحة العمل:
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
  1. اختياري: إذا كنت تريد قائمة Skills الخاصة بالمساعد الشخصي، فاستبدل AGENTS.md بهذا الملف:
cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md
  1. اختياري: اختر مساحة عمل مختلفة عبر ضبط agents.defaults.workspace (يدعم ~):
{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
}

​
إعدادات السلامة الافتراضية

  • لا تفرغ الأدلة أو الأسرار داخل الدردشة.
  • لا تشغّل أوامر مدمرة إلا إذا طُلب منك ذلك صراحةً.
  • لا ترسل ردودًا جزئية/متدفقة إلى أسطح المراسلة الخارجية (الردود النهائية فقط).

​
بدء الجلسة (مطلوب)

  • اقرأ SOUL.md وUSER.md وملفي اليوم + الأمس في memory/.
  • اقرأ MEMORY.md عند وجوده؛ ولا تعد إلى memory.md بالأحرف الصغيرة إلا عندما يكون MEMORY.md غير موجود.
  • افعل ذلك قبل الرد.

​
الروح (مطلوب)

  • يحدد SOUL.md الهوية، والنبرة، والحدود. أبقه محدّثًا.
  • إذا غيّرت SOUL.md، فأخبر المستخدم.
  • أنت مثيل جديد في كل جلسة؛ والاستمرارية موجودة في هذه الملفات.

​
المساحات المشتركة (مستحسن)

  • أنت لست صوت المستخدم؛ كن حذرًا في دردشات المجموعات أو القنوات العامة.
  • لا تشارك البيانات الخاصة أو معلومات الاتصال أو الملاحظات الداخلية.

​
نظام الذاكرة (مستحسن)

  • السجل اليومي: memory/YYYY-MM-DD.md (أنشئ memory/ إذا لزم الأمر).
  • الذاكرة طويلة الأمد: MEMORY.md للحقائق والتفضيلات والقرارات الدائمة.
  • إن memory.md بالأحرف الصغيرة هو رجوع قديم فقط؛ لا تحتفظ بملفي الجذر معًا عمدًا.
  • عند بدء الجلسة، اقرأ اليوم + الأمس + MEMORY.md عند وجوده، وإلا memory.md.
  • التقط: القرارات، والتفضيلات، والقيود، والحلقات المفتوحة.
  • تجنب الأسرار ما لم يُطلب ذلك صراحةً.

​
الأدوات وSkills

  • تعيش الأدوات داخل Skills؛ اتبع 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

  • يشغّل بوابة WhatsApp + وكيل Pi البرمجي حتى يتمكن المساعد من قراءة/كتابة الدردشات، وجلب السياق، وتشغيل Skills عبر مضيف Mac.
  • يدير تطبيق macOS الأذونات (تسجيل الشاشة، والإشعارات، والميكروفون) ويكشف CLI الأمر openclaw عبر الملف التنفيذي المضمّن فيه.
  • تُدمج الدردشات المباشرة في جلسة main الخاصة بالوكيل افتراضيًا؛ وتبقى المجموعات معزولة على شكل agent:<agentId>:<channel>:group:<id> (الغرف/القنوات: agent:<agentId>:<channel>:channel:<id>); وتحافظ heartbeats على المهام الخلفية حيّة.

​
Skills الأساسية (فعّلها في Settings → Skills)

  • mcporter — وقت تشغيل/CLI لخادم الأدوات من أجل إدارة خلفيات Skills الخارجية.
  • Peekaboo — لقطات شاشة سريعة لـ macOS مع تحليل اختياري للرؤية بالذكاء الاصطناعي.
  • 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؛ فهو يخفي الزر إذا كان الملف التنفيذي موجودًا بالفعل.
  • أبقِ heartbeats مفعّلة حتى يتمكن المساعد من جدولة التذكيرات، ومراقبة صناديق الوارد، وتشغيل التقاطات الكاميرا.
  • تعمل واجهة Canvas بملء الشاشة مع طبقات أصلية. تجنب وضع عناصر التحكم الحرجة في الحواف العلوية اليسرى/اليمنى أو السفلية؛ أضف هوامش صريحة في التخطيط ولا تعتمد على safe-area insets.
  • بالنسبة إلى التحقق المعتمد على المتصفح، استخدم 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؛ واستخدم evaluate لمحددات CSS).