​

Ghép cặp

1. Ghép cặp DM (ai được phép nói chuyện với bot)
2. Ghép cặp node (những thiết bị/node nào được phép tham gia mạng gateway)

​

1. Ghép cặp DM (truy cập chat đến)

• 8 ký tự, chữ hoa, không có ký tự dễ gây nhầm lẫn (0O1I).
• Expire after 1 hour. The bot only sends the pairing message when a new request is created (roughly once per hour per sender).
• Các yêu cầu ghép cặp DM đang chờ được giới hạn 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 một yêu cầu hết hạn hoặc được phê duyệt.

​

Phê duyệt một người gửi

openclaw pairing list telegram
openclaw pairing approve telegram <CODE>

​

Trạng thái được lưu ở đâu

• Yêu cầu đang chờ: <channel>-pairing.json
• Kho danh sách cho phép đã phê duyệt: <channel>-allowFrom.json

​

2. Ghép cặp thiết bị node (iOS/Android/macOS/node headless)

​

Ghép nối qua Telegram (khuyến nghị cho iOS)

1. Trong Telegram, nhắn cho bot của bạn: /pair
2. Bot sẽ trả lời với hai tin nhắn: một tin hướng dẫn và một tin riêng chứa mã thiết lập (dễ sao chép/dán trong Telegram).
3. Trên điện thoại của bạn, mở ứng dụng OpenClaw iOS → Settings → Gateway.
4. Dán mã thiết lập và kết nối.
5. Quay lại Telegram: /pair approve

• url: the Gateway WebSocket URL (ws://... or wss://...)
• token: a short-lived pairing token

​

Phê duyệt một thiết bị node

openclaw devices list
openclaw devices approve <requestId>
openclaw devices reject <requestId>

​

Lưu trữ trạng thái ghép cặp node

• pending.json (tồn tại ngắn; các yêu cầu đang chờ sẽ hết hạn)
• paired.json (thiết bị đã ghép cặp + token)

​

Ghi chú

• The legacy node.pair.* API (CLI: openclaw nodes pending/approve) is a separate gateway-owned pairing store. WS nodes still require device pairing.

​

Tài liệu liên quan

• Mô hình bảo mật + prompt injection: Security
• Cập nhật an toàn (chạy doctor): Updating
• Cấu hình kênh:
  • Telegram: Telegram
  • WhatsApp: WhatsApp
  • Signal: Signal
  • BlueBubbles (iMessage): BlueBubbles
  • iMessage (legacy): iMessage
  • Discord: Discord
  • Slack: Slack