​

Pairing

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

​

1) Ghép nối DM (truy cập chat đến)

• 8 ký tự, chữ hoa, không 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ó 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).
• Yêu cầu ghép nối DM đang chờ xử lý bị giới hạn ở 3 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 người gửi

openclaw pairing list telegram
openclaw pairing approve telegram <CODE>

​

Nơi lưu trữ trạng thái

• Yêu cầu đang chờ xử lý: <channel>-pairing.json
• Lưu trữ danh sách cho phép đã phê duyệt:
  • Tài khoản mặc định: <channel>-allowFrom.json
  • Tài khoản không mặc định: <channel>-<accountId>-allowFrom.json

• Tài khoản không mặc định chỉ đọc/ghi tệp danh sách cho phép theo phạm vi của chúng.
• Tài khoản mặc định sử dụng tệp danh sách cho phép không theo phạm vi của kênh.

​

2) Ghép nối thiết bị node (iOS/Android/macOS/nodes không giao diện)

​

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

1. Trong Telegram, nhắn tin cho bot của bạn: /pair
2. Bot trả lời với hai tin nhắn: một tin nhắn hướng dẫn và một tin nhắn mã thiết lập riêng biệt (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 → Cài đặt → Gateway.
4. Dán mã thiết lập và kết nối.
5. Quay lại Telegram: /pair pending (xem xét ID yêu cầu, vai trò và phạm vi), sau đó phê duyệt.

• url: URL WebSocket của Gateway (ws://... hoặc wss://...)
• bootstrapToken: một token khởi động ngắn hạn cho một thiết bị duy nhất được sử dụng cho quá trình bắt tay ghép nối ban đầu

​

Phê duyệ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 nối node

• pending.json (ngắn hạn; yêu cầu đang chờ xử lý hết hạn)
• paired.json (các thiết bị đã ghép nối + token)

​

Ghi chú

• API node.pair.* cũ (CLI: openclaw nodes pending/approve) là một kho ghép nối riêng thuộc về gateway. Các node WS vẫn yêu cầu ghép nối thiết bị.

​

Tài liệu liên quan

• Mô hình bảo mật + tiêm lệnh nhắc: Bảo mật
• Cập nhật an toàn (chạy doctor): Cập nhật
• Cấu hình kênh:
  • Telegram: Telegram
  • WhatsApp: WhatsApp
  • Signal: Signal
  • BlueBubbles (iMessage): BlueBubbles
  • iMessage (cũ): iMessage
  • Discord: Discord
  • Slack: Slack