การกำหนดเส้นทางแบบหลายเอเจนต์

เรียกใช้เอเจนต์ ที่แยกจากกัน หลายตัว โดยแต่ละตัวมี workspace, ไดเรกทอรีสถานะ (agentDir) และประวัติเซสชันของตัวเอง พร้อมกับบัญชีช่องทางหลายบัญชี (เช่น WhatsApp สองบัญชี) ใน Gateway ที่กำลังทำงานอยู่ตัวเดียว ข้อความขาเข้าจะถูกกำหนดเส้นทางไปยังเอเจนต์ที่ถูกต้องผ่านการผูก

เอเจนต์ ในที่นี้คือขอบเขตเต็มรูปแบบต่อ persona: ไฟล์ workspace, โปรไฟล์การยืนยันตัวตน, รีจิสทรีโมเดล และที่เก็บเซสชัน agentDir คือไดเรกทอรีสถานะบนดิสก์ที่เก็บการกำหนดค่าต่อเอเจนต์นี้ไว้ที่ ~/.openclaw/agents/<agentId>/ การผูก จะจับคู่บัญชีช่องทาง (เช่น workspace ของ Slack หรือหมายเลข WhatsApp) เข้ากับเอเจนต์หนึ่งในเหล่านั้น

"เอเจนต์หนึ่งตัว" คืออะไร?

เอเจนต์ คือสมองที่มีขอบเขตครบถ้วน โดยมีของตัวเองดังนี้:

• Workspace (ไฟล์, AGENTS.md/SOUL.md/USER.md, โน้ตในเครื่อง, กฎ persona)
• ไดเรกทอรีสถานะ (agentDir) สำหรับโปรไฟล์การยืนยันตัวตน, รีจิสทรีโมเดล และการกำหนดค่าต่อเอเจนต์
• ที่เก็บเซสชัน (ประวัติแชต + สถานะการกำหนดเส้นทาง) ภายใต้ ~/.openclaw/agents/<agentId>/sessions

โปรไฟล์การยืนยันตัวตนเป็นแบบ ต่อเอเจนต์ เอเจนต์แต่ละตัวอ่านจากไฟล์ของตัวเอง:

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

Skills จะถูกโหลดจาก workspace ของเอเจนต์แต่ละตัว รวมถึงรากที่ใช้ร่วมกัน เช่น ~/.openclaw/skills จากนั้นจะถูกกรองด้วยรายการอนุญาต Skills ของเอเจนต์ที่มีผลเมื่อมีการกำหนดค่าไว้ ใช้ agents.defaults.skills สำหรับค่าพื้นฐานที่ใช้ร่วมกัน และ agents.list[].skills สำหรับการแทนที่ต่อเอเจนต์ ดู Skills: ต่อเอเจนต์เทียบกับแบบใช้ร่วมกัน และ Skills: รายการอนุญาต Skills ของเอเจนต์

Gateway สามารถโฮสต์ เอเจนต์หนึ่งตัว (ค่าเริ่มต้น) หรือ เอเจนต์หลายตัว เคียงข้างกันได้

เส้นทาง (แผนที่แบบเร็ว)

• การกำหนดค่า: ~/.openclaw/openclaw.json (หรือ OPENCLAW_CONFIG_PATH)
• ไดเรกทอรีสถานะ: ~/.openclaw (หรือ OPENCLAW_STATE_DIR)
• Workspace: ~/.openclaw/workspace (หรือ ~/.openclaw/workspace-<agentId>)
• ไดเรกทอรีเอเจนต์: ~/.openclaw/agents/<agentId>/agent (หรือ agents.list[].agentDir)
• เซสชัน: ~/.openclaw/agents/<agentId>/sessions

โหมดเอเจนต์เดียว (ค่าเริ่มต้น)

หากคุณไม่ทำอะไร OpenClaw จะเรียกใช้เอเจนต์เดียว:

• agentId มีค่าเริ่มต้นเป็น main
• เซสชันมีคีย์เป็น agent:main:<mainKey>
• Workspace มีค่าเริ่มต้นเป็น ~/.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 จะกลายเป็น persona ที่แยกจากกันโดยสมบูรณ์:

• หมายเลขโทรศัพท์/บัญชีต่างกัน (accountId ต่อช่องทาง)
• บุคลิกต่างกัน (ไฟล์ workspace ต่อเอเจนต์ เช่น AGENTS.md และ SOUL.md)
• การยืนยันตัวตน + เซสชันแยกกัน (ไม่มีการปะปน เว้นแต่เปิดใช้อย่างชัดเจน)

สิ่งนี้ทำให้ หลายคน ใช้เซิร์ฟเวอร์ Gateway เดียวร่วมกันได้ พร้อมคงการแยก "สมอง" AI และข้อมูลของตนเอง

การค้นหาหน่วยความจำ 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 },  },}

เส้นทางคอลเลกชันเพิ่มเติมสามารถใช้ร่วมกันระหว่างเอเจนต์ได้ แต่ชื่อคอลเลกชันจะยังคงต้องระบุชัดเจนเมื่อเส้นทางอยู่นอก workspace ของเอเจนต์ เส้นทางภายใน workspace จะยังคงอยู่ในขอบเขตของเอเจนต์ เพื่อให้เอเจนต์แต่ละตัวเก็บชุดค้นหาทรานสคริปต์ของตัวเอง

หมายเลข 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 จะ fallback ไปยัง default หากมี ไม่เช่นนั้นจะใช้ ID บัญชีแรกที่กำหนดค่าไว้ (เรียงลำดับแล้ว)

ช่องทางทั่วไปที่รองรับรูปแบบนี้ ได้แก่:

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

แนวคิด

• agentId: "สมอง" หนึ่งชุด (workspace, การยืนยันตัวตนต่อเอเจนต์, ที่เก็บเซสชันต่อเอเจนต์)
• accountId: อินสแตนซ์บัญชีช่องทางหนึ่งบัญชี (เช่น บัญชี WhatsApp "personal" เทียบกับ "biz")
• binding: กำหนดเส้นทางข้อความขาเข้าไปยัง agentId ด้วย (channel, accountId, peer) และ ID guild/team ที่เป็นทางเลือก
• แชตโดยตรงจะถูกรวมไปยัง agent:<agentId>:<mainKey> ("main" ต่อเอเจนต์; 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 — การรัน harness เขียนโค้ดภายนอก
• การกำหนดเส้นทางช่องทาง — วิธีที่ข้อความถูกส่งไปยังเอเจนต์
• Presence — Presence และความพร้อมใช้งานของเอเจนต์
• Session — การแยก Session และการกำหนดเส้นทาง
• เอเจนต์ย่อย — การสร้างการรันเอเจนต์เบื้องหลัง