openclaw/docs/cli/pairing.md

summary, read_when, title

summary	read_when	title
CLI reference for `openclaw pairing` (approve/list pairing requests)	You’re using pairing-mode DMs and need to approve senders	pairing

openclaw pairing

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

Related:

• Pairing flow: Pairing

Commands

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

pairing list

List pending pairing requests for one channel.

Options:

• [channel]: positional channel id
• --channel <channel>: explicit channel id
• --account <accountId>: account id for multi-account channels
• --json: machine-readable output

Notes:

• If multiple pairing-capable channels are configured, you must provide a channel either positionally or with --channel.
• Extension channels are allowed as long as the channel id is valid.

pairing approve

Approve a pending pairing code and allow that sender.

Usage:

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

Options:

• --channel <channel>: explicit channel id
• --account <accountId>: account id for multi-account channels
• --notify: send a confirmation back to the requester on the same channel

Notes

• Channel input: pass it positionally (pairing list telegram) or with --channel <channel>.
• pairing list supports --account <accountId> for multi-account channels.
• pairing approve supports --account <accountId> and --notify.
• If only one pairing-capable channel is configured, pairing approve <code> is allowed.