مسیریابی چندعاملی

چند عامل ایزوله را در یک فرایند Gateway اجرا کنید؛ هرکدام با فضای کاری، دایرکتوری وضعیت (agentDir) و تاریخچه نشست مبتنی بر SQLite مختص خود، به‌علاوه چند حساب کانال (برای نمونه، دو شماره WhatsApp). پیام‌های ورودی از طریق اتصال‌ها به عامل درست هدایت می‌شوند.

یک عامل محدوده کامل هر شخصیت است: فایل‌های فضای کاری، پروفایل‌های احراز هویت، رجیستری مدل و مخزن نشست. یک اتصال، حساب کانال (یک فضای کاری Slack، یک شماره WhatsApp و غیره) را به یکی از آن عامل‌ها نگاشت می‌کند.

عامل چیست

هر عامل موارد مختص خود را دارد:

• فضای کاری: فایل‌ها، AGENTS.md/SOUL.md/USER.md، یادداشت‌های محلی، قواعد شخصیت.
• دایرکتوری وضعیت (agentDir): پروفایل‌های احراز هویت، رجیستری مدل، پیکربندی هر عامل.
• مخزن نشست: تاریخچه گفت‌وگو و وضعیت مسیریابی در ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite.

پروفایل‌های احراز هویت مختص هر عامل هستند و از این مسیر خوانده می‌شوند:

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

Skills از فضای کاری هر عامل و ریشه‌های مشترکی مانند ~/.openclaw/skills بارگیری می‌شوند، سپس بر اساس فهرست مجاز مؤثر Skills عامل پالایش می‌شوند. از agents.defaults.skills برای خط مبنای مشترک و از agents.list[].skills برای جایگزینی مختص هر عامل استفاده کنید (ورودی‌های صریح جایگزین مقدار پیش‌فرض می‌شوند و با آن ادغام نمی‌شوند). به Skills: مختص هر عامل در برابر مشترک و Skills: فهرست‌های مجاز عامل مراجعه کنید.

ذخیره‌سازی متعلق به Plugin از پیکربندی همان Plugin پیروی می‌کند؛ افزودن عامل دوم به‌طور خودکار همه مخزن‌های سراسری Plugin را تفکیک نمی‌کند. برای نمونه، وقتی شخصیت‌ها نباید دانش ویکی کامپایل‌شده را به اشتراک بگذارند، گاوصندوق‌های مختص هر عامل Memory Wiki را پیکربندی کنید.

مسیرها

حالت تک‌عاملی (پیش‌فرض)

اگر چیزی پیکربندی نکنید، OpenClaw یک عامل را اجرا می‌کند:

• agentId به‌طور پیش‌فرض main است.
• کلید نشست‌ها به‌شکل agent:main:<mainKey> است (mainKey پیش‌فرض، main است).
• فضای کاری به‌طور پیش‌فرض ~/.openclaw/workspace است (یا وقتی OPENCLAW_PROFILE روی چیزی غیر از default تنظیم شده باشد، workspace-<profile>).
• وضعیت به‌طور پیش‌فرض ~/.openclaw/agents/main/agent است.

ابزار کمکی عامل

یک عامل ایزوله جدید اضافه کنید:

openclaw agents add work

پرچم‌ها: --workspace <dir>، --model <id>، --agent-dir <dir>، --bind <channel[:accountId]> (قابل‌تکرار)، --non-interactive (نیازمند --workspace).

برای مسیریابی پیام‌های ورودی، 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 مختص هر عامل).
• احراز هویت و نشست‌های جداگانه، با دسترسی میان‌عاملی که فقط از طریق قابلیت‌های صریح یا پیکربندی Plugin فعال می‌شود.

این کار به چند نفر اجازه می‌دهد یک Gateway را به اشتراک بگذارند، درحالی‌که وضعیت اصلی عامل جدا نگه داشته می‌شود.

گاوصندوق‌های مختص هر عامل Memory Wiki

