توجيه متعدد الوكلاء

شغّل عدة وكلاء معزولين، لكل واحد مساحة عمل خاصة به، ودليل حالة (agentDir)، وسجل جلسات، إلى جانب عدة حسابات قنوات (مثل حسابي WhatsApp) ضمن Gateway واحد قيد التشغيل. تُوجَّه الرسائل الواردة إلى الوكيل الصحيح عبر الارتباطات.

الوكيل هنا هو النطاق الكامل لكل شخصية: ملفات مساحة العمل، وملفات تعريف المصادقة، وسجل النماذج، ومخزن الجلسات. agentDir هو دليل الحالة على القرص الذي يحتوي على هذا الإعداد الخاص بكل وكيل في ~/.openclaw/agents/<agentId>/. أما الارتباط فيربط حساب قناة (مثل مساحة عمل Slack أو رقم WhatsApp) بأحد هؤلاء الوكلاء.

ما هو "الوكيل الواحد"؟

الوكيل هو عقل محدد النطاق بالكامل وله ما يلي:

• مساحة العمل (الملفات، وAGENTS.md/SOUL.md/USER.md، والملاحظات المحلية، وقواعد الشخصية).
• دليل الحالة (agentDir) لملفات تعريف المصادقة، وسجل النماذج، وإعدادات كل وكيل.
• مخزن الجلسات (سجل المحادثات + حالة التوجيه) ضمن ~/.openclaw/agents/<agentId>/sessions.

ملفات تعريف المصادقة تكون لكل وكيل. يقرأ كل وكيل من ملفه الخاص:

~/.openclaw/agents/<agentId>/agent/auth-profiles.json

تُحمَّل Skills من مساحة عمل كل وكيل إضافة إلى الجذور المشتركة مثل ~/.openclaw/skills، ثم تُصفّى بحسب قائمة Skills المسموح بها للوكيل الفعّال عند إعدادها. استخدم agents.defaults.skills كأساس مشترك وagents.list[].skills للاستبدال لكل وكيل. راجع Skills: لكل وكيل مقابل المشتركة وSkills: قوائم السماح بمهارات الوكيل.

يمكن لـ Gateway استضافة وكيل واحد (افتراضيا) أو عدة وكلاء جنبا إلى جنب.

المسارات (خريطة سريعة)

• الإعداد: ~/.openclaw/openclaw.json (أو OPENCLAW_CONFIG_PATH)
• دليل الحالة: ~/.openclaw (أو OPENCLAW_STATE_DIR)
• مساحة العمل: ~/.openclaw/workspace (أو ~/.openclaw/workspace-<agentId>)
• دليل الوكيل: ~/.openclaw/agents/<agentId>/agent (أو agents.list[].agentDir)
• الجلسات: ~/.openclaw/agents/<agentId>/sessions

وضع الوكيل الواحد (افتراضي)

إذا لم تفعل شيئا، يشغّل OpenClaw وكيلا واحدا:

• تكون قيمة agentId الافتراضية هي main.
• تُفهرس الجلسات بصيغة agent:main:<mainKey>.
• تكون مساحة العمل الافتراضية ~/.openclaw/workspace (أو ~/.openclaw/workspace-<profile> عند ضبط OPENCLAW_PROFILE).
• تكون الحالة الافتراضية ~/.openclaw/agents/main/agent.

مساعد الوكلاء

استخدم معالج الوكلاء لإضافة وكيل معزول جديد:

openclaw agents add work

ثم أضف bindings (أو دع المعالج يفعل ذلك) لتوجيه الرسائل الواردة.

تحقق باستخدام:

openclaw agents list --bindings

بدء سريع

openclaw agents add codingopenclaw agents add social

openclaw channels login --channel whatsapp --account work

openclaw gateway restartopenclaw agents list --bindingsopenclaw channels status --probe

عدة وكلاء = عدة أشخاص، عدة شخصيات

مع عدة وكلاء، يصبح كل agentId شخصية معزولة بالكامل:

• أرقام هواتف/حسابات مختلفة (لكل قناة accountId).
• شخصيات مختلفة (ملفات مساحة عمل لكل وكيل مثل AGENTS.md وSOUL.md).
• مصادقة + جلسات منفصلة (لا تداخل إلا إذا فُعّل صراحة).

يتيح ذلك لـ عدة أشخاص مشاركة خادم Gateway واحد مع إبقاء "عقول" الذكاء الاصطناعي وبياناتهم معزولة.

بحث ذاكرة QMD عبر الوكلاء

إذا كان على وكيل البحث في نصوص جلسات QMD لوكيل آخر، فأضف مجموعات إضافية ضمن agents.list[].memorySearch.qmd.extraCollections. استخدم agents.defaults.memorySearch.qmd.extraCollections فقط عندما يجب أن يرث كل وكيل مجموعات النصوص المشتركة نفسها.

