بناء مساعد شخصي مع OpenClaw

OpenClaw هو بوابة WhatsApp + Telegram + Discord + iMessage لوكلاء الذكاء الاصطناعي. هذا الدليل يشرح الإعداد الأساسي: رقم WhatsApp مخصص يتصرف كمساعدك الشخصي.

⚠️ الأمان أولاً

أنت تضع وكيلاً في موضع يسمح له بـ:

  • تشغيل أوامر على جهازك (حسب إعداد الأدوات)
  • قراءة/كتابة ملفات في مساحة العمل الخاصة بك
  • إرسال رسائل عبر WhatsApp/Telegram/Discord

ابدأ بحذر وقم بالتوسع تدريجيًا!

المتطلبات الأساسية

  • OpenClaw مثبت ومُعد — راجع البدء السريع إذا لم تفعل ذلك بعد
  • رقم هاتف ثانٍ (SIM/eSIM/prepaid) للمساعد

إعداد الهاتفين (موصى به)

التكوين المثالي:

هاتفك الشخصي          هاتف المساعد
┌─────────────────┐     ┌─────────────────┐
│  WhatsApp لك    │ ──▶ │  WhatsApp المساعد│
│  +1-555-YOU     │     │  +1-555-ASSIST  │
└─────────────────┘     └─────────────────┘

لماذا رقمان؟

إذا ربطت WhatsApp الشخصي بـ OpenClaw، كل رسالة إليك ستصبح "إدخال للوكيل". هذا نادرًا ما تريده. الرقم الثاني يحافظ على الفصل الواضح.

البدء السريع (5 دقائق)

1. ربط WhatsApp Web

عرض رمز QR والمسح بهاتف المساعد:

openclaw channels login

2. بدء Gateway

openclaw gateway start

3. اختبار الوكيل

أرسل رسالة من هاتفك الشخصي إلى رقم المساعد:

"مرحباً! من أنت؟"

مساحة عمل الوكيل (AGENTS)

يقرأ OpenClaw التعليمات والذاكرة من مجلد مساحة العمل. افتراضيًا، يستخدم ~/.openclaw/workspace وينشئ تلقائيًا الملفات التالية:

  • AGENTS.md — دليل التشغيل الرئيسي
  • SOUL.md — شخصية الوكيل
  • TOOLS.md — ملاحظات الأدوات المحلية
  • IDENTITY.md — هوية الوكيل
  • USER.md — معلومات عنك

نصيحة

عامل هذا المجلد كـ "ذاكرة" OpenClaw واجعله مستودع git (خاص بشكل مثالي) حتى يتم نسخ احتياطي لملفات AGENTS.md + الذاكرة. إذا كان git مثبتًا، يتم تهيئة مساحات العمل الجديدة تلقائيًا.

التكوين الذي يجعله "مساعداً"

الإعدادات الافتراضية لـ OpenClaw جيدة، لكنك عادة ما تريد ضبط:

  • الشخصية/التعليمات في SOUL.md
  • إعدادات التفكير الافتراضية (إذا رغبت)
  • النبضات القلبية (عندما تثق به)

الجلسات والذاكرة

  • ملفات الجلسة: ~/.openclaw/agents/<agentId>/sessions/{{SessionId}}.jsonl
  • بيانات الجلسة الوصفية: ~/.openclaw/agents/<agentId>/sessions/sessions.json

النبضات القلبية (الوضع الاستباقي)

افتراضيًا، يشغل OpenClaw نبضة قلبية كل 30 دقيقة. يمكن تعطيلها أو تخصيصها عبر ملف HEARTBEAT.md في مساحة العمل.

{
  agent: {
    heartbeat: {
      every: "30m"
    }
  }
}

الوسائط الواردة والصادرة

المرفقات الواردة (صور/صوت/مستندات) يمكن الوصول إليها عبر القوالب:

  • {{MediaPath}} — مسار ملف محلي مؤقت
  • {{MediaUrl}} — رابط وهمي
  • {{Transcript}} — إذا كان النسخ الصوتي مفعلاً

المرفقات الصادرة: ضع MEDIA:<path-or-url> على سطر منفصل.

قائمة مراجعة العمليات

openclaw status              # حالة محلية
openclaw status --all        # تشخيص كامل
openclaw status --deep       # مع فحوصات الصحة
openclaw logs                # عرض السجلات

الخطوات التالية