إعداد المساعد الشخصي

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

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

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

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

​

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

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

​

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

​

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

1. اربط WhatsApp Web (يعرض رمز QR؛ امسحه بهاتف المساعد):

openclaw channels login

2. ابدأ تشغيل Gateway (اتركه يعمل):

openclaw gateway --port 18789

3. ضع تكوينًا بسيطًا في ~/.openclaw/openclaw.json:

{
  gateway: { mode: "local" },
  channels: { whatsapp: { allowFrom: ["+15555550123"] } },
}

​

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

openclaw setup

{
  agents: {
    defaults: {
      workspace: "~/.openclaw/workspace",
    },
  },
}

{
  agents: {
    defaults: {
      skipBootstrap: true,
    },
  },
}

​

التكوين الذي يحوله إلى “مساعد”

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

{
  logging: { level: "info" },
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      workspace: "~/.openclaw/workspace",
      thinkingDefault: "high",
      timeoutSeconds: 1800,
      // Start with 0; enable later.
      heartbeat: { every: "0m" },
    },
    list: [
      {
        id: "main",
        default: true,
        groupChat: {
          mentionPatterns: ["@openclaw", "openclaw"],
        },
      },
    ],
  },
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: {
        "*": { requireMention: true },
      },
    },
  },
  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). إذا أُرسل وحده، يقر OpenClaw بإعادة الضبط دون استدعاء النموذج.
• يضغط /compact [instructions] سياق الجلسة ويبلغ عن ميزانية السياق المتبقية.

​

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

• إذا كان HEARTBEAT.md موجودًا لكنه فارغ فعليًا (لا يحتوي إلا على أسطر فارغة وعناوين markdown مثل # Heading)، يتخطى OpenClaw تشغيل Heartbeat لتوفير استدعاءات API.
• إذا كان الملف مفقودًا، فستظل Heartbeat تعمل ويقرر النموذج ما يجب فعله.
• إذا رد الوكيل بـ HEARTBEAT_OK (اختياريًا مع حشو قصير؛ راجع agents.defaults.heartbeat.ackMaxChars)، يمنع OpenClaw التسليم الصادر لتلك Heartbeat.
• افتراضيًا، يُسمح بتسليم Heartbeat إلى أهداف DM بنمط user:<id>. اضبط agents.defaults.heartbeat.directPolicy: "block" لمنع التسليم إلى الأهداف المباشرة مع إبقاء تشغيل Heartbeats نشطًا.
• تشغّل Heartbeats دورات وكيل كاملة - الفواصل الأقصر تستهلك رموزًا أكثر.

{
  agents: {
    defaults: {
      heartbeat: { every: "30m" },
    },
  },
}

​

الوسائط دخولًا وخروجًا

• {{MediaPath}} (مسار ملف محلي مؤقت)
• {{MediaUrl}} (عنوان URL زائف)
• {{Transcript}} (إذا كان نسخ الصوت مفعّلًا)

إليك لقطة الشاشة.
MEDIA:https://example.com/screenshot.png

• إذا كان tools.fs.workspaceOnly يساوي true، تبقى مسارات MEDIA: المحلية الصادرة مقيدة بجذر OpenClaw المؤقت، وذاكرة الوسائط المؤقتة، ومسارات مساحة عمل الوكيل، والملفات المولدة داخل sandbox.
• إذا كان tools.fs.workspaceOnly يساوي false، فيمكن لـ MEDIA: الصادرة استخدام ملفات محلية على المضيف يُسمح للوكيل أصلًا بقراءتها.
• يمكن أن تكون المسارات المحلية مطلقة، أو نسبية إلى مساحة العمل، أو نسبية إلى الدليل الرئيسي باستخدام ~/.
• لا تزال الإرسالات المحلية من المضيف تسمح فقط بالوسائط وأنواع المستندات الآمنة (الصور، والصوت، والفيديو، وPDF، ومستندات Office). لا تُعامل الملفات النصية العادية والملفات التي تبدو كأسرار كوسائط قابلة للإرسال.

​

قائمة تحقق العمليات

openclaw status          # local status (creds, sessions, queued events)
openclaw status --all    # full diagnosis (read-only, pasteable)
openclaw status --deep   # asks the gateway for a live health probe with channel probes when supported
openclaw health --json   # gateway health snapshot (WS; default can return a fresh cached snapshot)

​

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

• WebChat: WebChat
• عمليات Gateway: دليل تشغيل Gateway
• Cron + التنبيهات: مهام Cron
• رفيق شريط قوائم macOS: تطبيق OpenClaw macOS
• تطبيق عقدة iOS: تطبيق iOS
• تطبيق عقدة Android: تطبيق Android
• حالة Windows: Windows (WSL2)
• حالة Linux: تطبيق Linux
• الأمان: الأمان

​

ذات صلة

• بدء الاستخدام
• الإعداد
• نظرة عامة على القنوات