CLI 命令
配对
openclaw pairing
批准或检查支持配对的渠道中的私信配对请求(仅限聊天私信——节点/设备配对使用 openclaw devices)。
相关:配对流程
也可以在 Control UI 的 Settings → Channels → DM access requests 下查看相同的待处理请求。Control UI 支持批准、选择性通知 请求者以及忽略。忽略会移除当前请求,但不会 永久阻止发送者。
命令
openclaw pairing list telegramopenclaw pairing list --channel telegram --account workopenclaw pairing list telegram --json openclaw pairing approve <code>openclaw pairing approve telegram <code>openclaw pairing approve --channel telegram --account work <code> --notifypairing list
列出一个渠道的待处理配对请求。
| 选项 | 说明 |
|---|---|
[channel] |
位置参数形式的渠道 ID |
--channel <channel> |
显式指定的渠道 ID |
--account <accountId> |
多账户渠道的账户 ID |
--json |
机器可读输出 |
如果配置了多个支持配对的渠道,请以位置参数形式传入渠道,或使用 --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 审批)的人类操作员账户。配对仅允许发送者与智能体对话;除这次一次性引导设置外,配对本身不会授予所有者权限。
如果在此引导设置功能出现之前已批准某个发送者,请运行 openclaw doctor;当未配置命令所有者时,该命令会发出警告,并显示用于修复问题的确切 openclaw config set commands.ownerAllowFrom ... 命令。