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

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

OpenClaw هو Gateway لـ WhatsApp + Telegram + Discord + iMessage لوكلاء Pi. تضيف الإضافات Mattermost. يوضح هذا الدليل إعداد «المساعد الشخصي»: رقم WhatsApp مخصص واحد يتصرف كوكيلك الدائم التشغيل.

​
⚠️ السلامة أولاً

أنت تضع وكيلا في وضع ما يلي:
  • تشغيل أوامر على جهازك (اعتمادًا على إعداد أداة Pi لديك)
  • قراءة/كتابة الملفات داخل مساحة عملك
  • إرسال رسائل للخارج عبر WhatsApp/Telegram/Discord/Mattermost (إضافة)
ابدأ بتحفظ:
  • اضبط دائمًا channels.whatsapp.allowFrom (لا تشغّل مفتوحًا على العالم على جهاز Mac الشخصي).
  • استخدم رقم WhatsApp مخصصًا للمساعد.
  • أصبحت نبضات القلب افتراضيًا كل 30 دقيقة. عطّلها حتى تثق بالإعداد عبر تعيين agents.defaults.heartbeat.every: "0m".

​
المتطلبات المسبقة

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

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

هذا ما تريده: إذا ربطت WhatsApp الشخصي بـ OpenClaw، فكل رسالة تصلك تصبح «مدخلات للوكيل». نادرًا ما يكون هذا ما تريده.

​
بدء سريع خلال 5 دقائق

  1. إقران WhatsApp Web (يعرض رمز QR؛ امسحه بهاتف المساعد):
openclaw channels login
  1. تشغيل Gateway (اتركه قيد التشغيل):
openclaw gateway --port 18789
  1. ضع تهيئة بسيطة في ~/.openclaw/openclaw.json:
{
  channels: { whatsapp: { allowFrom: ["+15555550123"] } },
}
الآن أرسل رسالة إلى رقم المساعد من هاتفك المدرج في قائمة السماح. عند انتهاء التهيئة الأولية، نفتح لوحة التحكم تلقائيًا ونطبع رابطًا نظيفًا (غير مُرمَّز). إذا طلب المصادقة، الصق الرمز من gateway.auth.token ضمن إعدادات واجهة التحكم. لإعادة الفتح لاحقًا: openclaw dashboard.

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

يقرأ OpenClaw تعليمات التشغيل و«الذاكرة» من دليل مساحة العمل الخاص به. افتراضيًا، يستخدم OpenClaw ~/.openclaw/workspace كمساحة عمل للوكيل، وسيُنشئه (إضافةً إلى ملفات البداية AGENTS.md وSOUL.md وTOOLS.md وIDENTITY.md وUSER.md وHEARTBEAT.md) تلقائيًا عند الإعداد/تشغيل الوكيل لأول مرة. يتم إنشاء BOOTSTRAP.md فقط عندما تكون مساحة العمل جديدة تمامًا (ولا ينبغي أن تعود بعد حذفها). الملف MEMORY.md اختياري (لا يُنشأ تلقائيًا)؛ وعند وجوده يتم تحميله للجلسات العادية. جلسات الوكلاء الفرعيين تحقن فقط AGENTS.md وTOOLS.md. نصيحة: تعامل مع هذا المجلد على أنه «ذاكرة» OpenClaw واجعله مستودع git (ويُفضّل أن يكون خاصًا) كي تُحفظ ملفات AGENTS.md + الذاكرة احتياطيًا. إذا كان git مثبتًا، تُهيَّأ مساحات العمل الجديدة تلقائيًا. 
openclaw setup
مخطط مساحة العمل الكامل + دليل النسخ الاحتياطي: مساحة عمل الوكيل سير عمل الذاكرة: الذاكرة اختياري: اختر مساحة عمل مختلفة باستخدام agents.defaults.workspace (يدعم ~). 
{
  agent: {
    workspace: "~/.openclaw/workspace",
  },
}
إذا كنت تشحن بالفعل ملفات مساحة عملك من مستودع، يمكنك تعطيل إنشاء ملفات الإقلاع بالكامل: 
{
  agent: {
    skipBootstrap: true,
  },
}

