Wiki AI

CLI - pairing（配对管理）

2分钟阅读

openclaw pairing

审批或查看 DM 配对请求（适用于支持配对模式的渠道）。

子命令

# 列出待处理的配对请求
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 指定渠道。

pairing approve

审批待处理的配对码，允许该发送者。

openclaw pairing approve <channel> <code>
openclaw pairing approve --channel <channel> <code>
# 只配置了一个支持配对的渠道时可省略 channel
openclaw pairing approve <code>

选项：

  • --channel <channel> — 显式指定渠道
  • --account <accountId> — 多账号渠道的账号 id
  • --notify — 在同一渠道向请求者发送确认消息

Owner 自动引导

首次审批配对码时，如果 commands.ownerAllowFrom 为空，OpenClaw 会自动将该发送者记录为命令 owner（格式如 telegram:123456789）。

  • 仅引导第一个 owner，后续审批不会替换或扩展 commands.ownerAllowFrom
  • Owner 是允许执行 owner-only 命令的人类操作员账号（如 /diagnostics、/config、exec 审批等）

诊断

如果在此引导机制存在前已审批过发送者，运行 openclaw doctor 检查，它会提示如何手动设置：

openclaw config set commands.ownerAllowFrom telegram:123456789

相关链接

关系图谱

反向链接