Skip to content

تعاون متعدد الوكلاء: بوابة واحدة تشغّل عدة خبراء ​

تتيح بنية OpenClaw متعددة الوكلاء تشغيل عدة وكلاء معزولين عن بعضها داخل عملية Gateway واحدة: لكل agent مساحة عمله الخاصة ودليل حالته (agentDir) وسجل جلسات مبني على SQLite، ويمكنه أيضًا حمل عدة حسابات قنوات في آنٍ واحد (مثل رقمي WhatsApp). تُوجَّه الرسائل الواردة إلى الـ agent الصحيح عبر binding.

السيناريوهات المناسبة ​

  • تريد «Claw للعمل» و«Claw للحياة»، بحيث لا يتداخل persona والذاكرة وبيانات الاعتماد بينهما.
  • لديك عدة حسابات من نفس نوع القناة — رقما WhatsApp، أو مساحتا عمل على Slack — وتريد ربط خبير بكل منها.
  • فريق يتشارك عملية نشر واحدة، مع agent مخصص لكل عضو أو خط أعمال.

لنوضح المفاهيم أولًا: هذه الصفحة تتحدث عن تعدد الوكلاء عبر التوجيه حسب حساب القناة. يحتوي المستودع على وثائق منفصلة لأدوات subagents وagent-send، وهي تمثل طريقة تعاون أخرى بين الوكلاء.

التحضيرات ​

  • اقرأ سيناريوهات عملية: اختر مسارك، وتأكد أن تعدد الوكلاء هو المسار الذي تريده.
  • لديك Gateway يعمل بالفعل — لا يحتاج تعدد الوكلاء إلى عملية ثانية.
  • حدد تقسيم الأدوار بوضوح: أي حساب قناة يتبع أي agent، واكتب قواعد persona لكل خبير في AGENTS.md/SOUL.md الخاص به.

اتبع معي: ثلاث خطوات لتشغيل عدة خبراء ​

الخطوة 1: أنشئ عدة وكلاء خبراء باستخدام openclaw agents add ​

لماذا تنشئ agent منفصلًا لكل خبير؟ لأن الـ agent الواحد هو نطاق persona كامل بذاته، ويأتي معه ثلاثة أشياء:

  • مساحة عمل: الملفات وAGENTS.md/SOUL.md/USER.md والملاحظات المحلية وقواعد persona.
  • دليل الحالة agentDir: ملفات auth profiles وسجل النماذج وإعدادات كل agent، ويكون افتراضيًا في ~/.openclaw/agents/<agentId>/agent.
  • قاعدة الجلسات: سجل المحادثات وحالة التوجيه، تُخزَّن في <agentDir>/openclaw-agent.sqlite، أي ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite في التخطيط الافتراضي.

شغّل agents add مرة واحدة لكل خبير — ينشئ المثال «Claw للحياة» و«Claw للعمل»:

bash
openclaw agents add home
openclaw agents add work

العلامات الشائعة: --role <role> (تطبيق قالب الدور)، --workspace <dir>، --model <id>، --agent-dir <dir>، --bind <channel[:accountId]> (قابلة للتكرار، وتُنشئ الـ binding تلقائيًا أثناء الإنشاء)؛ --non-interactive يجب أن يُقترن بـ --workspace، إلا إذا حددت --role.

ستلاحظ: كل agent يحصل على مساحة عمله الخاصة (بما فيها SOUL.md وAGENTS.md، واختياريًا USER.md)، وعلى agentDir وقاعدة جلسات مستقلتين، وتقع ملفات الـ agent افتراضيًا تحت ~/.openclaw/agents/<agentId>. سيسألك معالج الإنشاء أيضًا إن كنت تريد إضافة binding الآن — يمكنك تخطيه وكتابته يدويًا في الخطوة التالية.

الخطوة 2: اربط حسابات القنوات بالـ agent المقابل باستخدام binding ​

binding يحدد فقط «أي agent تتبع هذه الرسالة» — فهو لا ينشئ حسابات قنوات ولا يمنح صلاحيات وصول، لذا اضبط الحساب أولًا ثم اربطه. يمكن لـ Gateway واحد حمل عدة حسابات، مثل ربط رقمي WhatsApp بخبيرين على التوالي.

جهّز أولًا حساب قناة لكل agent:

bash
openclaw channels login --channel whatsapp --account personal
openclaw channels login --channel whatsapp --account biz

ثم في ~/.openclaw/openclaw.json (JSON5) اربط الـ agent بالحساب: agents.entries يسرد الوكلاء، وbindings يعلن التوجيه.

