CLI 命令

配对

openclaw pairing

批准或检查支持配对的渠道中的私信配对请求(仅限聊天私信——节点/设备配对使用 openclaw devices)。

相关:配对流程

命令

bash
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> --notify

pairing 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 为空,OpenClaw 还会将获准的发送者记录为命令所有者,并使用类似 telegram:123456789 的渠道范围条目。此操作只会引导设置第一个所有者——后续批准配对绝不会替换或扩展 commands.ownerAllowFrom

命令所有者是获准运行仅限所有者的命令,以及批准危险操作(例如 /diagnostics/export-trajectory/config 和 Exec 审批)的人类操作员账号。配对只允许发送者与智能体交谈;除这次一次性引导设置外,配对本身不会授予所有者权限。

如果你在此引导设置功能推出前批准过发送者,请运行 openclaw doctor;当未配置命令所有者时,它会发出警告,并显示用于修复问题的确切 openclaw config set commands.ownerAllowFrom ... 命令。

相关内容

Was this useful?
On this page

On this page