OpenClaw Secure DM Pairing：为 AI 机器人构建安全私信访问机制
在构建基于 LLM 的聊天机器人（如 Telegram、WhatsApp Bot）时，如何控制谁能与机器人对话是一个核心安全问题。直接开放访问可能导致 Token 滥用，而手动配置白名单又过于繁琐。
OpenClaw 提供了一套解决方案，称为'Secure DM Pairing'（安全私信配对）。本文将深入解析这套机制的运作流程、使用指令以及底层的代码实现。 本文基于 OpenClaw v2026.1.29 版本源码分析。
1. 什么是 Secure DM Pairing？
Secure DM Pairing 是 OpenClaw 网关默认的一种访问控制策略。
当一个未授权的用户首次通过私信（Direct Message）联系机器人时，系统不会直接拒绝，而是拦截消息并生成一个临时的 8 位配对码（Pairing Code）。用户将此码发送给机器人管理员，管理员在服务器端通过 CLI 指令'批准'该码，从而完成用户身份的绑定与授权。
核心优势：
- 安全性：防止未经授权的 API 调用。
- 便捷性：无需管理员手动查找用户的长 ID（如 Telegram User ID），通过简短的配对码即可完成鉴权。
- 交互性：用户能得到明确的反馈，知道系统处于'待授权'状态。
2. 完整交互流程演示
假设你的机器人部署在 Telegram 上，流程如下：
第一步：用户触发 (User Action)
陌生用户（UserA）向机器人发送消息：'你好，我想使用服务。'
第二步：系统拦截与回复 (System Response)
OpenClaw 检测到 UserA 不在白名单中，且策略配置为 pairing。
机器人自动回复：
OpenClaw: access not configured.
Your Telegram user id: 773988xxxx
Pairing code: 2B9VQY42
Ask the bot owner to approve with:
openclaw pairing approve telegram 2B9VQY42
第三步：管理员批准 (Admin Action)
管理员在运行 OpenClaw Gateway 的服务器终端执行以下指令：
查看待处理请求（可选）：
openclaw pairing list telegram
批准配对（核心指令）：
openclaw pairing approve telegram 2B9VQY42
执行结果：
Approved telegram sender 773988xxxx.
此时，UserA 的 ID 被正式写入系统的白名单，之后的所有消息都将正常透传给 LLM 处理。
3. 核心代码实现解析
这套机制是如何通过代码实现的？我们可以从 OpenClaw 的源码中一探究竟。
3.1 消息拦截与逻辑判断
核心逻辑位于 bot-message-context.js 中。系统在处理每一条入站消息时，会检查 dmPolicy。
代码位置：dist/telegram/bot-message-context.js
(!isGroup && !allowed) {
(dmPolicy === ) {
}
}
