> ## Documentation Index
> Fetch the complete documentation index at: https://agdiai-597e782f.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 配对

# 配对

"配对"是 Agdi 的显式**所有者批准**步骤。它用于两个地方：

1. **私信配对**（谁被允许与机器人对话）
2. **节点配对**（哪些设备/节点被允许加入 Gateway 网关网络）

安全上下文：[安全](https://agdiai-597e782f.mintlify.site/gateway/security.md)

## 1）私信配对（入站聊天访问）

当渠道配置为私信策略 `pairing` 时，未知发送者会收到一个短代码，他们的消息**不会被处理**，直到你批准。

默认私信策略记录在：[安全](https://agdiai-597e782f.mintlify.site/gateway/security.md)

配对代码：

* 8 个字符，大写，无歧义字符（`0O1I`）。
* **1 小时后过期**。机器人仅在创建新请求时发送配对消息（大约每个发送者每小时一次）。
* 待处理的私信配对请求默认上限为**每个渠道 3 个**；在一个过期或被批准之前，额外的请求将被忽略。

### 批准发送者

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
agdi pairing list telegram
agdi pairing approve telegram <CODE>
```

支持的渠道：`telegram`、`whatsapp`、`signal`、`imessage`、`discord`、`slack`。

### 状态存储位置

存储在 `~/.agdi/credentials/` 下：

* 待处理请求：`<channel>-pairing.json`
* 已批准允许列表存储：`<channel>-allowFrom.json`

将这些视为敏感信息（它们控制对你助手的访问）。

## 2）节点设备配对（iOS/Android/macOS/无头节点）

节点作为 `role: node` 的**设备**连接到 Gateway 网关。Gateway 网关创建一个必须被批准的设备配对请求。

### 批准节点设备

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
agdi devices list
agdi devices approve <requestId>
agdi devices reject <requestId>
```

### 状态存储位置

存储在 `~/.agdi/devices/` 下：

* `pending.json`（短期；待处理请求会过期）
* `paired.json`（已配对设备 + 令牌）

### 说明

* 旧版 `node.pair.*` API（CLI：`agdi nodes pending/approve`）是一个单独的 Gateway 网关拥有的配对存储。WS 节点仍然需要设备配对。

## 相关文档

* 安全模型 + 提示注入：[安全](https://agdiai-597e782f.mintlify.site/gateway/security.md)
* 安全更新（运行 doctor）：[更新](https://agdiai-597e782f.mintlify.site/install/updating.md)
* 渠道配置：
  * Telegram：[Telegram](https://agdiai-597e782f.mintlify.site/channels/telegram.md)
  * WhatsApp：[WhatsApp](https://agdiai-597e782f.mintlify.site/channels/whatsapp.md)
  * Signal：[Signal](https://agdiai-597e782f.mintlify.site/channels/signal.md)
  * iMessage：[iMessage](https://agdiai-597e782f.mintlify.site/channels/imessage.md)
  * Discord：[Discord](https://agdiai-597e782f.mintlify.site/channels/discord.md)
  * Slack：[Slack](https://agdiai-597e782f.mintlify.site/channels/slack.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.