Pairing

text

Copy

openclaw pairing

Approve or inspect DM pairing requests (for channels that support pairing).

Related:

• Pairing flow: Pairing

Commands

bash
Copy
openclaw pairing list telegram
openclaw pairing list --channel telegram --account work
openclaw pairing list telegram --json

openclaw pairing approve <code>
openclaw pairing approve telegram <code>
openclaw pairing approve --channel telegram --account work <code> --notify

text

Copy

pairing list

List pending pairing requests for one channel.

Options:

• text

  Copy

  [channel]
  : positional channel id
• text

  Copy

  --channel <channel>
  : explicit channel id
• text

  Copy

  --account <accountId>
  : account id for multi-account channels
• text

  Copy

  --json
  : machine-readable output

Notes:

• If multiple pairing-capable channels are configured, you must provide a channel either positionally or with
  text

  Copy

  --channel
  .
• Extension channels are allowed as long as the channel id is valid.

text

Copy

pairing approve

Approve a pending pairing code and allow that sender.

Usage:

• text

  Copy

  openclaw pairing approve <channel> <code>
• text

  Copy

  openclaw pairing approve --channel <channel> <code>
• text

  Copy

  openclaw pairing approve <code>
  when exactly one pairing-capable channel is configured

Options:

• text

  Copy

  --channel <channel>
  : explicit channel id
• text

  Copy

  --account <accountId>
  : account id for multi-account channels
• text

  Copy

  --notify
  : send a confirmation back to the requester on the same channel

Owner bootstrap:

• If
  text

  Copy

  commands.ownerAllowFrom
  is empty when you approve a pairing code, OpenClaw also records the approved sender as the command owner, using a channel-scoped entry such as
  text

  Copy

  telegram:123456789
  .
• This only bootstraps the first owner. Later pairing approvals do not replace or expand
  text

  Copy

  commands.ownerAllowFrom
  .
• The command owner is the human operator account allowed to run owner-only commands and approve dangerous actions such as
  text

  Copy

  /diagnostics
  ,
  text

  Copy

  /export-trajectory
  ,
  text

  Copy

  /config
  , and exec approvals.

Notes

• Channel input: pass it positionally (
  text

  Copy

  pairing list telegram
  ) or with
  text

  Copy

  --channel <channel>
  .
• text

  Copy

  pairing list
  supports
  text

  Copy

  --account <accountId>
  for multi-account channels.
• text

  Copy

  pairing approve
  supports
  text

  Copy

  --account <accountId>
  and
  text

  Copy

  --notify
  .
• If only one pairing-capable channel is configured,
  text

  Copy

  pairing approve <code>
  is allowed.
• If you approved a sender before this bootstrap existed, run
  text

  Copy

  openclaw doctor
  ; it warns when no command owner is configured and shows the
  text

  Copy

  openclaw config set commands.ownerAllowFrom ...
  command to fix it.

Related

• CLI reference
• Channel pairing