openclaw pairing
管理通道配对。
概要
bash
openclaw pairing <子命令> [选项]描述
openclaw pairing 命令用于管理通道的用户配对。当用户通过 WhatsApp、Telegram 等通道首次与 Agent 交互时，需要完成配对流程。此命令可以查看待处理的配对请求、审批或撤销配对。
子命令
| 子命令 | 说明 |
|---|---|
list [channel] | 列出配对记录，可按通道过滤 |
approve <channel> <code> | 审批配对请求 |
revoke <channel> <userId> | 撤销已配对用户 |
pending | 查看待处理的配对请求 |
export | 导出配对列表 |
选项
| 选项 | 缩写 | 说明 | 默认值 |
|---|---|---|---|
--format <type> | 输出格式：text、json、table | table | |
--status <status> | 过滤状态：paired、pending、revoked | 全部 | |
--verbose | -v | 显示详细信息 | false |
配对流程
- 用户通过通道（如 WhatsApp）向 Agent 发送消息
- 系统生成配对码，返回给用户
- 管理员通过
openclaw pairing approve审批配对 - 配对成功后用户即可正常使用 Agent
输出示例
$ openclaw pairing list
┌──────────┬────────────────┬──────────┬─────────────────────┐
│ 通道 │ 用户 ID │ 状态 │ 配对时间 │
├──────────┼────────────────┼──────────┼─────────────────────┤
│ whatsapp │ +86138****1234 │ ✅ 已配对 │ 2026-03-01 10:00 │
│ telegram │ @user_test │ ⏳ 待审批 │ 2026-03-05 09:30 │
│ wechat │ wxid_abc123 │ ✅ 已配对 │ 2026-02-28 14:20 │
└──────────┴────────────────┴──────────┴─────────────────────┘示例
bash
# 列出所有配对
openclaw pairing list
# 查看 WhatsApp 通道的配对
openclaw pairing list whatsapp
# 查看待审批的配对请求
openclaw pairing pending
# 审批配对请求
openclaw pairing approve telegram ABC123
# 撤销用户配对
openclaw pairing revoke whatsapp "+86138****1234"
# 以 JSON 格式导出配对列表
openclaw pairing export --format json相关命令
openclaw qr- 二维码生成openclaw sessions- 会话管理openclaw security- 安全管理