{  agents: {    defaults: {      workspace: "~/workspaces/main",      memorySearch: {        qmd: {          extraCollections: [{ path: "~/agents/family/sessions", name: "family-sessions" }],        },      },    },    list: [      {        id: "main",        workspace: "~/workspaces/main",        memorySearch: {          qmd: {            extraCollections: [{ path: "notes" }], // resolves inside workspace -> collection named "notes-main"          },        },      },      { id: "family", workspace: "~/workspaces/family" },    ],  },  memory: {    backend: "qmd",    qmd: { includeDefaultMemory: false },  },}

يمكن مشاركة مسار المجموعة الإضافية عبر الوكلاء، لكن اسم المجموعة يبقى صريحا عندما يكون المسار خارج مساحة عمل الوكيل. تبقى المسارات داخل مساحة العمل محددة النطاق للوكيل بحيث يحتفظ كل وكيل بمجموعة بحث النصوص الخاصة به.

رقم WhatsApp واحد، عدة أشخاص (تقسيم الرسائل المباشرة)

يمكنك توجيه رسائل WhatsApp المباشرة المختلفة إلى وكلاء مختلفين مع البقاء على حساب WhatsApp واحد. طابق حسب مرسل E.164 (مثل +15551234567) باستخدام peer.kind: "direct". لا تزال الردود تأتي من رقم WhatsApp نفسه (لا توجد هوية مرسل لكل وكيل).

مثال:

{  agents: {    list: [      { id: "alex", workspace: "~/.openclaw/workspace-alex" },      { id: "mia", workspace: "~/.openclaw/workspace-mia" },    ],  },  bindings: [    {      agentId: "alex",      match: { channel: "whatsapp", peer: { kind: "direct", id: "+15551230001" } },    },    {      agentId: "mia",      match: { channel: "whatsapp", peer: { kind: "direct", id: "+15551230002" } },    },  ],  channels: {    whatsapp: {      dmPolicy: "allowlist",      allowFrom: ["+15551230001", "+15551230002"],    },  },}

ملاحظات:

• التحكم في وصول الرسائل المباشرة عام لكل حساب WhatsApp (الاقتران/قائمة السماح)، وليس لكل وكيل.
• للمجموعات المشتركة، اربط المجموعة بوكيل واحد أو استخدم مجموعات البث.

قواعد التوجيه (كيف تختار الرسائل وكيلا)

الارتباطات حتمية والأكثر تحديدا يفوز:

عدة حسابات / أرقام هواتف

تستخدم القنوات التي تدعم عدة حسابات (مثل WhatsApp) accountId لتحديد كل تسجيل دخول. يمكن توجيه كل accountId إلى وكيل مختلف، وبذلك يمكن لخادم واحد استضافة عدة أرقام هواتف دون خلط الجلسات.

إذا أردت حسابا افتراضيا على مستوى القناة عندما يُحذف accountId، فاضبط channels.<channel>.defaultAccount (اختياري). عند عدم ضبطه، يرجع OpenClaw إلى default إذا كان موجودا، وإلا إلى أول معرّف حساب مضبوط (مرتبا).

تشمل القنوات الشائعة التي تدعم هذا النمط:

• whatsapp, telegram, discord, slack, signal, imessage
• irc, line, googlechat, mattermost, matrix, nextcloud-talk
• zalo, zalouser, nostr, feishu

المفاهيم

• agentId: "عقل" واحد (مساحة عمل، ومصادقة لكل وكيل، ومخزن جلسات لكل وكيل).
• accountId: مثيل حساب قناة واحد (مثل حساب WhatsApp "personal" مقابل "biz").
• binding: يوجّه الرسائل الواردة إلى agentId عبر (channel, accountId, peer) ومعرّفات guild/team اختياريا.
• تنهار المحادثات المباشرة إلى agent:<agentId>:<mainKey> ("الرئيسية" لكل وكيل؛ session.mainKey).

أمثلة المنصات

{  agents: {    list: [      { id: "main", workspace: "~/.openclaw/workspace-main" },      { id: "coding", workspace: "~/.openclaw/workspace-coding" },    ],  },  bindings: [    { agentId: "main", match: { channel: "discord", accountId: "default" } },    { agentId: "coding", match: { channel: "discord", accountId: "coding" } },  ],  channels: {    discord: {      groupPolicy: "allowlist",      accounts: {        default: {          token: "DISCORD_BOT_TOKEN_MAIN",          guilds: {            "123456789012345678": {              channels: {                "222222222222222222": { allow: true, requireMention: false },              },            },          },        },        coding: {          token: "DISCORD_BOT_TOKEN_CODING",          guilds: {            "123456789012345678": {              channels: {                "333333333333333333": { allow: true, requireMention: false },              },            },          },        },      },    },  },}

{  agents: {    list: [      { id: "main", workspace: "~/.openclaw/workspace-main" },      { id: "alerts", workspace: "~/.openclaw/workspace-alerts" },    ],  },  bindings: [    { agentId: "main", match: { channel: "telegram", accountId: "default" } },    { agentId: "alerts", match: { channel: "telegram", accountId: "alerts" } },  ],  channels: {    telegram: {      accounts: {        default: {          botToken: "123456:ABC...",          dmPolicy: "pairing",        },        alerts: {          botToken: "987654:XYZ...",          dmPolicy: "allowlist",          allowFrom: ["tg:123456789"],        },      },    },  },}

openclaw channels login --channel whatsapp --account personalopenclaw channels login --channel whatsapp --account biz

{  agents: {    list: [      {        id: "home",        default: true,        name: "Home",        workspace: "~/.openclaw/workspace-home",        agentDir: "~/.openclaw/agents/home/agent",      },      {        id: "work",        name: "Work",        workspace: "~/.openclaw/workspace-work",        agentDir: "~/.openclaw/agents/work/agent",      },    ],  },   // Deterministic routing: first match wins (most-specific first).  bindings: [    { agentId: "home", match: { channel: "whatsapp", accountId: "personal" } },    { agentId: "work", match: { channel: "whatsapp", accountId: "biz" } },     // Optional per-peer override (example: send a specific group to work agent).    {      agentId: "work",      match: {        channel: "whatsapp",        accountId: "personal",        peer: { kind: "group", id: "1203630...@g.us" },      },    },  ],   // Off by default: agent-to-agent messaging must be explicitly enabled + allowlisted.  tools: {    agentToAgent: {      enabled: false,      allow: ["home", "work"],    },  },   channels: {    whatsapp: {      accounts: {        personal: {          // Optional override. Default: ~/.openclaw/credentials/whatsapp/personal          // authDir: "~/.openclaw/credentials/whatsapp/personal",        },        biz: {          // Optional override. Default: ~/.openclaw/credentials/whatsapp/biz          // authDir: "~/.openclaw/credentials/whatsapp/biz",        },      },    },  },}

الأنماط الشائعة

{  agents: {    list: [      {        id: "chat",        name: "Everyday",        workspace: "~/.openclaw/workspace-chat",        model: "anthropic/claude-sonnet-4-6",      },      {        id: "opus",        name: "Deep Work",        workspace: "~/.openclaw/workspace-opus",        model: "anthropic/claude-opus-4-6",      },    ],  },  bindings: [    { agentId: "chat", match: { channel: "whatsapp", accountId: "*" } },    { agentId: "opus", match: { channel: "telegram", accountId: "*" } },  ],}

{  agents: {    list: [      {        id: "chat",        name: "Everyday",        workspace: "~/.openclaw/workspace-chat",        model: "anthropic/claude-sonnet-4-6",      },      {        id: "opus",        name: "Deep Work",        workspace: "~/.openclaw/workspace-opus",        model: "anthropic/claude-opus-4-6",      },    ],  },  bindings: [    {      agentId: "opus",      match: { channel: "whatsapp", accountId: "*", peer: { kind: "direct", id: "+15551234567" } },    },    { agentId: "chat", match: { channel: "whatsapp", accountId: "*" } },  ],}

{  agents: {    list: [      {        id: "family",        name: "Family",        workspace: "~/.openclaw/workspace-family",        identity: { name: "Family Bot" },        groupChat: {          mentionPatterns: ["@family", "@familybot", "@Family Bot"],        },        sandbox: {          mode: "all",          scope: "agent",        },        tools: {          allow: [            "exec",            "read",            "sessions_list",            "sessions_history",            "sessions_send",            "sessions_spawn",            "session_status",          ],          deny: ["write", "edit", "apply_patch", "browser", "canvas", "nodes", "cron"],        },      },    ],  },  bindings: [    {      agentId: "family",      match: {        channel: "whatsapp",        peer: { kind: "group", id: "120363999999999999@g.us" },      },    },  ],}

إعداد الصندوق المعزول والأدوات لكل وكيل

يمكن أن يكون لكل وكيل صندوقه المعزول وقيود أدواته الخاصة:

{  agents: {    list: [      {        id: "personal",        workspace: "~/.openclaw/workspace-personal",        sandbox: {          mode: "off",  // No sandbox for personal agent        },        // No tool restrictions - all tools available      },      {        id: "family",        workspace: "~/.openclaw/workspace-family",        sandbox: {          mode: "all",     // Always sandboxed          scope: "agent",  // One container per agent          docker: {            // Optional one-time setup after container creation            setupCommand: "apt-get update && apt-get install -y git curl",          },        },        tools: {          allow: ["read"],                    // Only read tool          deny: ["exec", "write", "edit", "apply_patch"],    // Deny others        },      },    ],  },}

الفوائد:

• عزل الأمان: قيّد الأدوات للوكلاء غير الموثوقين.
• التحكم بالموارد: اعزل وكلاء محددين مع إبقاء الآخرين على المضيف.
• سياسات مرنة: أذونات مختلفة لكل وكيل.

راجع صندوق وأدوات الوكلاء المتعددين المعزولة للحصول على أمثلة مفصلة.

ذات صلة

• وكلاء ACP — تشغيل أحزمة ترميز خارجية
• توجيه القنوات — كيف يتم توجيه الرسائل إلى الوكلاء
• الحضور — حضور الوكيل وتوافره
• الجلسة — عزل الجلسات وتوجيهها
• الوكلاء الفرعيون — تشغيل مهام وكلاء في الخلفية