openclaw pairing¶

批准或查看支持配对功能的频道的 DM 配对请求（仅限聊天 DM——节点/设备配对请使用 openclaw devices）。

相关：配对流程

同样的待处理请求也可以在 Control UI 的 设置 → 频道 → DM 访问请求 下查看。Control UI 支持批准、可选择是否通知请求方，以及忽略。忽略会移除当前请求，但不会永久阻止发送方。

命令¶

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

使用 --account <accountId> 可将任一命令限制为仅针对一个频道账户。如果省略 --account，list 会显示该频道所有账户下的待处理请求，而 approve 将使用匹配请求所属的账户。显式传入空值或仅含空白字符的值（例如 --account ""）会被拒绝，并提示 --account must not be blank。

pairing list¶

列出某个频道的待处理配对请求。

如果配置了多个支持配对的频道，请使用位置参数或 --channel 传入频道。只要频道 ID 有效，扩展频道也适用。

pairing approve¶

批准待处理的配对码并允许该发送方。

用法：

• openclaw pairing approve <channel> <code>
• openclaw pairing approve --channel <channel> <code>
• openclaw pairing approve <code>（当仅配置了一个支持配对的频道时）

选项：--channel <channel>、--account <accountId>、--notify（通过同一频道向请求方发送确认消息）。

所有者引导¶

如果在批准配对码时 commands.ownerAllowFrom 为空，CLI 还会将被批准的发送方记录为命令所有者。它会写入一个频道范围的条目，例如 telegram:123456789。这仅用于引导第一个所有者——之后的配对批准绝不会替换或扩展 commands.ownerAllowFrom。Control UI 将此权限提升显示为一个独立的受 operator.admin 保护的复选框，而不是自动应用。

命令所有者是被允许运行仅限所有者命令并批准危险操作的人类操作员账户。这些操作包括 /diagnostics、/export-session、/export-trajectory、/config 以及 exec 批准。配对仅允许发送方与 agent 对话。除这次一次性引导外，配对本身不会授予所有者权限。

如果你在首个所有者引导功能随 2026.4.29 发布之前批准了某个发送方，请运行 openclaw doctor。当未配置命令所有者时，它会发出警告，并显示确切的 openclaw config set commands.ownerAllowFrom ... 命令来修复此问题。

相关¶

• CLI 参考
• 频道配对
• openclaw qr — 移动端/设备引导二维码和设置代码，而非频道 DM 配对码