82 lines
3.6 KiB
Markdown
82 lines
3.6 KiB
Markdown
---
|
|
summary: "Tổng quan về ghép nối (Pairing): phê duyệt ai có thể nhắn tin trực tiếp (DM) cho bạn + những node nào có thể tham gia hệ thống"
|
|
read_when:
|
|
- Thiết lập quyền kiểm soát truy cập DM
|
|
- Ghép nối một node iOS/Android mới
|
|
- Xem xét trạng thái bảo mật của Moltbot
|
|
---
|
|
|
|
# Ghép nối (Pairing)
|
|
|
|
“Ghép nối” (Pairing) là bước **phê duyệt của chủ sở hữu** một cách tường minh trong Moltbot.
|
|
Nó được sử dụng ở hai nơi:
|
|
|
|
1) **Ghép nối DM** (ai được phép trò chuyện với bot)
|
|
2) **Ghép nối Node** (những thiết bị/node nào được phép tham gia vào mạng lưới gateway)
|
|
|
|
Bối cảnh bảo mật: [Bảo mật](../gateway/security.vi.md)
|
|
|
|
## 1) Ghép nối DM (truy cập chat gửi đến)
|
|
|
|
Khi một kênh được cấu hình với chính sách DM là `pairing`, những người gửi không xác định sẽ nhận được một mã ngắn và tin nhắn của họ sẽ **không được xử lý** cho đến khi bạn phê duyệt.
|
|
|
|
Chính sách DM mặc định được tài liệu hóa tại: [Bảo mật](../gateway/security.vi.md)
|
|
|
|
Mã ghép nối:
|
|
- 8 ký tự, viết hoa, không chứa các ký tự dễ nhầm lẫn (`0O1I`).
|
|
- **Hết hạn sau 1 giờ**. Bot chỉ gửi tin nhắn ghép nối khi có một yêu cầu mới được tạo (khoảng một lần mỗi giờ cho mỗi người gửi).
|
|
- Các yêu cầu ghép nối DM đang chờ được giới hạn tối đa là **3 yêu cầu cho mỗi kênh** theo mặc định; các yêu cầu bổ sung sẽ bị bỏ qua cho đến khi có một yêu cầu hết hạn hoặc được phê duyệt.
|
|
|
|
### Phê duyệt người gửi
|
|
|
|
```bash
|
|
moltbot pairing list telegram
|
|
moltbot pairing approve telegram <MÃ_CODE>
|
|
```
|
|
|
|
Các kênh được hỗ trợ: `telegram`, `whatsapp`, `signal`, `imessage`, `discord`, `slack`.
|
|
|
|
### Nơi lưu trữ trạng thái
|
|
|
|
Được lưu trong thư mục `~/.clawdbot/credentials/`:
|
|
- Các yêu cầu đang chờ: `<kênh>-pairing.json`
|
|
- Danh sách phê duyệt (allowlist): `<kênh>-allowFrom.json`
|
|
|
|
Hãy coi những file này là thông tin nhạy cảm (chúng kiểm soát quyền truy cập vào trợ lý của bạn).
|
|
|
|
|
|
## 2) Ghép nối thiết bị Node (iOS/Android/macOS/headless nodes)
|
|
|
|
Các Node kết nối đến Gateway dưới dạng **thiết bị** với vai trò `role: node`. Gateway sẽ tạo ra một yêu cầu ghép nối thiết bị và cần phải được phê duyệt.
|
|
|
|
### Phê duyệt một thiết bị node
|
|
|
|
```bash
|
|
moltbot devices list
|
|
moltbot devices approve <requestId>
|
|
moltbot devices reject <requestId>
|
|
```
|
|
|
|
### Nơi lưu trữ trạng thái
|
|
|
|
Được lưu trong thư mục `~/.clawdbot/devices/`:
|
|
- `pending.json` (tồn tại ngắn hạn; tính bằng giây/phút trước khi hết hạn)
|
|
- `paired.json` (các thiết bị đã ghép nối + mã token)
|
|
|
|
### Ghi chú
|
|
|
|
- API cũ `node.pair.*` (CLI: `moltbot nodes pending/approve`) là một kho lưu trữ ghép nối riêng biệt do gateway quản lý. Các node WebSocket vẫn yêu cầu phải thực hiện ghép nối thiết bị.
|
|
|
|
|
|
## Tài liệu liên quan
|
|
|
|
- Mô hình bảo mật + prompt injection: [Bảo mật](../gateway/security.vi.md)
|
|
- Cập nhật an toàn (chạy doctor): [Cập nhật](../install/updating.vi.md)
|
|
- Cấu hình kênh:
|
|
- Telegram: [Telegram](../channels/telegram.vi.md)
|
|
- WhatsApp: [WhatsApp](../channels/whatsapp.vi.md)
|
|
- Signal: [Signal](../channels/signal.vi.md)
|
|
- iMessage: [iMessage](../channels/imessage.vi.md)
|
|
- Discord: [Discord](../channels/discord.vi.md)
|
|
- Slack: [Slack](../channels/slack.vi.md)
|