配对
“配对”是Clawdbot的显式 所有者批准 步骤。 它在两个地方使用:
1) DM配对(谁被允许与机器人交谈) 2) 节点配对(哪些设备/节点被允许加入网关网络)
安全上下文:安全
1) DM配对(入站聊天访问)
当一个频道配置了DM策略为 pairing 时,未知发送者会收到一个短代码,且他们的消息在你批准之前 不会被处理。
默认的DM策略在以下位置有文档说明:安全
配对代码:
- 8个字符,全大写,没有易混淆的字符(
0O1I)。 - 1小时后过期。机器人仅在创建新请求时发送配对消息(大致每小时每个发送者一次)。
- 默认情况下,每个频道的待处理DM配对请求限制为 3个;在其中一个过期或被批准之前,其他请求将被忽略。
批准一个发送者
bash
clawdbot pairing list telegram
clawdbot pairing approve telegram
支持的渠道:`telegram`、`whatsapp`、`signal`、`imessage`、`discord`、`slack`。
### 何处存储状态
存储在 `~/.clawdbot/credentials/` 目录下:
- 待处理的请求:`<channel>-pairing.json`
- 已批准的白名单存储:`<channel>-allowFrom.json`
请将这些文件视为敏感信息(它们控制对你的助手的访问权限)。
## 2) 节点设备配对(iOS/Android/macOS/无头节点)
节点以 **设备** 的身份连接到网关,角色为 `role: node`。网关会创建一个设备配对请求,该请求必须被批准。
### 批准节点设备```bash
clawdbot devices list
clawdbot devices approve <requestId>
clawdbot devices reject <requestId>
状态存储位置
存储在 ~/.clawdbot/devices/ 目录下:
pending.json(短期存储;待处理请求会过期)paired.json(已配对的设备 + 令牌)
注意事项
- 旧版的
node.pair.*API(CLI:clawdbot nodes pending/approve)是由网关所有并管理的配对存储。WS 节点仍然需要设备配对。