​
التهيئة التي تحوله إلى «مساعد»

يأتي OpenClaw افتراضيًا بإعداد مساعد جيد، لكنك غالبًا سترغب في الضبط:
  • الشخصية/التعليمات في SOUL.md
  • افتراضات التفكير (إن رغبت)
  • نبضات القلب (بعد أن تثق به)
مثال: 
{
  logging: { level: "info" },
  agent: {
    model: "anthropic/claude-opus-4-6",
    workspace: "~/.openclaw/workspace",
    thinkingDefault: "high",
    timeoutSeconds: 1800,
    // Start with 0; enable later.
    heartbeat: { every: "0m" },
  },
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: {
        "*": { requireMention: true },
      },
    },
  },
  routing: {
    groupChat: {
      mentionPatterns: ["@openclaw", "openclaw"],
    },
  },
  session: {
    scope: "per-sender",
    resetTriggers: ["/new", "/reset"],
    reset: {
      mode: "daily",
      atHour: 4,
      idleMinutes: 10080,
    },
  },
}

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

  • ملفات الجلسة: ~/.openclaw/agents/<agentId>/sessions/{{SessionId}}.jsonl
  • بيانات الجلسة الوصفية (استخدام الرموز، آخر مسار، إلخ): ~/.openclaw/agents/<agentId>/sessions/sessions.json (قديم: ~/.openclaw/sessions/sessions.json)
  • يبدئ /new أو /reset جلسة جديدة لتلك الدردشة (قابل للضبط عبر resetTriggers). إذا أُرسل وحده، يرد الوكيل بتحية قصيرة لتأكيد إعادة الضبط.
  • يقوم /compact [instructions] بضغط سياق الجلسة ويُبلغ عن ميزانية السياق المتبقية.

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

افتراضيًا، يشغّل OpenClaw نبضة قلب كل 30 دقيقة مع الموجه: Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK. اضبط agents.defaults.heartbeat.every: "0m" للتعطيل.
  • إذا كان HEARTBEAT.md موجودًا لكنه فارغ فعليًا (أسطر فارغة فقط وعناوين markdown مثل # Heading)، يتخطّى OpenClaw تشغيل نبضة القلب لتوفير استدعاءات API.
  • إذا كان الملف مفقودًا، تستمر نبضة القلب ويقرر النموذج ما يفعل.
  • إذا ردّ الوكيل بـ HEARTBEAT_OK (اختياريًا مع حشو قصير؛ انظر agents.defaults.heartbeat.ackMaxChars)، يكبح OpenClaw التسليم الصادر لتلك النبضة.
  • تشتغل ضربات القلب بدلات العامل الكاملة- ففترات أقصر تحرق المزيد من الرموز.
{
  agent: {
    heartbeat: { every: "30m" },
  },
}

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

يمكن إظهار المرفقات الواردة (صور/صوت/مستندات) لأمرك عبر القوالب:
  • {{MediaPath}} (مسار ملف مؤقت محلي)
  • {{MediaUrl}} (عنوان شبه URL)
  • {{Transcript}} (إذا كان تفريغ الصوت مُفعّلًا)
المرفقات الصادرة من الوكيل: أدرج MEDIA:<path-or-url> في سطر مستقل (من دون مسافات). مثال: 
Here’s the screenshot.
MEDIA:https://example.com/screenshot.png
يستخرج OpenClaw هذه ويرسلها كوسائط إلى جانب النص.

​
قائمة تدقيق التشغيل

openclaw status          # local status (creds, sessions, queued events)
openclaw status --all    # full diagnosis (read-only, pasteable)
openclaw status --deep   # adds gateway health probes (Telegram + Discord)
openclaw health --json   # gateway health snapshot (WS)
توجد السجلات ضمن /tmp/openclaw/ (الافتراضي: openclaw-YYYY-MM-DD.log).

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