OpenClaw pairing 教程：配对码、审批流程与超时问题一次讲清
适合谁
刚开始接 channels、第一次接触 pairing 的 OpenClaw 用户
看懂 pairing 为什么存在、什么时候生成、谁来审批、过期后该怎么处理。
交付物
学完后你会留下什么
一套你能复述的 pairing 心智模型，以及一条从 list 到 approve 的标准操作链。
开始前确认
前置条件
- 已经完成基础安装和首次启动
- 准备接至少一个聊天渠道
- 能访问 Control UI 或终端执行 pairing 命令
你会学到
OpenClaw pairing
看懂 pairing 为什么存在、什么时候生成、谁来审批、过期后该怎么处理。
pairing 流程图
从生成配对码到真正可用，中间有 4 个动作
pairing 不是“拿到 code 就结束”，而是一条有生命周期、有审批、有验证的准入链。
- 01
触发 pairing
先在 channel 侧发起配对，让系统创建一条待准入请求。
这一步只是在申请
- 02
查看待处理项
用 `openclaw pairing list <channel>` 或 Control UI 确认 code 和状态。
先确认是不是正确请求
- 03
完成 approve
在有效期内批准 code，让这条入口真正进入准入链。
过期要重新生成，不要反复点旧 code
- 04
回到消息路径验证
审批后立刻发一条测试消息，确认不是“批了，但后面策略还挡住了”。
allowlist / dmPolicy 仍可能继续限制
教程内搜索
支持桌面与移动端。回车可直接搜索。
为什么这篇值得先看
pairing 是很多人第一次接 OpenClaw 渠道时最困惑的环节，但它恰恰是让助手不乱接入的关键安全机制。
先抓住这 3 个关键点
- pairing 的目标不是增加麻烦，而是把首次接入做成可审计、可批准的动作。
- pairing code 有生命周期，审批拖太久会自然过期，这是设计而不是 bug。
- pairing 和 allowlist、dmPolicy 一起决定了“谁能成为你的助手入口”。
实操步骤
- 先在 channel 侧触发 pairing，再用终端或 Control UI 查看是否出现待审批项目。
- 运行
openclaw pairing list <channel>，确认 code 是否已经生成且状态正确。 - 用
openclaw pairing approve <channel> <CODE>完成审批，不要让 code 超过有效期。 - 审批完成后，立刻回到 channel 测一次消息路径，确认不是“批了但没真正通”。
配置或命令示例
openclaw pairing list telegram
openclaw pairing approve telegram <CODE>常见坑
- 看到配对码生成就以为完成了，忘记审批这一步。
- 配对码过期后继续反复点旧链接，浪费时间在无效状态上。
- pairing 批了，但后续 dmPolicy / allowlist 仍然挡住消息。
完成检查
- 你知道如何查看、审批和验证一次 pairing。
- 你理解 pairing 和后续访问控制的关系，而不是把它当成一次性登录。
- 新的 channel 接入时，你已经有标准操作顺序。
为什么建议把这篇收藏起来
- 以后每接一个新入口都要回到 pairing，这是一篇高复访率内容。
- 把它搞懂，后续所有渠道接入都会顺很多。
官方资料
继续深挖时，先看这些官方页面
本页内容已按官方文档和产品能力重写，下面这些链接适合你做版本核对和参数确认。
常见问题
你大概率还会继续搜这几个问题
把高频疑问写在教程页内，既减少跳出，也让这篇内容更适合收藏回看。
OpenClaw pairing code 会永久有效吗？
不会。官方文档说明 pairing code 默认 1 小时过期，所以审批动作最好尽快完成。
pairing 和 allowlist 是一回事吗？
不是。pairing 更像首次准入，allowlist 是持续规则，两者常常要配合使用。
继续学习
下一步推荐
入门内容优先沿 01 → 02 → 03 推进，再补一篇桥接内容。
OpenClaw WhatsApp 接入教程：pairing、session 持久化与群聊策略
把 OpenClaw 接到 WhatsApp，不只要能登录，还要能理解 session、群聊和 selfChatMode 的边界。
生态OpenClaw Telegram 接入教程：botToken、pairing、DM policy 与群聊开关
从 BotFather 到 pairing，再到 dmPolicy 和 groupPolicy，把 OpenClaw Telegram 接入一次讲透。
入门OpenClaw 排错清单：doctor、gateway 状态与首次失败怎么查
把 OpenClaw 最常见的首次失败拆成可执行排查顺序，而不是一出错就重装。