3.6 KiB
| summary | read_when | |||
|---|---|---|---|---|
| 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 |
|
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:
- Ghép nối DM (ai được phép trò chuyện với bot)
- 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
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
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
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
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ị.