Routing voor meerdere agents

Voer meerdere geïsoleerde agents uit in één Gateway-proces, elk met een eigen werkruimte, statusmap (agentDir) en op SQLite gebaseerde sessiegeschiedenis, plus meerdere kanaalaccounts (bijvoorbeeld twee WhatsApp-nummers). Inkomende berichten worden via bindingen naar de juiste agent gerouteerd.

Een agent omvat alles wat bij één persona hoort: werkruimtebestanden, authenticatieprofielen, modelregister en sessieopslag. Een binding koppelt een kanaalaccount (een Slack-werkruimte, een WhatsApp-nummer enzovoort) aan een van die agents.

Wat is één agent

Elke agent heeft een eigen:

• Werkruimte: bestanden, AGENTS.md/SOUL.md/USER.md, lokale notities, personaregels.
• Statusmap (agentDir): authenticatieprofielen, modelregister, configuratie per agent.
• Sessieopslag: chatgeschiedenis en routeringsstatus in ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite.

Authenticatieprofielen zijn per agent en worden gelezen uit:

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

Skills worden geladen uit de werkruimte van elke agent en uit gedeelde hoofdmappen zoals ~/.openclaw/skills, en vervolgens gefilterd op basis van de effectieve lijst met toegestane Skills van de agent. Gebruik agents.defaults.skills voor een gedeelde basis en agents.entries.*.skills voor een vervanging per agent (expliciete vermeldingen vervangen de standaard en worden er niet mee samengevoegd). Zie Skills: per agent versus gedeeld en Skills: lijsten met toegestane agents.

Opslag die eigendom is van een Plugin volgt de configuratie van die Plugin; door een tweede agent toe te voegen, wordt niet automatisch elke algemene Plugin-opslag opgesplitst. Configureer bijvoorbeeld Memory Wiki-kluizen per agent wanneer persona's geen gecompileerde wikikennis mogen delen.

Paden

Modus met één agent (standaard)

Als je niets configureert, voert OpenClaw één agent uit:

• agentId is standaard main.
• Sessies gebruiken agent:main:<mainKey> als sleutel (standaard is mainKey gelijk aan main).
• De werkruimte is standaard ~/.openclaw/workspace (of workspace-<profile> wanneer OPENCLAW_PROFILE is ingesteld op iets anders dan default).
• De status is standaard ~/.openclaw/agents/main/agent.

Agenthelper

Voeg een nieuwe geïsoleerde agent toe:

openclaw agents add work

Vlaggen: --workspace <dir>, --model <id>, --agent-dir <dir>, --bind <channel[:accountId]> (herhaalbaar), --non-interactive (vereist --workspace).

Voeg bindings toe om inkomende berichten te routeren (de wizard biedt aan dit voor je te doen) en controleer vervolgens:

openclaw agents list --bindings

Snel aan de slag

openclaw agents add codingopenclaw agents add social

openclaw channels login --channel whatsapp --account work

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

Meerdere agents, meerdere persona's

Elke geconfigureerde agentId vormt een afzonderlijke personagrens voor de kernstatus van de agent:

• Verschillende accounts per kanaal (per accountId).
• Verschillende persoonlijkheden (AGENTS.md/SOUL.md per agent).
• Afzonderlijke authenticatie en sessies, waarbij toegang tussen agents alleen via expliciete functies of Plugin-configuratie wordt ingeschakeld.

Hierdoor kunnen meerdere personen één Gateway delen terwijl de kernstatus van hun agents gescheiden blijft.

Memory Wiki-kluizen per agent

Memory Wiki gebruikt standaard één algemene kluis. Om de gecompileerde kennis van een supportagent gescheiden te houden van die van een marketingagent, stel je plugins.entries.memory-wiki.config.vault.scope in op agent:

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

Het geconfigureerde pad is de bovenliggende map. OpenClaw voegt de genormaliseerde agent-id toe, waardoor paden ontstaan zoals ~/.openclaw/wiki/support en ~/.openclaw/wiki/marketing. Voor CLI- en Gateway-bewerkingen binnen het bereik van een agent moet expliciet een agent worden opgegeven wanneer meerdere agents zijn geconfigureerd. Zie Memory Wiki-kluizen per agent voor details over bridgefiltering, migratie en vertrouwensgrenzen.

QMD-geheugen doorzoeken tussen agents

Als je één agent de QMD-sessietranscripten van een andere agent wilt laten doorzoeken, voeg je extra verzamelingen toe onder agents.entries.*.memory.search.qmd.extraCollections. Gebruik memory.search.qmd.extraCollections wanneer elke agent dezelfde verzamelingen moet delen.