Memory Wiki به‌طور پیش‌فرض از یک گاوصندوق سراسری استفاده می‌کند. برای جدا نگه‌داشتن دانش کامپایل‌شده عامل پشتیبانی از دانش عامل بازاریابی، plugins.entries.memory-wiki.config.vault.scope را روی agent تنظیم کنید:

{  plugins: {    entries: {      "memory-wiki": {        enabled: true,        config: {          vault: {            scope: "agent",            path: "~/.openclaw/wiki",          },        },      },    },  },}

مسیر پیکربندی‌شده، دایرکتوری والد است. OpenClaw شناسه نرمال‌شده عامل را به آن می‌افزاید و مسیرهایی مانند ~/.openclaw/wiki/support و ~/.openclaw/wiki/marketing تولید می‌کند. وقتی چند عامل پیکربندی شده باشند، عملیات CLI و Gateway با دامنه عامل به تعیین صریح عامل نیاز دارند. برای جزئیات پالایش پل، مهاجرت و مرز اعتماد، به گاوصندوق‌های مختص هر عامل Memory Wiki مراجعه کنید.

جست‌وجوی حافظه 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" }], // درون فضای کاری تفکیک می‌شود -> مجموعه‌ای با نام "notes-main"          },        },      },      { id: "family", workspace: "~/workspaces/family" },    ],  },  memory: {    backend: "qmd",    qmd: { includeDefaultMemory: false },  },}

مسیر یک مجموعه اضافی می‌تواند میان عامل‌ها مشترک باشد، اما وقتی مسیر بیرون از فضای کاری عامل است، name آن صریح باقی می‌ماند. مسیرهای درون فضای کاری مختص عامل باقی می‌مانند تا هر عامل مجموعه جست‌وجوی رونوشت مختص خود را حفظ کند.

یک شماره WhatsApp، چند نفر (تفکیک پیام خصوصی)

با تطبیق فرستنده E.164 ‏(+15551234567) با peer.kind: "direct"، پیام‌های خصوصی متفاوت WhatsApp را در یک حساب WhatsApp به عامل‌های متفاوت هدایت کنید. پاسخ‌ها همچنان از همان شماره 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 سراسری است، نه مختص هر عامل. برای گروه‌های مشترک، گروه را به یک عامل متصل کنید یا از گروه‌های پخش استفاده کنید.

قواعد مسیریابی

اتصال‌ها قطعی هستند و مشخص‌ترین تطبیق برنده می‌شود. برای ترتیب کامل سطوح (همتای دقیق، همتای والد، نویسه عام همتا، انجمن+نقش‌ها، انجمن، تیم، حساب، کانال، عامل پیش‌فرض) به مسیریابی کانال مراجعه کنید. چند قاعده که در اینجا ارزش اشاره دارند:

• اگر چند اتصال در یک سطح منطبق شوند، نخستین مورد بر اساس ترتیب پیکربندی برنده می‌شود.
• اگر یک اتصال چند فیلد تطبیق را تنظیم کند (برای نمونه peer + guildId) همه فیلدهای مشخص‌شده باید منطبق باشند (معنای AND).
• اتصالی که accountId را حذف کند فقط با حساب پیش‌فرض منطبق می‌شود، نه همه حساب‌ها. برای بازگشت جایگزین در سراسر کانال از accountId: "*" یا برای یک حساب از accountId: "<name>" استفاده کنید. افزودن دوباره همان اتصال با شناسه حساب صریح، به‌جای تکثیر، اتصال موجودِ فقط‌کانال را ارتقا می‌دهد.

چند حساب / شماره تلفن

کانال‌هایی که از چند حساب پشتیبانی می‌کنند (برای نمونه WhatsApp)، از accountId برای شناسایی هر ورود استفاده می‌کنند. هر accountId به عامل مختص خود هدایت می‌شود، بنابراین یک سرور می‌تواند بدون ترکیب نشست‌ها میزبان چند شماره تلفن باشد.

برای انتخاب حسابی که هنگام حذف accountId استفاده می‌شود، channels.<channel>.defaultAccount را تنظیم کنید. اگر تنظیم نشده باشد، OpenClaw در صورت وجود به default برمی‌گردد؛ در غیر این صورت، نخستین شناسهٔ حساب پیکربندی‌شده (پس از مرتب‌سازی) را انتخاب می‌کند.