json5
{
  agents: {
    entries: {
      home: {
        workspace: "~/.openclaw/workspace-home",
        agentDir: "~/.openclaw/agents/home/agent",
      },
      work: {
        workspace: "~/.openclaw/workspace-work",
        agentDir: "~/.openclaw/agents/work/agent",
      },
    },
  },
  // 固定路由顺序:先匹配的赢,窄规则写在宽规则前面。
  bindings: [
    { agentId: "home", match: { channel: "whatsapp", accountId: "personal" } },
    { agentId: "work", match: { channel: "whatsapp", accountId: "biz" } },
  ],
}

الفرق بين binding على مستوى الحساب وعلى مستوى الجلسة، اختر حسب الحاجة:

  • على مستوى الحساب: اكتب channel + accountId فقط، فتتبع كل رسائل الحساب هذا الـ agent. accountId: "*" هو الاحتياطي على مستوى القناة؛ وحذف accountId يطابق الحساب الافتراضي لتلك القناة فقط.
  • على مستوى الجلسة: أضف match.peer (تأخذ kind قيمة direct/group/channel، باستخدام معرّف peer الثابت للقناة، وليس الاسم المعروض)، لتوجيه محادثة واحدة فقط إلى الخبير.
  • الأولوية: مطابقة الجلسة المحددة أو المجموعة تتغلب على مستوى الحساب والاحتياطي على مستوى القناة؛ وضمن المستوى نفسه تكون الأولوية لمن يأتي أولًا حسب ترتيب الإعداد.

ستلاحظ: تغييرات binding الصحيحة تدخل حيز التنفيذ تلقائيًا في وضع إعادة التحميل الساخن الافتراضي hybrid؛ أما إذا كانت gateway.reload.mode بقيمة off، فيجب إعادة تشغيل Gateway لتصبح سارية. الـ binding الذي يشير إلى حساب لا تقبل القناة إطلاقًا لن يعمل.

الخطوة 3: أرسل رسائل للتحقق من التوجيه والعزل ​

كتابة الإعدادات لا تعني صحة التوجيه — تحقق أولًا من قائمة الوكلاء والروابط بالأوامر، ثم اختبر كلًا منها برسالة حقيقية:

bash
openclaw agents list --bindings
openclaw channels status --probe

ثم أرسل رسالة من كل حساب مرتبط للتأكد من ثلاثة أمور: أن الرسالة دخلت إلى الـ agent الصحيح؛ أن سجل الجلسات مستقل لكل واحد؛ أن قواعد persona سارية لكل واحد على حدة.

ستلاحظ: agents list --bindings يسرد قائمة الوكلاء وعلاقات الربط «حساب القناة → agent»، وchannels status --probe يعرض حالة اتصال كل حساب. إذا لم تتطابق أي binding ولم يكن هناك انتماء افتراضي متاح، سيرمي التوجيه الخطأ AGENT_SELECTION_REQUIRED لتنبيهك إلى إضافة binding. عندما تنجح الأمور الثلاثة، يصبح خبراؤك المتعددون جاهزين في مكانهم داخل الـ Gateway نفسه.

نقاط التحقق ​

  • لا تُعد استخدام agentDir أبدًا. توجيه agentين إلى الدليل نفسه يسبب تعارضًا في حالة auth والجلسات.
  • سلوك وراثة OAuth: عندما تنتهي صلاحية بيانات اعتماد OAuth المحلية للـ agent الثانوي أو يفشل تحديثها، سيقرأ OpenClaw بيانات اعتماد نفس الـ profile من الـ agent الرئيسي الموروث ويعتمد الرمز الأحدث، دون نسخ refresh token إلى تخزين الـ agent الثانوي. للحصول على حسابات OAuth مستقلة تمامًا، سجّل الدخول مرة واحدة من ذلك الـ agent نفسه.
  • النسخ اليدوي لبيانات الاعتماد ينسخ العناصر الثابتة فقط: يمكن نسخ الـ profiles من نوع api_key/token؛ أما مواد تحديث OAuth فغير قابلة للنقل افتراضيًا، إلا إذا اخترتها صراحةً باستخدام copyToAgents.
  • التحميل المزدوج للـ Skills: كل agent يحمّل الـ Skills من مساحة عمله الخاصة، ويقرأ أيضًا من الجذر المشترك (مثل ~/.openclaw/skills).

حدود ​

  • تعمل عدة وكلاء (agents) لا تزال داخل نفس عملية الـ Gateway، لذا يبقى حد الثقة كما هو؛ والنموذج وواجهة تشغيل الوكيل (agent harness) كلاهما إضافات قابلة للاستبدال.
  • تُحدَّد قدرات القنوات وفق الإضافات: إضافة WeChat تدعم المحادثات الخاصة فقط ولا تدعم المحادثات الجماعية، لذا لا تحسب «ربط مجموعة WeChat» ضمن الخطة.
  • ما يوفره سجل المحادثات هو استرجاعمحدودعبر الجلسات، وليس ذاكرة غير محدودة.

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

gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.