Pairing

“Pairing” là bước phê duyệt của chủ sở hữu trong OpenClaw. Nó được dùng ở hai chỗ:

  1. DM pairing (ai được phép nhắn tin với bot)
  2. Node pairing (thiết bị/node nào được phép kết nối vào mạng Gateway)

Bối cảnh bảo mật: Security

1) DM pairing (kiểm soát truy cập chat)

Khi một Channel được cấu hình với chính sách DM là pairing, người gửi lạ sẽ nhận được một mã ngắn và tin nhắn của họ không được xử lý cho đến khi các bạn phê duyệt.

Chính sách DM mặc định được ghi trong: Security

Mã Pairing:

  • 8 ký tự, chữ in hoa, không có ký tự dễ nhầm (0O1I).
  • Hết hạn sau 1 giờ. Bot chỉ gửi tin nhắn pairing khi có yêu cầu mới được tạo (khoảng mỗi giờ một lần cho mỗi người gửi).
  • Yêu cầu DM pairing đang chờ được giới hạn ở 3 yêu cầu mỗi channel theo mặc định; các yêu cầu thêm vào 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>

Các Channel được hỗ trợ: telegram, whatsapp, signal, imessage, discord, slack.

Dữ liệu được lưu ở đâu

Được lưu trong ~/.openclaw/credentials/:

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

Coi những file này là nhạy cảm (chúng kiểm soát quyền truy cập vào assistant của các bạn).

2) Node device pairing (các node iOS/Android/macOS/headless)

Các Node kết nối với Gateway dưới dạng thiết bị với role: node. Gateway tạo một yêu cầu pairing thiết bị cần được phê duyệt.

Phê duyệt thiết bị node

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

Dữ liệu được lưu ở đâu

Được lưu trong ~/.openclaw/devices/:

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

Lưu ý

  • API node.pair.* cũ (CLI: openclaw nodes pending/approve) là một kho pairing riêng do Gateway quản lý. Các WS node vẫn cần device pairing.

Tài liệu liên quan