OpenClaw Client Onboarding: The Access Decisions to Agree Before You Install

Published 2026-10-20 · Updated 2026-10-20 · By The Is My Agent Safe team

Short answer

Agree the access decisions with the client before you install and write them down. Decide who can message the agent, whether DMs share one session, which tools it gets, whether tools run in a sandbox, which accounts it uses and how you reach the Gateway. OpenClaw's local onboarding sets the full tool profile when none is set, so choose deliberately.

  • Who can message it: DM policy (pairing is the default), group allowlists and mention gates.
  • Whose conversations stay apart: session.dmScope, which defaults to one shared main session.
  • What it can do: tool profile, exec and elevated settings, and sandboxing, which is off by default.
  • Where it runs and who can reach it, which accounts it uses, and what your contract with the client says about their data.

Paste your audit: run openclaw security audit --deep and paste the output into our free check for a red/amber/green result with the most important finding first (Limits of the check).

Who this is for

Agencies, freelancers and consultants about to install OpenClaw for a new client. This page covers the decisions to agree before the install. For checking an install you're about to hand over, use How to audit a client's OpenClaw. For splitting several clients, see Running OpenClaw for multiple clients.

Most of these choices are settings in OpenClaw's config. Agreeing them up front means the client knows what the agent can do, and you have a written record to check the install against later.

1. Who can message the agent?

OpenClaw's access control docs list four DM policies for every DM-capable channel:

dmPolicyWhat it does
pairingThe default. Unknown senders get a pairing code, and the bot ignores them until approved.
allowlistUnknown senders are blocked, with no pairing step.
openAnyone can DM the bot. Needs "*" in the channel allowlist as an explicit opt-in.
disabledInbound DMs are ignored.

Agree with the client:

2. Whose conversations stay apart?

By default, OpenClaw routes all direct messages across channels into one main session. If more than one person at the client will message the agent, the docs say to set session.dmScope: "per-channel-peer", so each sender gets their own DM context.

The same page says this is a messaging-context boundary, not a host-admin boundary. If people who share the Gateway don't trust each other, the docs say to run separate Gateways, one per trust boundary. That's covered in Running OpenClaw for multiple clients.

Also agree what context reaches the model. contextVisibility defaults to all, which keeps quoted text, thread history and forwarded content as received. allowlist filters it to senders who pass the allowlist checks.

3. What can the agent do?

This is the decision with the most impact, and the one most often left at the default.

OpenClaw's running the audit page puts "anything open plus tools enabled" first in its fix order. Open messaging with broad tools is the combination to avoid.

4. Where does it run, and who can reach it?

Agree the host and the access pattern before you install:

5. What does your contract say about the client's data?

If the agent will read the client's email, files or customer records, you may be handling personal data on their behalf. If you handle client data, check your contract and any data-protection rules that apply; this guide isn't legal advice. Writing down the access decisions above also gives you a plain description of what the agent can reach.

6. Write it down

Keep a one-page onboarding record per client, and check the install against it at handoff. The rows below are a made-up example, not a real client:

DecisionMade-up example
Who can DMTwo named staff, dmPolicy: "allowlist"
GroupsOne team channel, mention required
DM sessionssession.dmScope: "per-channel-peer"
Tool profilemessaging, plus calendar read
Exec and elevatedExec denied, elevated off
SandboxOn for all agents
Host and accessClient's VPS, loopback, SSH tunnel
Version2026.10.5
KeysClient-owned model key with a spend limit
Client sign-offName, date

Then run openclaw security audit --deep after the install and keep the dated output with the record.

What our free check covers

The free check at /check is paste-only. Paste the client's openclaw security audit --deep output and openclaw --version. It explains the findings, checks for risky settings such as API keys handed to skills, and checks the version against published security advisories. Nothing is installed into the agent you're checking. Green means no issues found in the checks we ran. See Limits of the check.

It doesn't check your onboarding record or contract, doesn't detect malicious skills, and doesn't review MCP servers or skill code. The check is free, and a full report is $29.

You can buy a founding seat on /agencies. $99/month, price locked for your first 12 paid months. After that, it moves to the then-current Agency price, with at least 30 days' email notice. Cancel any time. Offer conditions.

Where next

Frequently asked questions

What tool profile does OpenClaw set during onboarding?

OpenClaw's tool policy docs say local onboarding sets tools.profile: "full" when no profile is configured, including when onboarding runs again on an existing config without a profile. The other built-in profiles are minimal, coding and messaging.

Who can message a new OpenClaw agent by default?

OpenClaw's access control docs say pairing is the default DM policy: unknown senders get a pairing code and the bot ignores them until you approve it. open lets anyone DM the bot and needs an explicit "*" in the channel allowlist.

Do all DMs share one conversation?

By default, yes. OpenClaw's access control docs say the main default routes all direct messages across channels into one session. For shared or multi-user inboxes, the docs say to set session.dmScope: "per-channel-peer".

Is sandboxing on by default?

No. OpenClaw's sandboxing docs say sandboxing is off by default and is controlled by agents.defaults.sandbox or per-agent settings. The Gateway process stays on the host; only tool execution moves into the sandbox.

Can Is My Agent Safe check a client install after onboarding?

Yes, one paste at a time. Paste the client's openclaw security audit --deep output and openclaw --version into the free check at /check. It explains the findings, checks for risky settings and checks the version against published security advisories. It doesn't detect malicious skills or review MCP servers or skill code.

Sources

  1. OpenClaw docs: access control and allowlists
  2. OpenClaw docs: hardened baselines
  3. OpenClaw docs: tool policy (profiles, allow and deny)
  4. OpenClaw docs: sandboxing
  5. OpenClaw docs: running the security audit
  6. OpenClaw docs: security trust model
  7. OpenClaw docs: Gateway exposure runbook
  8. OpenClaw release v2026.10.5 (GitHub, Oct 18, 2026)
  9. OpenClaw release v2026.8.1 (Aug 31, 2026)