SetupTeams

Add Team Members to OpenClaw: Multi-User Setup

Set up OpenClaw for multiple users. Control who can access, isolate DMs per user, and manage team access.

6 min readLast updated Feb 18, 2026

Stuck?Check the troubleshooting index or ask in Discord.

Overview

Set up OpenClaw for multiple users. Control who can access your assistant, isolate conversations per user, and manage team access.

Multi-user vs Multi-agent

This guide covers multiple users sharing one agent. For multiple isolated AI brains, see the Multiple Agents guide.

DM Isolation

By default, all DMs go to one shared session. For multi-user, isolate DMs per user:

json5

{
  session: {
    dmScope: "per-peer"  // Each user gets their own DM session
  }
}

Options: main (shared), per-peer (per user), per-channel-peer (per channel + user)

Allowlists

Control who can access your OpenClaw via allowlists:

json5

{
  channels: {
    telegram: {
      dmPolicy: "allowlist",
      allowFrom: ["123456789", "987654321"]  // Telegram user IDs
    },
    whatsapp: {
      dmPolicy: "allowlist",
      allowFrom: ["+15551234567", "+15559876543"]
    }
  }
}

Channel Access Control

Restrict access per channel:

json5

{
  channels: {
    discord: {
      dm: {
        enabled: true,
        allowFrom: ["alice", "bob", "charlie"]
      }
    },
    telegram: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["123456789"]
    }
  }
}

Session Scopes

Control session behavior per user:

json5

{
  session: {
    dmScope: "per-peer",
    reset: {
      mode: "daily",      // Reset sessions daily
      atHour: 4,         // At 4am
      idleMinutes: 120   // Or after 2 hours idle
    }
  }
}

WhatsApp Multi-User

WhatsApp supports multiple users on one account via allowlists:

json5

{
  channels: {
    whatsapp: {
      dmPolicy: "allowlist",
      allowFrom: [
        "+15551230001",
        "+15551230002",
        "+15551230003"
      ]
    }
  }
}

Each allowlisted number gets their own DM session (with dmScope: "per-peer").

Discord Multi-User

Control Discord DM access by username:

json5

{
  channels: {
    discord: {
      enabled: true,
      token: "YOUR_BOT_TOKEN",
      dm: {
        enabled: true,
        allowFrom: ["alice", "bob", "charlie"]
      }
    }
  }
}