CLI 命令

配对

openclaw pairing

批准或查看私信配对请求(适用于支持配对的渠道)。

相关:

命令

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

列出一个渠道中待处理的配对请求。

选项:

  • [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>:显式渠道 ID
  • --account <accountId>:多账户渠道的账户 ID
  • --notify:通过同一渠道向请求者发回确认消息

所有者引导:

  • 如果你批准配对码时 commands.ownerAllowFrom 为空,OpenClaw 还会使用渠道范围的条目(例如 telegram:123456789)将已批准的发送者记录为命令所有者。
  • 这只会引导第一个所有者。后续配对批准不会替换或扩展 commands.ownerAllowFrom
  • 命令所有者是被允许运行仅所有者可用命令,并批准危险操作的人类操作员账户,例如 /diagnostics/export-trajectory/config 和 exec 批准。

注意

  • 渠道输入:通过位置参数传入(pairing list telegram),或使用 --channel <channel>
  • pairing list 支持用于多账户渠道的 --account <accountId>
  • pairing approve 支持 --account <accountId>--notify
  • 如果只配置了一个支持配对的渠道,则允许使用 pairing approve <code>
  • 如果你在此引导机制存在之前批准过某个发送者,请运行 openclaw doctor;当未配置命令所有者时,它会发出警告,并显示用于修复的 openclaw config set commands.ownerAllowFrom ... 命令。

相关