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

شغّل عدة وكلاء معزولين، لكل منهم مساحة عمل خاصة به، ودليل حالة (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، ثم تُرشَّح حسب قائمة السماح الفعالة لمهارات الوكيل عند إعدادها. استخدم 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 coding
openclaw agents add social

openclaw channels login --channel whatsapp --account work

openclaw gateway restart
openclaw agents list --bindings
openclaw 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
• bluebubbles, zalo, zalouser, nostr, feishu

# المفاهيم

• agentId: "عقل" واحد (مساحة عمل، مصادقة خاصة بكل وكيل، مخزن جلسات خاص بكل وكيل).
• accountId: نسخة حساب قناة واحدة (مثلا حساب WhatsApp "personal" مقابل "biz").
• binding: يوجه الرسائل الواردة إلى agentId حسب (channel, accountId, peer) واختياريا معرّفات النقابة/الفريق.
• تنهار المحادثات المباشرة إلى 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 personal
openclaw 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: "[email protected]" },
      },
    },
  ],

  // 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" } },
    { agentId: "opus", match: { channel: "telegram" } },
  ],
}

{
  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", peer: { kind: "direct", id: "+15551234567" } },
    },
    { agentId: "chat", match: { channel: "whatsapp" } },
  ],
}

{
  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: "[email protected]" },
      },
    },
  ],
}

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

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

{
  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 — تشغيل أدوات ترميز خارجية
• توجيه القنوات — كيفية توجيه الرسائل إلى الوكلاء
• الحضور — حضور الوكيل وتوفره
• الجلسة — عزل الجلسات وتوجيهها
• الوكلاء الفرعيون — إنشاء تشغيلات وكلاء في الخلفية