کانال‌هایی که از چند حساب پشتیبانی می‌کنند: discord، feishu، googlechat، imessage، irc، line، mattermost، matrix، nextcloud-talk، nostr، signal، slack، telegram، whatsapp، zalo، zalouser.

مفاهیم

• agentId: یک «مغز» (فضای کاری، احراز هویت مختص هر عامل، مخزن نشست مختص هر عامل).
• accountId: یک نمونه از حساب کانال (برای مثال، حساب WhatsApp با personal در برابر biz).
• binding: پیام‌های ورودی را بر اساس (channel, accountId, peer) و در صورت نیاز شناسه‌های انجمن/تیم، به یک agentId هدایت می‌کند.
• گفت‌وگوهای مستقیم در 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",      },    ],  },   // مسیریابی قطعی: نخستین تطبیق برنده است (ابتدا اختصاصی‌ترین مورد).  bindings: [    { agentId: "home", match: { channel: "whatsapp", accountId: "personal" } },    { agentId: "work", match: { channel: "whatsapp", accountId: "biz" } },     // بازنویسی اختیاری برای هر همتا (مثال: ارسال یک گروه مشخص به عامل کاری).    {      agentId: "work",      match: {        channel: "whatsapp",        accountId: "personal",        peer: { kind: "group", id: "[email protected]" },      },    },  ],   // به‌طور پیش‌فرض غیرفعال است: پیام‌رسانی عامل‌به‌عامل باید صریحاً فعال و در فهرست مجاز قرار داده شود.  tools: {    agentToAgent: {      enabled: false,      allow: ["home", "work"],    },  },   channels: {    whatsapp: {      accounts: {        personal: {          // بازنویسی اختیاری. پیش‌فرض: ~/.openclaw/credentials/whatsapp/personal          // authDir: "~/.openclaw/credentials/whatsapp/personal",        },        biz: {          // بازنویسی اختیاری. پیش‌فرض: ~/.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: "[email protected]" },      },    },  ],}

پیکربندی سندباکس و ابزار برای هر عامل

هر عامل می‌تواند سندباکس و محدودیت‌های ابزار مختص خود را داشته باشد:

{  agents: {    list: [      {        id: "personal",        workspace: "~/.openclaw/workspace-personal",        sandbox: {          mode: "off",  // عامل شخصی سندباکس ندارد        },        // بدون محدودیت ابزار — همهٔ ابزارها در دسترس‌اند      },      {        id: "family",        workspace: "~/.openclaw/workspace-family",        sandbox: {          mode: "all",     // همیشه در سندباکس          scope: "agent",  // یک کانتینر برای هر عامل          docker: {            // راه‌اندازی یک‌بارهٔ اختیاری پس از ایجاد کانتینر            setupCommand: "apt-get update && apt-get install -y git curl",          },        },        tools: {          allow: ["read"],                    // فقط ابزار خواندن          deny: ["exec", "write", "edit", "apply_patch"],    // رد کردن سایر ابزارها        },      },    ],  },}

این موارد را فراهم می‌کند:

• جداسازی امنیتی: ابزارهای عوامل غیرقابل‌اعتماد را محدود کنید.
• کنترل منابع: عوامل مشخصی را در سندباکس اجرا کنید و سایر عوامل را روی میزبان نگه دارید.
• خط‌مشی‌های انعطاف‌پذیر: مجوزهای متفاوت برای هر عامل.

برای نمونه‌های تفصیلی به سندباکس و ابزارهای چندعاملی مراجعه کنید.

مرتبط

• عامل‌های ACP — اجرای چارچوب‌های خارجی کدنویسی
• مسیریابی کانال — نحوه مسیریابی پیام‌ها به عامل‌ها
• حضور — حضور و دسترس‌پذیری عامل
• نشست — جداسازی و مسیریابی نشست
• عامل‌های فرعی — ایجاد اجراهای پس‌زمینه عامل