配对码（Pairing）是OpenClaw用于安全连接第三方聊天平台的授权验证机制。当你在聊天平台中首次与机器人交互时，OpenClaw会生成一个临时配对码，你需要通过命令行完成验证才能建立正式连接。
配对码的作用与特性
- 一次性验证：每个配对码只能使用一次，验证后立即失效
- 时效性：通常有效期为5-10分钟，超时需重新获取
- 安全性：防止未授权访问，确保只有合法用户能连接机器人
- 平台无关：飞书、钉钉等平台都使用相同的配对机制
获取配对码的流程
-
在聊天平台中触发配对
- 飞书：在私聊或群聊中@机器人并发送任意消息
- 钉钉：在私聊或群聊中@机器人并发送”配对”或”pair”
-
查看配对码
- 机器人会回复一个6-8位的字母数字组合（如：A3B9C7）
- 同时OpenClaw终端会显示配对请求日志
批准连接的详细步骤
步骤一：查看待处理配对请求
# 查看所有待处理的配对请求openclaw pairing list# 或查看特定平台的配对请求openclaw pairing list --platform feishu
步骤二：批准配对请求
# 基本批准命令openclaw pairing approve <配对码># 示例：批准配对码为A3B9C7的请求openclaw pairing approve A3B9C7# 指定平台批准（可选）openclaw pairing approve A3B9C7 --platform feishu
步骤三：验证批准结果
# 查看已批准的连接openclaw pairing list --approved# 查看网关连接状态openclaw gateway status# 查看实时日志确认连接成功openclaw logs --follow
成功后会看到类似 Pairing approved for user: [用户名] 的日志信息。
高级配对管理命令
1. 拒绝配对请求
# 拒绝特定配对码openclaw pairing reject <配对码># 拒绝所有待处理请求openclaw pairing reject --all
2. 管理已批准连接
# 查看所有已批准的连接openclaw pairing connections# 移除特定连接openclaw pairing remove <连接ID># 清除所有连接（需谨慎）openclaw pairing clear
3. 配对策略配置
# 设置私聊配对策略openclaw config set channels.feishu.dmPolicy pairing# 设置群聊配对策略openclaw config set channels.feishu.groupPolicy allowlist# 查看当前配置openclaw config get channels
配对失败常见问题排查
问题1：未收到配对码
- 检查机器人是否已正确安装和启动
openclaw gateway status
- 检查聊天平台中是否已添加机器人好友
- 确认消息是否@了正确的机器人
问题2：配对码无效或过期
- 重新获取：在聊天平台中再次发送消息
- 检查时效：配对码通常在5-10分钟后失效
- 查看日志：确认配对请求是否已到达
openclaw logs --tail 50
问题3：批准命令执行失败
- 确认OpenClaw服务正在运行
- 检查配对码是否正确（区分大小写）
- 确认有足够的权限执行命令
问题4：连接后无法正常对话
- 检查配对状态
openclaw pairing list --approved
- 验证网关连接
openclaw gateway test
- 查看平台特定配置（如飞书的事件订阅是否启用）
配对安全注意事项
- 不要分享配对码：配对码相当于临时密码，仅限本人使用
- 及时处理配对请求：避免配对码过期导致重复操作
- 定期审查已批准连接：移除不再需要的连接
- 使用白名单模式：生产环境建议配置为
allowlist模式，仅允许预先授权的用户
自动化配对（高级）
对于需要批量部署的场景，可以使用环境变量预先配置：
# 设置自动批准配对码（谨慎使用）export OPENCLAW_AUTO_APPROVE=true# 或使用配置文件预授权openclaw config set channels.feishu.preApprovedUsers "user1,user2,user3"
配对完成后，你可以在聊天平台中正常与机器人交互。