Ghép nối

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

​

1) Ghép nối DM (truy cập trò chuyện đế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 một yêu cầu mới được tạo (xấp xỉ mỗi giờ một lần 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 mặc định ở 3 yêu cầu mỗi kênh; các yêu cầu bổ sung 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>

​

Nhóm người gửi có thể tái sử dụng

{
  accessGroups: {
    operators: {
      type: "message.senders",
      members: {
        discord: ["discord:123456789012345678"],
        telegram: ["987654321"],
        whatsapp: ["+15551234567"],
      },
    },
  },
  channels: {
    telegram: { dmPolicy: "allowlist", allowFrom: ["accessGroup:operators"] },
    whatsapp: { groupPolicy: "allowlist", groupAllowFrom: ["accessGroup:operators"] },
  },
}

​

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

• Yêu cầu đang chờ: <channel>-pairing.json
• Kho 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 dùng tệp danh sách cho phép không có phạm vi ở cấp kênh.

​

2) Ghép nối thiết bị Node (nút iOS/Android/macOS/headless)

​

Ghép nối từ Giao diện điều khiển (khuyến nghị)

1. Mở Giao diện điều khiển và chọn Nút.
2. Trong Thiết bị, nhấp Ghép nối thiết bị di động.
3. Trên điện thoại của bạn, mở ứng dụng OpenClaw → Cài đặt → Gateway.
4. Quét mã QR hoặc dán mã thiết lập, rồi kết nối.

​

Ghép nối qua Telegram

1. Trong Telegram, nhắn cho bot của bạn: /pair
2. Bot trả lời bằng 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. Quét mã QR hoặc dán mã thiết lập và kết nối.
5. Ứng dụng di động chính thức kết nối tự động. Nếu /pair pending hiển thị một yêu cầu, hãy xem xét vai trò và phạm vi của nó trước khi phê duyệt.

• url: URL WebSocket của Gateway (ws://... hoặc wss://...)
• bootstrapToken: token bootstrap ngắn hạn cho một thiết bị, dùng cho bắt tay ghép nối ban đầu

• hồ sơ thiết lập tích hợp chỉ cho phép đường cơ sở QR/mã thiết lập mới: node cộng với một chuyển giao operator có giới hạn
• token node được chuyển giao vẫn là scopes: []
• token operator được chuyển giao bị giới hạn ở operator.approvals, operator.read, operator.talk.secrets, và operator.write
• operator.admin không được cấp bởi bootstrap QR/mã thiết lập; nó yêu cầu một luồng ghép nối hoặc token operator được phê duyệt riêng
• việc xoay vòng/thu hồi token sau đó vẫn bị giới hạn bởi cả hợp đồng vai trò đã phê duyệt của thiết bị và các phạm vi operator của phiên gọi

​

Phê duyệt thiết bị node

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

​

Tùy chọn tự động phê duyệt node theo CIDR đáng tin cậy

{
  gateway: {
    nodes: {
      pairing: {
        autoApproveCidrs: ["192.168.1.0/24"],
      },
    },
  },
}

​

Lưu trữ trạng thái ghép nối node

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

​

Ghi chú

• API node.pair.* cũ (CLI: openclaw nodes pending|approve|reject|remove|rename) là một kho ghép nối riêng do gateway sở hữu. Các node WS vẫn cần ghép nối thiết bị.
• Bản ghi ghép nối là nguồn sự thật bền vững cho các vai trò đã phê duyệt. Token thiết bị đang hoạt động vẫn bị giới hạn trong tập vai trò đã phê duyệt đó; một mục token lạc bên ngoài các vai trò đã phê duyệt không tạo quyền truy cập mới.

​

Tài liệu liên quan

• Mô hình bảo mật + prompt injection: 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
  • iMessage: iMessage
  • Discord: Discord
  • Slack: Slack