دليل إعداد OpenClaw
امنح Ami القدرة على التحكم في سطح المكتب.
المتطلبات
macOS مطلوب لأدوات Apple Notes والتذكيرات والتقويم والموسيقى.
Node.js 22+ — تحقق بـ node --version
إذا لم يكن لديك Node 22+:
brew install node@22تثبيت OpenClaw
شغّل سكربت التثبيت:
curl -fsSL https://openclaw.ai/install.sh | bashسيتم تثبيت CLI وبدء معالج الإعداد.
التحقق من التثبيت
openclaw doctoropenclaw غير موجود، أضفه إلى PATH:
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrcبدء البوابة
المعالج يثبت خدمة خلفية. للتحقق:
openclaw gateway statusللبدء يدوياً:
openclaw gateway --port 18789ابحث عن رمز البوابة
الرمز في ~/.openclaw/openclaw.json تحت gateway.auth.token. شاهده بـ:
cat ~/.openclaw/openclaw.json | grep '"token"' | head -1ربط Ami بـ OpenClaw
- افتح تطبيق Ami واذهب للإعدادات
- مرر للقسم المتقدم
- وسّع OpenClaw Gateway
- املأ الحقول:
| الحقل | القيمة |
|---|---|
| رابط البوابة | ws://127.0.0.1:18789 |
| رمز البوابة | (الصق رمز الخطوة 2) |
5. فعّل توجيه الدردشة عبر OpenClaw
6. اضغط حفظ
إعدادات اختيارية
| الإعداد | الوظيفة |
|---|---|
| مزامنة الهوية | يرسل اسم وشخصية Ami للبوابة |
| جلب الذكريات | يستورد الذكريات عند تحميل الشخصية |
| إرسال الذكريات | مزامنة تلقائية كل 10 دقائق |
إعداد مساحة العمل
OpenClaw يستخدم مجلد عمل. المسار الافتراضي: ~/.openclaw/workspace-ami/
يحتاج ملفين:
SOUL.md — الشخصية
يتزامن تلقائياً من التطبيق.
~/.openclaw/workspace-ami/SOUL.mdTOOLS.md — تعليمات الأدوات
دليل Ami لاستخدام macOS أدوات.
~/.openclaw/workspace-ami/TOOLS.mdالملف يحتوي osascript أوامر.
الأدوات المتاحة
بعد الاتصال، يمكنك طلب من Ami:
Apple Notes
“اكتب ملاحظة عن التسوق”
“احفظ ملاحظة خطط نهاية الأسبوع”
التذكيرات
“ذكرني بالاتصال بطبيب الأسنان الساعة 3”
“تذكير لسقي النباتات غداً”
التقويم
“ما جدولي اليوم؟”
“أضف اجتماع مع Jake يوم الجمعة”
الموسيقى
“شغّل موسيقى”
“أوقف الموسيقى”
“الأغنية التالية”
“ماذا يعمل الآن؟”
التحكم بالنظام
“الوضع الداكن”
“مؤقت 5 دقائق”
“مستوى البطارية؟”
فتح التطبيقات والروابط
“افتح Safari”
“افتح twitter.com”
استكشاف الأخطاء
تحديث OpenClaw
npm update -g openclawأو أعد تشغيل المثبت:
curl -fsSL https://openclaw.ai/install.sh | bashالبنية
للفضوليين — كيف يتواصل Ami مع سطح المكتب:
┌──────────────┐ WebSocket ┌──────────────────┐ osascript ┌──────────────┐
│ Ami App │ ──────────────────► │ OpenClaw Gateway │ ────────────────► │ macOS APIs │
│ (browser) │ ◄────────────────── │ (localhost) │ ◄──────────────── │ Notes, Music │
│ │ SSE streaming │ Port 18789 │ tool results │ Calendar etc │
└──────────────┘ └──────────────────┘ └──────────────┘
│
┌──────┴──────┐
│ Workspace │
│ SOUL.md │
│ TOOLS.md │
└─────────────┘1. ترسل رسالة لـ Ami في المتصفح
2. التطبيق يكتشف طلب الأداة ويعرض بطاقة
3. الرسالة توجّه عبر WebSocket لبوابة OpenClaw
4. العميل يقرأ TOOLS.md وينفذ أمر osascript
5. العميل يرد بالتأكيد وAmi يخبرك