{  agents: {    defaults: {      workspace: "~/workspaces/main",    },    entries: {      main: {        workspace: "~/workspaces/main",        memory: {          search: {            qmd: {              extraCollections: [{ path: "notes" }], // wordt binnen de werkruimte omgezet -> verzameling met de naam "notes-main"            },          },        },      },      family: { workspace: "~/workspaces/family" },    },  },  memory: {    backend: "qmd",    search: {      qmd: {        extraCollections: [{ path: "~/agents/family/sessions", name: "family-sessions" }],      },    },    qmd: { includeDefaultMemory: false },  },}

Een pad van een extra verzameling kan tussen agents worden gedeeld, maar de name ervan blijft expliciet wanneer het pad buiten de werkruimte van de agent ligt. Paden binnen de werkruimte blijven beperkt tot de agent, zodat elke agent een eigen verzameling voor het doorzoeken van transcripten behoudt.

Eén WhatsApp-nummer, meerdere personen (DM-splitsing)

Routeer verschillende WhatsApp-DM's naar verschillende agents op één WhatsApp-account door de E.164 van de afzender (+15551234567) te vergelijken met peer.kind: "direct". Antwoorden worden nog steeds vanaf hetzelfde WhatsApp-nummer verzonden — er is geen afzenderidentiteit per agent.

{  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"],    },  },}

De toegangscontrole voor DM's (koppeling/lijst met toegestane afzenders) is algemeen per WhatsApp-account, niet per agent. Koppel gedeelde groepen aan één agent of gebruik Broadcastgroepen.

Routeringsregels

Bindingen zijn deterministisch en de specifiekste wint. Zie Kanaalroutering voor de volledige volgorde van niveaus (exacte peer, bovenliggende peer, jokerteken voor peers, guild+rollen, guild, team, account, kanaal, standaardagent). Enkele regels die hier het vermelden waard zijn:

• Als meerdere bindingen binnen hetzelfde niveau overeenkomen, wint de eerste in de configuratievolgorde.
• Als een binding meerdere vergelijkingsvelden instelt (bijvoorbeeld peer + guildId), moeten alle opgegeven velden overeenkomen (AND-semantiek).
• Een binding zonder accountId komt alleen overeen met het standaardaccount, niet met elk account. Gebruik accountId: "*" als terugvaloptie voor het hele kanaal, of accountId: "<name>" voor één account. Als je dezelfde binding opnieuw toevoegt met een expliciete account-id, wordt de bestaande binding die alleen voor het kanaal geldt bijgewerkt in plaats van gedupliceerd.

Meerdere accounts/telefoonnummers

Kanalen die meerdere accounts ondersteunen (bijvoorbeeld WhatsApp) gebruiken accountId om elke aanmelding te identificeren. Elke accountId wordt naar een eigen agent gerouteerd, zodat één server meerdere telefoonnummers kan hosten zonder sessies te vermengen.

Stel channels.<channel>.defaultAccount in om het account te kiezen dat wordt gebruikt wanneer accountId is weggelaten. Als dit niet is ingesteld, valt OpenClaw terug op default indien aanwezig, en anders op de eerste geconfigureerde account-id (gesorteerd).

Kanalen die meerdere accounts ondersteunen: discord, feishu, googlechat, imessage, irc, line, mattermost, matrix, nextcloud-talk, nostr, signal, slack, telegram, whatsapp, zalo, zalouser.

Concepten

• agentId: één „brein” (werkruimte, authenticatie per agent, sessieopslag per agent).
• accountId: één instantie van een kanaalaccount (bijvoorbeeld WhatsApp-account personal tegenover biz).
• binding: routeert inkomende berichten naar een agentId op basis van (channel, accountId, peer), en optioneel guild-/team-id's.
• Directe chats worden samengevoegd tot agent:<agentId>:<mainKey> („main” per agent; zie session.mainKey).

Platformvoorbeelden

{  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",      },    ],  },   // Deterministische routering: de eerste overeenkomst wint (meest specifieke eerst).  bindings: [    { agentId: "home", match: { channel: "whatsapp", accountId: "personal" } },    { agentId: "work", match: { channel: "whatsapp", accountId: "biz" } },     // Optionele overschrijving per peer (voorbeeld: stuur een specifieke groep naar de werkagent).    {      agentId: "work",      match: {        channel: "whatsapp",        accountId: "personal",        peer: { kind: "group", id: "1203630...@g.us" },      },    },  ],   // Standaard uitgeschakeld: berichten tussen agents moeten expliciet worden ingeschakeld en toegestaan.  tools: {    agentToAgent: {      enabled: false,      allow: ["home", "work"],    },  },   channels: {    whatsapp: {      accounts: {        personal: {          // Optionele overschrijving. Standaard: ~/.openclaw/credentials/whatsapp/personal          // authDir: "~/.openclaw/credentials/whatsapp/personal",        },        biz: {          // Optionele overschrijving. Standaard: ~/.openclaw/credentials/whatsapp/biz          // authDir: "~/.openclaw/credentials/whatsapp/biz",        },      },    },  },}

Veelvoorkomende patronen

{  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" },      },    },  ],}

Sandbox- en toolconfiguratie per agent

Elke agent kan zijn eigen sandbox- en toolbeperkingen hebben:

{  agents: {    list: [      {        id: "personal",        workspace: "~/.openclaw/workspace-personal",        sandbox: {          mode: "off",  // Geen sandbox voor persoonlijke agent        },        // Geen toolbeperkingen - alle tools zijn beschikbaar      },      {        id: "family",        workspace: "~/.openclaw/workspace-family",        sandbox: {          mode: "all",     // Altijd in een sandbox          scope: "agent",  // Eén container per agent          docker: {            // Optionele eenmalige configuratie na het maken van de container            setupCommand: "apt-get update && apt-get install -y git curl",          },        },        tools: {          allow: ["read"],                    // Alleen de leestool          deny: ["exec", "write", "edit", "apply_patch"],    // Andere weigeren        },      },    ],  },}

Dit biedt je:

• Beveiligingsisolatie: beperk tools voor niet-vertrouwde agents.
• Resourcebeheer: plaats specifieke agents in een sandbox terwijl andere op de host blijven.
• Flexibel beleid: verschillende machtigingen per agent.

Zie Sandbox en tools voor meerdere agents voor gedetailleerde voorbeelden.

Gerelateerd

• ACP-agenten — externe codeharnassen uitvoeren
• Kanaalroutering — hoe berichten naar agenten worden gerouteerd
• Aanwezigheid — aanwezigheid en beschikbaarheid van agenten
• Sessie — sessie-isolatie en routering
• Subagenten — agentruns op de achtergrond starten