openclaw pairing¶
批准或检查支持配对的频道的 DM 配对请求(仅限聊天 DM - 节点/设备配对使用 openclaw devices)。
相关:配对流程
相同的待处理请求可以在 Control UI 的 设置 → 频道 → DM 访问请求 下查看。Control UI 支持批准、可选的请求者通知和忽略。忽略会移除当前请求,但不会永久阻止发送者。
两个 CLI 命令都会使用拥有所选本地状态目录的已认证 Gateway;如果没有 Gateway 拥有该目录,则它们会持有独占的离线所有权。
list 也会参与,因为列出操作可能会清理过期或超额的请求。该路由需要 operator.admin 以及命令的
所有者能力。
旧版 Gateway、缺少凭据、拒绝或不确定回复都不会触发直接本地回退。请更新 Gateway,或通过其
服务所有者停止它,然后离线重试;在批准结果不确定后,重试前请检查待处理请求和频道允许列表。
Commands¶
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 |
--channel <channel> |
显式频道 id |
--account <accountId> |
多账户频道的账户 id |
--json |
机器可读输出 |
如果配置了多个支持配对的频道,请通过位置参数或 --channel 传入频道。只要频道 id 有效,扩展频道也可以使用。
--json 会保留 { channel, requests },包括每个请求的 id、code、
createdAt、lastSeenAt 以及可选的 meta。
pairing approve¶
批准待处理的配对码并允许该发送者。
用法:
openclaw pairing approve <channel> <code>openclaw pairing approve --channel <channel> <code>openclaw pairing approve <code>(当恰好配置了一个支持配对的频道时)
选项:--channel <channel>、--account <accountId>、--notify(在同一频道向请求者发送确认)。
Owner bootstrap¶
如果你在批准配对码时 commands.ownerAllowFrom 为空,CLI 还会将已批准的发送者记录为命令所有者。它会写入一个频道范围的条目,例如 telegram:123456789。这只会初始化第一个所有者 - 之后的配对批准永远不会替换或扩展 commands.ownerAllowFrom。Control UI 会将此提权显示为一个单独的受 operator.admin 保护的复选框,而不是自动应用。
CLI 只会在确认的批准后执行此配置初始化和可选的 --notify。它们保留现有的本地配置/重载和频道
通知约定;在 RPC 结果被拒绝或不确定时不会执行。
命令所有者是允许运行仅限所有者的命令并批准危险操作的人类操作员账户。这些操作包括 /diagnostics、/export-session、/export-trajectory、/config 以及 exec 批准。配对仅允许发送者与 agent 通信。它本身不会授予除这一次性初始化之外的所有者权限。
如果你在 2026.4.29 发布第一个所有者初始化之前批准了某个发送者,请运行 openclaw doctor。当未配置命令所有者时,它会发出警告。它还会显示用于修复的准确命令 openclaw config set commands.ownerAllowFrom ...。
Related¶
- CLI 参考
- 频道配对
openclaw qr— 移动/设备初始化 QR 和设置码,不是频道 DM 配对码
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw